바이브코딩 첫 지시는 문서 한 장: 실제 프로젝트 3개 로그로 본 시작법

이런 분께 / 준비물

이런 분께 맞습니다.

• AI 코딩 도구로 홈페이지나 업무용 화면을 만들어 보고 싶은 직장인
• 써 봤는데 AI가 엉뚱한 것을 만들어 처음부터 다시 시킨 경험이 있는 분
• 여러 아이디어 중 무엇부터 만들지 정하지 못한 분

준비물

• AI 코딩 도구 하나. 이 글의 기록은 Claude Code 기준입니다.
• 이 글의 착수 문서 템플릿(텍스트 파일, 메모장으로 열림)
• 만들 것의 목적을 한 문단으로 말할 수 있는 정도의 생각

실제 프로젝트 3개, 문서에서 결과까지 걸린 시간

세 프로젝트 모두 문서를 받은 AI는 바로 만들지 않고 계획부터 보여 준 뒤 멈췄습니다. 사람은 계획을 읽고 번호로 답하거나 “승인”이라고 보냈습니다.

Claude Code 대화 기록의 메시지 시각으로 계산. 프로젝트 기간 2026-10-17~25. 사람이 보낸 메시지는 작업 대화 기준(문서를 만든 별도 대화 제외)으로 승인·진행 확인·추가 요청을 모두 셌고 자동 알림은 뺐다. 주제 고르기의 승인 → 결과는 사람이 다시 돌아와 '계속 진행해'라고 보낸 시각부터 잰 값(중간에 승인 1번 더)

프로젝트	착수 문서	문서 → AI 계획	승인 → 결과	사람이 보낸 메시지
업종별 홈페이지 3개	킥오프 문서 51줄	6분 49초 (화면 설계 3개)	1시간 39분 (공개 배포, 추가 요청 3건 포함)	8개
출퇴근·급여 업무 앱 데모	상황 설명 5줄 + "인터뷰 후 착수"	9분 55초 (질문 12개 → 기획서)	24분 36초 (로컬 데모)	2개 (+선택형 답 12개)
만들 주제 고르기	기준표 문서 92줄	23분 (후보 56개 정리)	1시간 13분 (추천 1개)	5개

표에서 볼 것은 속도보다 순서입니다.

• 계획이 먼저 나왔습니다. 홈페이지 사례에서 AI는 화면 설계 3개를 쓴 뒤 “승인 전에는 화면을 만들지 않겠다”고 멈췄습니다.
• 사람은 답만 했습니다. 승인 메시지는 AI가 물은 3가지에 “이미지 생성 직접해 / 브랜드 이름 그대로 / 승인”이라고 번호로 답한 한 줄이었습니다.
• 주제 고르기는 사람이 마무리했습니다. AI는 같은 날 추천 1개를 냈고, 확정은 5일 뒤, 다른 아이디어 2개를 같은 방식으로 더 따져 본 다음 제가 했습니다.

착수 문서에 들어간 5칸

세 프로젝트의 문서(업무 앱은 AI가 인터뷰 뒤 쓴 기획서)는 생김새가 달랐지만 뼈대는 같았습니다. 목적, 정해진 것, 하지 말 것, 순서와 멈춤 지점, 완료 확인법입니다.

칸	실제 문서에 적혀 있던 것 (요지)
1. 목적	홈페이지: 영업용 샘플이라 업종별 기능이 실제로 동작해야 함
2. 정해진 것	휴대폰 360px 화면 기준, 모바일에서 섹션당 2~3줄, 가상 브랜드와 가짜 전화번호
3. 하지 말 것	이미 검토해서 버린 주제 목록, 의료 광고 규정에 걸리는 표현
4. 순서와 멈춤	설계 먼저 → 승인 → 구현, 공개 배포는 승인 뒤
5. 완료 확인법	휴대폰·PC 화면 캡처로 확인, 예약 폼·계산 같은 기능을 직접 눌러 볼 것

가장 효과가 컸던 칸은 4번입니다. 이 칸이 있으면 AI가 잘못 이해한 부분을 만들기 전에 고칠 수 있습니다. Claude Code 공식 모범 사례도 원하는 것이 분명하지 않을 때는 먼저 Claude에게 질문을 받으며 명세를 쓰게 하고, 결과를 확인할 수 있는 점검 방법을 주라고 안내합니다.

바이브코딩 첫 지시, 상황별로 다르게 시작하기

내 상황에 따라 첫 메시지가 달라집니다. 세 프로젝트가 각각 다른 방법을 썼습니다.

상황	시작법	실제로 보낸 첫 메시지 (요지)	걸린 시간
만들 것이 분명함	킥오프 문서	“(문서 파일 경로) 진행해”	6분 49초 뒤 설계 3개
여러 후보 중 골라야 함	기준표 문서	조건 5개, 탈락 기준 7개, 단계 4개를 적은 문서 붙여 넣기	23분 뒤 후보 56개
아직 머릿속이 정리 안 됨	인터뷰 요청	상황 한 문단 + “충분히 인터뷰한 다음 착수”	9분 55초 뒤 기획서

만들 것이 분명할 때는 템플릿 5칸을 채운 문서를 파일로 저장하고 “이 파일대로 진행해”라고 보냅니다. 범위·기기·금지 사항이 문서에 있으니 대화로 다시 설명할 일이 줄어듭니다.

여러 후보 중 골라야 할 때는 2칸에 “꼭 맞아야 하는 조건”, 3칸에 “하나라도 걸리면 탈락하는 기준”을 번호로 적습니다. 주제 고르기 사례에서는 1위였던 후보가 탈락 기준 하나에 걸려 떨어졌고, AI는 규칙대로 다음 후보를 추천했습니다.

아직 정리되지 않았을 때는 문서를 억지로 쓰지 않습니다. 업무 앱 사례에서는 상황을 5줄로 설명하고 “인터뷰 후 착수”라고만 붙였습니다. AI가 선택형 질문을 4개씩 3번 물었고, 답을 마치자 기획서가 나왔습니다. 기획서를 쓰는 중에 AI가 스스로 규정과 맞지 않는 부분을 찾아 고친 기록도 있습니다.

착수 문서는 AI에게 쓰게 하기

착수 문서를 직접 처음부터 쓸 필요는 없습니다. 홈페이지 사례의 51줄짜리 킥오프 문서는 다른 대화창의 AI가 썼습니다.

1. 먼저 조사 대화를 합니다. 이 사례에서는 직전에 “어느 업종 홈페이지 수요가 많은지”를 물어 업종별 검색량을 받았습니다.
2. 한 줄로 문서를 부탁합니다. “이 프로젝트에서 착수할 프롬프트만 만들어 줘”에 업종 3개와 업종별 특화 구성이 필요하다는 조건을 붙여 보냈고, 43초 뒤 문서 초안이 나왔습니다.
3. 파일로 저장합니다. 대화창의 긴 글은 복사하기 불편하니 “.md 파일로 만들어 줘”라고 하면 됩니다.
4. 작업할 대화창에 넘깁니다. “이 파일 진행해” 한 줄이면 됩니다.

문서를 받으면 3칸(하지 말 것)과 4칸(멈춤 지점)만은 직접 읽고 고칩니다. 공개하면 안 되는 정보와 사람이 해야 할 승인 단계는 AI가 알아서 채우기 어렵기 때문입니다.

직접 해본 결과

세 프로젝트에서 확인한 것을 숫자로 정리하면 다음과 같습니다.

• 문서를 준 뒤 첫 계획까지: 6분 49초 / 9분 55초 / 23분
• 승인 뒤 결과까지: 1시간 39분(배포) / 24분 36초(로컬 데모) / 1시간 13분(추천 1개)
• 착수부터 결과까지 사람이 보낸 메시지: 8개 / 2개 / 5개
• 문서 분량: 51줄 / 5줄 + 질문 12개 / 92줄

메시지가 적었던 것은 큰 결정이 문서와 승인 단계에 모여 있었기 때문으로 봅니다. 중간 메시지는 대부분 진행 확인과 범위를 넓히는 추가 요청이었습니다.

주의할 점과 한계

• 문서가 있어도 중간 요청은 생깁니다. 홈페이지 사례에서는 승인 뒤에 신청 폼 추가, 한 페이지 디자인 보강, 마우스 효과 추가 요청이 3건 나왔습니다. 특히 “방문자가 나에게 연락하는 방식”은 문서에 칸이 없어서 나중에 정했습니다. 그래서 템플릿 2칸에 이 항목을 넣었습니다.
• 같은 일을 문서 없이 해 본 비교가 아닙니다. 세 프로젝트는 각각 한 번씩만 했습니다. 문서가 없었다면 얼마나 걸렸을지는 재지 않았습니다.
• 시간은 대화 기록의 메시지 시각입니다. AI가 보고한 숫자가 아니라 기록에 남은 시각으로 계산했습니다. 같은 문서를 써도 도구, 요금제, 작업 크기에 따라 시간은 달라집니다.
• 되돌리기 어려운 단계는 사람이 합니다. 세 프로젝트에서 공개 배포, 결제, 최종 전송은 사람이 “배포해”라고 지시하거나 직접 눌렀습니다. 문서 4칸에 이 단계를 꼭 적으세요.
• 계획서를 꼼꼼히 읽는 시간은 아끼지 마세요. AI가 멈춰 준 의미는 사람이 그 자리에서 고칠 기회를 준다는 데 있습니다. 읽지 않고 “승인”만 보내면 문서 없이 시작한 것과 다르지 않습니다.