Vibe Build은(는) 무엇을 하나요?
에이전트가 자율적으로 실행하는 완전한 빌드 워크플로우입니다. 사용자는 제품 결정을 내리고, 에이전트는 프로세스 결정을 내립니다. 사용자에게 워크플로우를 설명하도록 요청하지 마세요. 워크플로우를 따르세요. 사용자에게는 무엇을 만들지, 선호 사항, 그리고 게이트에서 승인 여부만 물어보세요.
하나의 규칙
제품 결정 = 사용자 입력. 프로세스 = 에이전트의 몫. 사용자에게 질문하기 전에, 그것이 제품 결정인지 확인하세요. 그렇지 않다면 직접 결정하고 진행하세요.
0단계 — 부트스트랩 (새 프로젝트만 해당)
- 스택을 식별하세요. 프로젝트가 완전히 정의되지 않은 경우, 정확히 한 가지 질문을 하세요: "무엇을 만들어야 할까요? (한 문장이면 충분합니다)". 인터뷰하지 마세요.
- 스택을 직접 조사하세요: 현재 프레임워크 버전, 권장 설정, 표준 프로젝트 레이아웃. 웹 검색과 프레임워크 문서를 사용하세요 (프로젝트의 문서 조회 기능이나 웹 검색을 이용). 결정 사항을 최대 5줄로 요약하세요. 사용자에게 연구 자료 벽을 붙여넣지 마세요.
- references/agentsmd-template.md의 템플릿을 사용하여 프로젝트 루트에
AGENTS.md를 작성하세요. 이는 프로젝트의 헌법입니다: 이후 모든 단계는 구조적 결정 전에 이 문서를 읽으므로, 사용자가 규칙을 다시 설명할 필요가 없습니다. - 프로젝트에 필요한 임시 스킬(최대 5개)을 설치하세요. references/temp-skills.md를 따르세요. 프로젝트가 간단하거나 기존 스킬로 충분하다면 스킬 설치는 완전히 건너뛰세요.
- 부트스트랩 결과를 15줄 이내로 보고하고, 제안된 번호가 매겨진 계획을 제시한 후, 프로젝트 코드를 작성하기 전에 승인을 기다리세요.
1단계 — 계획 수립
- 번호가 매겨지고 범위가 지정된 계획을 수립하세요. 한 세션에 수행할 수 있는 작은 작업과 나중으로 명시적으로 연기할 항목을 구분하세요.
- 명시적인 승인을 받으세요. 사용자가 계획을 수정하면 수정 사항이 우선합니다.
- 인터리빙을 주의하세요: 계획이 아직 열려 있는 동안 빌드를 시작하지 마세요.
2단계 — 빌드
- 프로젝트에 적합한 경우 테스트 규율을 따르세요: 로직에는 테스트, 임시 접착제 코드에는 수동 확인. 단순한 빌드에 무거운 테스트 프레임워크를 만들지 마세요. 버그가 피해를 줄 수 있는 로직에 대한 테스트를 건너뛰지 마세요.
- 의존성을 최소로 유지하세요. 모든 의존성은 사용자가 물려받는 책임입니다. 명확한 이점이 없으면 표준 라이브러리/제로 의존성을 선호하세요.
- 구조적 결정을 내리기 전에 항상
AGENTS.md를 확인하세요. 작업을 이분할 가능하도록 작은 명명된 커밋 단위로 커밋하세요.
3단계 — 검증 ('완료'라고 말하기 전에)
프로젝트를 실행하고 작동함을 증명하세요:
- UI가 존재함 → 실제 브라우저(Playwright 또는 에이전트의 브라우저 도구)에서 클릭하며 탐색하고, 콘솔 오류를 확인하고, 주요 흐름이 엔드투엔드로 작동하는지 검증하세요.
- 웹 UI → 접근성 및 상호작용 품질(포커스 상태, 폼, 다크 모드, 터치)을 감사하세요: 가능하면 디자인 가이드라인 리뷰 스킬을 사용하고, 그렇지 않으면 스스로 확인하세요.
- 인증, 비밀, 결제 또는 사용자 입력이 관련됨 → 보안 점검을 수행하세요: 입력 검증, 비밀 처리 (절대 비밀을 커밋하지 말고 환경 변수 치환 사용), 최소 권한 기본값.
- 주장 전에 증거를 제시하세요: 무엇이 실행되었고 무엇이 통과했는지 보고하거나, 실패했다면 먼저 수정하세요.
4단계 — 배포
- "배포 / 라이브로 푸시 / 미리보기 링크" → 프로젝트의 문서화된 경로를 통해 배포하세요. Vercel 호스팅 가능 프로젝트의 경우, 연결된 프로젝트에 git-push하고, 로그인이 없을 때는
vercel deploy --temporary로 대체한 후 URL을 전달하세요. - 풀 리퀘스트: 간결한 본문 — 무엇이 변경되었는지, 이유, 테스트 방법 — 차이점 설명이 아닙니다.
- "완료" 커밋은 방금 수집한 증거를 기반으로 빌드+테스트가 통과했음을 의미합니다.
5단계 — 임시 스킬 관리
임시 스킬(0단계 4번)은 프로젝트 범위로 제한됩니다. 프로젝트 종료 시 또는 임시 스킬이 광범위하게 유용하다고 판명되면 사용자의 공유 스킬 디렉토리로 승격하거나 삭제할 것을 권장하세요. 임시 스킬이 조용히 영구적인 전역 설치로 변이되지 않도록 하세요.
토큰 절약 (모든 단계)
충분히 작은 파일 범위만 읽고, 이미 본 전체 파일을 다시 읽지 마세요. 완료된 단계는 각 단계를 설명하기보다 한 번 요약하세요. 스크립트와 도구를 실행하고 내용을 채팅에 붙여넣는 것을 선호하세요. 스킬은 트리거에 의해 지연 로드되도록 하세요. 스킬 본문을 대화에 덤프하지 마세요.
참고 자료
- references/agentsmd-template.md — 0단계 3번에서 읽고 작성
- references/temp-skills.md — 임시 스킬을 설치하기 전 0단계 4번에서 읽음