Plan（계획）

docs/staging/plans/YYYY-MM-DD-<topic>.md. 명세를 참조하고, 반복하지 않는다.

미해결된 명세 노트가 구현이나 작업 순서에 영향을 미치면 design으로 돌아간다.

마일스톤 작업 (각 30~60분)

각 작업은 - [ ] T<n>: <이름> — 항상 체크박스, 제목이 아님. tdd/subagents가 완료 시 - [x]로 변경. ship은 모든 - [ ]가 완료될 때까지 실행을 거부한다.

goal:       <한 줄>
files:      <경로>
acceptance: <테스트 또는 명령어>
spec:       <docs/staging/specs/...#anchor>

정확한 코드 없음. 단계 없음. Acceptance는 실행 가능: 테스트 이름, 명령어, 또는 스크립트 확인. 각 작업은 저장소를 그린 상태로 유지한다.

독립적인 작업 표시: [parallel] T3, T4, T5.

공유 계약, 상태, 오류, acceptance가 닫혀있을 때만 [parallel] 표시.

원자적 전개는 배포 시 지연 — subagents가 배포 시 마일스톤을 2~5분 단계로 전개한다. 여기서 하지 않는다.

신규 프로젝트: 초기화 작업을 파생시킨다 — 스캐폴드 코드, 테스트, CI. 항상 포함: README.md, CHANGELOG.md, .gitignore, Makefile (또는 동등한 태스크 러너 구성).

계획에 포함하지 않을 것

배경, 아키텍처, 이유 (명세), CI 명령어, 복붙된 acceptance.

롤링 웨이브

명세에 ## Roadmap이 있는가? ← 지금 상세 계획으로 표시된 마일스톤만 전개한다. 나머지는 스텁으로 둔다.

ship 후: ← 지금 상세 계획 마커를 다음 마일스톤으로 이동하고 (해당 ← stub을 ← 지금 상세 계획으로 변경), 배운 것을 기반으로 업데이트한 후 전개한다. 마일스톤 목표가 본질적으로 바뀐 경우에만 design으로 돌아간다.

Gate

tdd/subagents에 인계하기 전에 docs/staging/plans/YYYY-MM-DD-<topic>.md가 디스크에 존재해야 한다.

사용자와 계획을 확인한다.

[parallel]이 많음 → subagents. 그렇지 않으면 → tdd.