족발야시장 본사 바이브코딩 실습 2일 기록 — 서랍 폴더 하나에서 PRD까지, 이틀 동안 다룬 순서

「오늘은 듣는 날이 아니라 만드는 날입니다.」 1일차 덱 앞머리에 적은 문장이다. 이 글은 이틀 동안 쓴 강의 덱을 장 순서대로 따라가며, 본사 직원들과 무엇을 어떤 순서로 다뤘는지 남긴 기록이다.

이 글 3줄 요약

• 10월 28일(수)·29일(목) 이틀, 족발야시장 본사 직원들과 바이브코딩 실습 과정을 진행했다. 교재는 1일차 덱 99장, 2일차 덱 96장이다.
• 1일차는 Claude 데스크톱 앱으로 서랍 폴더를 만들고 브랜드 조사 → 가맹상담 랜딩과 신청 장부 → 예약 자동화 순서로 간다. 2일차는 터미널 개발환경을 깔고 PRD를 쓴 뒤, 부서별 팀이 자기 업무로 첫 버전을 돌려 본다.
• 이 글은 덱 기준 기록이다. 무엇을 어떤 순서로 다뤘는지, 그 순서를 왜 골랐는지만 덱의 설명대로 적는다.

어떤 자리였나

족발야시장 본사 직원들과 이틀짜리 실습 과정을 열었다. 설명을 듣고 끝나는 강의가 아니라, 직원 각자 노트북에서 AI에게 일을 시키고 결과를 확인하는 과정으로 짰다.

이틀을 관통하는 장치는 서랍 폴더 하나다. 1일차 2부에서 C드라이브 바로 아래 C:\족발야시장서랍 폴더를 만들고, 이틀 동안 만드는 모든 결과가 이 폴더에 파일로 쌓이게 했다. 덱의 말로는 "대화는 사라지고, 파일은 남습니다". 다음 대화도, 다음 날 수업도 그 파일을 다시 읽고 이어 간다.

이틀의 구성

1일차 — Claude 앱 하나로 서랍·랜딩·자동화까지

0부 오리엔테이션. 이틀의 지도를 먼저 펴고, 강사가 AI로 만들어 지금 돌아가는 프로그램 세 개를 실물로 보여 준다. 0부의 마지막 장 제목은 "AI, 딸깍 안 됩니다"다. 공부할 것은 도구 이름이 아니라 시키는 법과 확인하는 법이라는 이야기로 문을 연다.

1부 AI 제대로 이해하기. AI는 검색기가 아니라 다음 단어를 고르는 예측기라는 것, 그래서 그럴듯한 거짓말(할루시네이션)이 나오고 검증하는 습관이 곧 실력이라는 것부터 짚는다. 습관 하나도 같이 건넨다. 첫 지시에 "결정할 것이 있으면 진행하지 말고 나에게 먼저 물어봐줘"를 붙이는 것이다. 채팅만 쓸 때의 한계(저장과 기억은 다르다, 한 번에 펼쳐 보는 책상 크기가 있다)와, 결과가 '어디서 본 듯'해지는 AI 슬롭을 내 재료와 합격선으로 밀어내는 법까지가 1부다.

2부 Claude 앱 준비. Claude 데스크톱 앱을 깔고, 서랍 폴더를 만들어 앱에 연결한다. 폴더를 연결하면 결과가 대화 안이 아니라 내 PC 폴더에 파일로 쌓인다. 모델·노력·권한을 맞추고 지침·기능·사용량 설정을 확인한 뒤, 이날 쓸 Vercel(만든 화면을 올리는 곳)과 Supabase(신청이 쌓이는 장부)에 가입해 둔다.

3부 브랜드 서랍. 덱은 여기서 순서를 못 박는다. 수집 → 분석 → 제작. "홈페이지 만들어"라고만 시켜도 AI는 만들지만, 모르는 내용은 그럴듯하게 지어낸다. 그래서 AI가 내 크롬으로 직접 웹을 돌아다니게(Claude in Chrome) 준비한 뒤, 자료를 하나도 주지 않고 빈 폴더에서 출발해 본사 브랜드 두 곳을 조사하게 한다. 공식 홈페이지 → 공정거래위원회 가맹사업 정보공개서 → 네이버 플레이스 리뷰 → 뉴스 순서로 믿을 만한 곳부터 찾고, 찾은 것마다 출처를 달고, 애매한 것은 '확인 필요'로 남긴다. 결과는 파일 다섯 개와 사진 폴더로 정리되고, 사람은 '확인 필요' 목록부터 열어 틀린 것만 고친다.

4부 가맹상담 랜딩. 모은 재료를 읽혀 가맹점 모집 랜딩(한 장짜리 소개 페이지)을 만든다. 랜딩의 첫 화면 파일이 index.html이라는 것을 보고, 내 랜딩을 말로 고쳐 본다. 내 PC에서 연 랜딩은 나만 볼 수 있어서, 랜딩 폴더를 Vercel에 끌어다 놓아 인터넷 주소를 달고 폰으로 열어 본다. 그다음 커넥터(MCP, 말 한마디로 바깥 서비스를 움직이는 플러그)로 Supabase와 Vercel을 연결해 가맹상담 신청란을 붙이고, 같은 주소에 덮어써 배포한다. 신청이 장부에 쌓이는지 Supabase 화면에서 직접 보고, 테스트용 가짜 신청 5건을 넣은 뒤 "지금 가맹상담 신청이 몇 건이야?"라고 Claude에게 말로 묻는다. 4부 마지막 장은 그 연장선이다. 본사 ERP에도 같은 방식으로 MCP를 붙이면 매출을 말로 묻고 대시보드를 받을 수 있다는 것, 그리고 시작은 읽기 전용으로 하고 권한은 사람이 정한다는 것.

5부 본사 시스템 지도. 오늘 만든 것이 본사 시스템의 어디에 해당하는지 한 장으로 본다. 프론트엔드·백엔드·데이터베이스·API·도메인, 그리고 Vercel과 Supabase가 각각 무엇인지. 덱은 이 부의 핵심을 두 문장으로 남긴다. 망가지면 먼저 "프론트 문제야, 백엔드 문제야?"를 묻는다. 날마다 바뀌는 정보는 화면이 아니라 장부(DB)에 둔다. 가맹상담 신청이 바로 그 경우라서 Supabase 장부를 붙였다는 설명이 이어진다.

6부 자동화. Claude 앱의 예약된 작업으로, 정해진 시간에 AI가 알아서 일하게 한다. 덱은 본사에 자동화가 필요한 이유를 매출에서 찾는다. 본사는 매일 아침 전 매장 매출을 보고, 엑셀을 받고 합치고 전날과 비교하는 순서는 매일 같다. 순서가 같으면 지시문 한 장으로 옮기고 시간만 정해 주면 된다. 실습은 가상 매장의 샘플 매출 파일로 뉴스 브리핑과 매출 보고를 예약 작업 하나로 묶고, 셋째 날 파일을 넣어 다시 돌려 대시보드가 바뀌는지 보는 순서다. 매출 파일을 내려받는 일까지 AI 브라우저(Aside)에 맡기는 예시, 회의 녹음이 회의록이 되는 예시, 주간 트렌드 리서치 예시도 함께 싣는다.

7부 보너스 실습. 학습용 가상 계약서 8건(실제 회사·사람 이름 없음)을 계약 대장 엑셀과 기한 현황판으로 바꾼다. 계약 관리 전체를 한 번에 만드는 대신 첫 조각만 떼어 내는 연습이다. 만기보다 통보 마감이 먼저 오는 계약처럼 놓치기 쉬운 기한을 보는 게 요점이고, 기한을 챙기는 일은 어느 부서에나 있어서 공통 주제로 골랐다. 이어서 부서별로 다음 날 가져올 자료를 정하고, 하루를 닫기 전에 실습 동안 열어 둔 설정 두 가지(커넥터 쓰기 권한, 외부 접속 허용 목록)를 원래대로 되돌린다. 1일차 덱의 마지막 장은 2일차 예고다.

2일차 — 개발환경을 깔고, 내 업무를 PRD로 돌린다

0부 복습. 어제 서랍에 쌓인 것 넷(서랍 폴더, 브랜드정보 파일, 랜딩과 신청 장부, 예약 작업)을 짚고 오늘 순서를 본다. 깔고, 쓰고, 돌리고, 혼자 굴린다.

1부 개발환경 구축. 2일차 덱 96장 가운데 38장이 이 부다. 목표는 "덱만 보고 혼자 다시 깔 수 있게"다. 앱과 터미널은 같은 Claude지만 일하는 자리가 다르다는 것부터 설명하고, 터미널을 열어 Git(세이브 도구)과 Claude Code를 차례로 깐다. 이 부의 대원칙은 하나다. 빨간 글씨는 고장이 아니라 안내문이니, 통째로 복사해 AI에게 보여 준다. Claude Code를 처음 켜고 로그인한 뒤에는 AI를 굴리는 작업대 Orca를 깔고, 컨텍스트(AI가 한 대화에서 기억하는 분량)를 보여 주는 상태줄을 단다.

이어서 Git으로 서랍에 세이브를 켠다. 덱의 표현으로는 "겁이 없어야 크게 시킵니다". 언제든 되돌릴 수 있어야 과감하게 시킬 수 있다는 뜻이다. 이때 회사 자료가 저장 기록에 남지 않도록 제외 목록부터 만든다. 마지막으로 어느 폴더에서 켜도 먼저 읽는 전역 지침을 써 보고, 1일차에 앱에 붙였던 Vercel·Supabase 연결을 터미널에도 설치한다.

2부 터미널의 힘과 세컨드 브레인. 터미널의 Claude는 여러 폴더를 넘나들며 비교하고, 서랍 전체에서 빠진 것을 찾아 준다. 만든 대화가 자기 결과를 채점하면 놓치기 쉬워서, 기억이 없는 새 창에 교차 검사를 맡기는 법도 여기서 다룬다. 세컨드 브레인은 결정·회의·매뉴얼을 머릿속 대신 MD 파일(글자만 담은 메모 파일)로 서랍에 남겨, AI가 읽는 회사 기억으로 쓰는 방식이다.

3부 PRD. PRD는 AI에게 일을 맡기는 주문서다. 덱은 집 짓기에 빗댄다. 건축주가 쓰는 종이("아이 방 둘, 아침 햇살 드는 부엌")와 건축가가 쓰는 종이(벽 두께, 철근 규격)가 따로 있는데, PRD는 앞의 종이라서 우리 업무를 아는 사람만 쓸 수 있다. AI는 실력 좋은 신입사원이지만 매일 아침 어제 일을 잊고 출근하니, PRD는 대화창이 아니라 서랍 안의 PRD.md 파일로 둔다.

다음 장이 하네스다. 말의 힘은 그대로 두고 가는 방향만 사람이 잡는 마구처럼, PRD가 AI를 정한 길로만 달리게 묶는다. 끈은 넷이다. 이번엔 안 만들 것을 적는다. 사람이 정할 기준 숫자를 비워 두지 않는다. 돈·개인정보·유료 서비스·자동 발송·삭제, 이 위험 다섯 가지는 작은 일이어도 멈추고 묻게 한다. 모르면 지어내지 말고 묻게 하고, 끝나면 세 줄로 보고하게 한다. 이어지는 장은 어제를 다시 읽는다. 1일차 실습이 사실 전부 PRD의 칸을 채우는 연습이었다는 장이다. 서랍 폴더는 결과가 쌓이는 자리, 브랜드 조사는 ③ 자료, 랜딩과 신청란은 ② 누가 쓰나(바깥 사람이 쓰니 인터넷 주소와 장부가 필요했다), 계약서 실습은 큰 계획에서 떼어 낸 첫 조각이었다.

양식은 3칸이다. ① 어떤 업무를 자동화하나 ② 누가 쓰나 ③ 어떤 자료가 필요한가. 여기에 성공 기준 한 줄과 "이번엔 안 만들 것" 한 줄을 꼬리로 붙인다. 셋 가운데 제일 중요한 칸은 ③ 자료다. 실습 주제를 고를 때 '바로 되는 것'과 '막히는 곳'도 나눠 보는데, 덱이 정리한 막히는 곳은 늘 셋이다. 시스템에서 자료를 꺼내는 길, 법률·세무 판단, 아직 정하지 않은 기준. 3부 마지막 장은 PRD를 쓰는 법이다. 손으로 쓰지 않는다. AI가 한 번에 3개씩 묻고, 내가 답하면 AI가 받아 적는다.

4부 팀별 실습. 부서별 팀이 자기 팀 폴더에서 Claude를 켜고, 쓴 PRD대로 첫 버전 하나를 만든다. 착수 원칙은 세 줄이다. 첫 버전은 하나만. 기록은 파일로(끄기 전에 RESUME.md에 한 일·정한 것·다음 할 일을 남긴다). 검수는 사람이(손으로 풀어 둔 정답과 한 줄씩 맞춰 본다, 화면이 떴다고 결과가 맞은 것은 아니다). 덱은 이걸 케이크에 빗댄다. 위층만 다 만든 케이크보다 처음부터 끝까지 수직으로 자른 얇은 한 조각이 쓸모 있다. 막히면 손을 들고 화면을 그대로 두면, 강사가 자리를 돌며 그 화면부터 본다.

5부 혼자 굴리는 법. 강사가 없어도 챙길 네 가지다. 빨간 글씨가 뜨면 내 말로 옮기지 말고 그대로 AI에게 붙인다. 비밀 키는 어디에도 적지 않고, 회사 자료는 허락한 범위 밖으로 내보내지 않는다. 잘 될 때마다 이름을 붙여 세이브하고, 저장에서 뺀 폴더는 따로 복사해 둔다. 그리고 이틀 산출물이 서랍 어디에 있는지 지도로 정리한다.

6부 스킬 3종과 cswap. 스킬은 자주 쓰는 지시서에 이름을 붙인 파일이다. 같은 말을 세 번 치고 있다면 거기가 스킬의 자리라는 게 덱의 설명이다. 정하고(start-prd), 만들고(zzak), 검사하는(front-zzak) 세 가지를 깔고, Claude Code 사용량을 숫자로 보여 주는 계기판 cswap을 단다. 마지막 장은 이렇게 맺는다. 이틀 동안 배운 것은 코딩이 아니다. 코드는 AI가, 결정은 내가 한다. 숙제는 하나, 이번 주 안에 같은 업무로 한 번 더 켜 보는 것.

별책. 보조 AI Codex 설치와 GitHub 백업은 실습 시간에는 하지 않고, 필요할 때 따라 할 수 있게 순서만 덱 맨 뒤에 실었다.

왜 본사 직원에게 이 순서였나

덱 곳곳에 적어 둔 이유를 모으면 셋이다.

1. 재료가 먼저다. 1일차의 수집 → 분석 → 제작과 2일차 PRD의 "③ 자료가 제일 중요합니다"는 같은 이야기다. 재료를 먼저 줘야 AI가 지어내지 않고, 결과가 '우리 것'이 된다.
2. 1일차는 2일차 PRD의 재료다. 바이브코딩이 프로그램을 내는 5단계(리서치 → 기획 → 코딩 → 검증 → 배포)로 보면, 1일차에 리서치·코딩·배포를 먼저 손으로 겪고, 2일차에 전체의 절반이 정해진다는 기획, 곧 PRD를 쓴다. 어제 한 일이 하나하나 PRD의 칸을 채우는 연습이었다는 게 덱의 설명이다.
3. 결정과 확인은 사람 몫이다. 이틀 내내 반복되는 문장이다. 단계마다 결과 확인은 사람이 하고, 우리 업무의 기준 숫자와 예외는 AI에게 추천받지 않고 내가 답한다. 본사 업무를 아는 직원이 PRD를 써야 하는 이유도 여기에 있다.

본사 직원 교육을 생각하고 있다면

프랜차이즈 본사나 회사 단위로 직원들과 이런 실습을 하고 싶다면 기업 교육 문의에 회사 상황과 함께할 부서를 남겨 주시면 된다. 회사 PC 환경과 업무에 맞춰 다루는 순서와 실습 주제를 조정해 제안드린다. 직원 교육보다 특정 업무를 먼저 AI로 바꾸고 싶다면 AI 자동화 상담 신청으로 들려주시면 된다. 덱에 나온 용어(터미널, Git, 배포)는 바이브코딩 강의 1편부터 이어지는 시리즈에서 하나씩 풀어 두었다.

기업 교육 문의하기 →