야간 빌드 프롬프트
전체 템플릿은 references/overnight-build-template.md에 있습니다. 작성하기 전에 반드시 읽으세요. 규칙 구조를 기억에서 다시 유추하지 말고 — 템플릿의 [대괄호] 섹션을 사용자의 구체적인 정보로 채우고, 사용자가 자신의 사본에 이미 적용한 편집 내용은 유지하세요.
필수 사항
모든 출력에는 규칙 8 (사용량 초기화 대처) 과 런처(LAUNCHER) 섹션이 반드시 포함되어야 합니다. 이 두 가지가 빌드를 재시작 가능하게 만듭니다. 이들이 없으면 첫 번째 사용량 초기화 후 빌드가 조용히 처음부터 다시 시작되어 밤을 허비하게 됩니다.
구성 방법
- 템플릿을 읽습니다. 사용자가 편집한 사본을 가지고 있다면 그 사본을 우선으로 합니다 — 사용자의 변경 사항을 보존하세요.
- 명세를 채웁니다. — 무엇을 빌드할지, 컨텍스트, 디자인 요구사항, 기술 요구사항, 우선순위별 기능, 시드 데이터, 배포, 성공 기준. 여기서 구체성이 가장 중요합니다. 모호한 명세는 모호한 밤을 만듭니다.
- 단계를 설정합니다. — 4~8단계, 각 단계는 독립적으로 완료 및 검증 가능해야 하며, 시간 할당의 합이 예산과 일치해야 합니다.
- 피벗 플레이북을 채웁니다. 템플릿의 기본적인 장애물 외에도 프로젝트별 블로커를 추가합니다.
- 런처 선택을 한 번 묻습니다. (A: OS 스케줄러 · B: bash 루프 · C: scheduled-task MCP) — 요청에 명시되지 않은 경우 한 번만 묻고 진행합니다.
- 단일 복사 가능한 코드 블록으로 출력하고, 실행 전에 프로젝트 루트에
overnight-build-prompt.txt로 저장하도록 사용자에게 알립니다.
완료 신호
프롬프트는 빌드가 마지막 줄로 BUILD_COMPLETE를 출력하도록 지시해야 합니다 — bash 루프 런너는 이 신호를 찾아 종료합니다. 프롬프트에 명확히 명시하세요: P0 기준이 실제로 충족되지 않은 경우 BUILD_COMPLETE를 출력하지 않는 것이 올바른 동작입니다. 완료되지 않은 빌드에서 런너가 종료되는 것은 계속 실행되는 것보다 더 나쁩니다.
가드레일
무인 에이전트에게는 물어볼 사람이 없으므로 프롬프트가 자체 경계를 명시해야 합니다.
대상이 기존 프로덕션 코드베이스인 경우 먼저 파일 소유권과 DO-NOT(금지) 목록을 도출하고 (fleet-brief 스킬이 둘 다 생성합니다) 프로젝트의 검증 검사를 테스트 단계에 포함시켜 "완료"가 병합이 아닌 검증을 의미하도록 하세요.
야간 프롬프트가 다음 작업을 승인하도록 절대 허용하지 마세요: 데이터베이스 마이그레이션 적용, 스키마 푸시, 호스팅 CLI를 통한 배포, 전화번호 또는 도메인 구매/해제, 실제 연락처로의 발신 메시지 전송. 이러한 작업은 사람이 깨어 있을 때 필요합니다. 프로젝트 자체의 되돌릴 수 없는 작업도 이 목록에 추가하세요.
빌드가 작성해야 하는 산출물
BUILD_LOG.md— 단계 항목, 결정, 피벗, 알려진 이슈, 다음 정확한 단계가 포함된## CHECKPOINT — <ISO>블록RESEARCH_NOTES.md— 구현 시작 전 연구 결과
재개 시, 빌드의 첫 번째 동작은 BUILD_LOG.md를 처음부터 끝까지 읽고 최신 체크포인트부터 계속하는 것입니다 — 절대 재연구, 재스캐폴딩, 재시작하지 않습니다.