01 ▸ 워크플로우 위치
사용자 요청 (복잡)
│
▼
┌─────────────────────────────┐
│ Clarification (9-15점) │
└──────────────┬──────────────┘
│
▼
┌─────────────────────────────┐
│ Milestone Planning (ACTIVE)│
│ 5개 병렬 리뷰 + DAG 합성 │
└──────────────┬──────────────┘
│
▼
┌─────────────────────────────┐
│ Long Run │
│ 마일스톤별 반복 실행 │
└─────────────────────────────┘
02 ▸ 언제 사용하나요?
Clarification에서 복잡(Complex, 9-15점) 판정을 내렸거나, 며칠이 걸리는 대규모 작업이 필요할 때 사용합니다.
주요 트리거
마일스톤 나눠줘, ultraplan 명령 시
- Long Run 하니스가 마일스톤 분해를 요청할 때
- 작업이 1회성 계획(plan-crafting) 범위를 초과할 때
03 ▸ 어떻게 동작하나요?
핵심 원리: 5개 리뷰어는 서로 정보가 격리된 상태에서 각자의 전문 관점(Feasibility, Architecture, Risk, Dependency, User Value)으로 문제를 비판합니다.
실행 단계
- Problem Framing: 목표, 범위, 제약사항을 포함한 Problem Brief 작성
- Parallel Dispatch: 5개 리뷰어 에이전트를 동시 가동 (교차 오염 방지)
- Synthesis: 리뷰 결과를 대조하여 갈등 해소 및 마일스톤 DAG 합성
- DAG Validation: 순환 의존성 및 파일 충돌 검증
- Integration Milestone: 최종 통합 검증 마일스톤 자동 추가
04 ▸ 마일스톤 수 가드
마일스톤 수는 3~7개가 권장됩니다. 7개 초과 시 경고가 표시되며, 10개 초과 시 관리를 위해 프로젝트 분할을 고려해야 합니다.
05 ▸ 하드 게이트
- 모든 리뷰어는 병렬로 실행되어야 함 (순차 실행 금지)
- 리뷰어 간 정보 격리 유지 (다른 리뷰어의 결과를 볼 수 없음)
- 모든 마일스톤은 측정 가능한 성공 기준을 가져야 함
- 의존성 구조는 반드시 DAG(순환 없음) 형태여야 함
- 리뷰어 출력물은 합성 에이전트에게 원문 그대로(verbatim) 전달되어야 함