01 ▸ 워크플로우 위치
Milestone Planning
│
▼
┌─────────────────────────────┐
│ Long Run (ACTIVE) │
│ 마일스톤별 반복 실행 │
└──────────────┬──────────────┘
│
▼
Review Work
02 ▸ 언제 사용하나요?
Milestone Planning이 완료된 직후. 또는 며칠에 걸친 대규모 리팩토링/기능 개발이 필요할 때 사용합니다.
주요 트리거
long run마일스톤 실행해줘- 입력: 잠긴 마일스톤 DAG
03 ▸ 어떻게 동작하나요?
핵심 원리: 모든 마일스톤이 독립 plan→run→review 사이클을 거칩니다. 실패된 마일스톤은 후속을 차단합니다.
실행 단계
- 마일스톤 순차 실행: 각 마일스톤별로 계획, 실행, 검증을 수행하고 체크포인트를 저장합니다.
- 재시도 에스컬레이션: 재실행 → 재계획 → 중단 순으로 최대 3회까지 시도합니다. (영구 카운터)
- 병렬 마일스톤 (worktree): 의존성이 없는 마일스톤은 별도 git worktree에서 동시에 실행합니다.
- 크로스-마일스톤 통합 검사: 각 마일스톤 완료 후 다른 마일스톤과의 간섭 여부를 탐지합니다.
- Final E2E 게이트: 전체 완료 후 최종 검증을 수행하고 Simplify로 코드를 정리합니다.
04 ▸ 내구성 설계
| 기능 | 설명 |
|---|
| 디스크 체크포인트 | state.md에 모든 상태 기록 — 크래시 생존 |
| 복구 프로토콜 | 중단 세션에서 마지막 체크포인트부터 재개 |
| Rate limit | Claude Code 내장 재시도와 정렬 |
| 컨텍스트 윈도우 | 장기 대화용 자동 압축 및 상태 분리 |
05 ▸ 하드 게이트
반드시 지켜야 할 원칙
- 실패한 마일스톤은 후속 마일스톤의 실행을 즉시 차단해야 합니다.
- 재시도 카운터는 세션이 중단되어도 유지되는 영구 카운터여야 합니다.
- 병렬 실행 시 각 worktree 간의 파일 충돌이 없음을 사전에 검증해야 합니다.
- 모든 상태 변화는 즉시 디스크의
state.md에 반영되어야 합니다.