deepplan

Nova DeepPlan

자연어 요청을 받아 Explorer 3개를 병렬로 실행하고, 그 결과를 종합하여 Critic-Refiner 루프로 강화된 Plan 문서를 생성한다.

핵심 원칙

• 기존 체계 침범 금지: CPS 골격을 유지한다. deepplan 출력물은 /nova:design, /nova:auto가 그대로 소비할 수 있어야 한다.
• 구조화된 핸드오프: Explorer 3개의 출력 포맷을 사전 정의해서 Synthesizer가 예측 가능하게 통합한다.
• Adaptive thinking 우선: Explorer/Critic/Refiner 서브에이전트에 고정 thinking budget을 강제하지 않는다. 모델이 작업 복잡도에 따라 자율로 조절한다. (Anthropic 권고 — 고정 budget은 복잡한 작업에서 열위)
• Generator ≠ Evaluator: Critic(evaluator/jury)은 Plan을 작성한 컨텍스트와 독립된 서브에이전트로 실행한다.
• 무한 루프 방지: --iterations 최대 3으로 clamp. Critic이 PASS를 내거나 iteration 소진 시 종료.

오케스트레이션 추적

Phase 진행 시 MCP 도구로 추적한다. MCP 도구가 사용 불가능한 환경에서는 추적 없이 실행한다.

시점	MCP 도구 호출
파이프라인 시작	orchestration_start
Phase 시작/완료	orchestration_update

---

Execution

사전 처리: 플래그 파싱 + NOVA-STATE.md 갱신

1. $ARGUMENTS에서 요청 텍스트와 플래그를 분리한다.

   플래그	기본값	규칙
   --iterations=N	1	max(1, min(N, 3)) — 초과 시 3으로 clamp, 미만 시 1로 clamp
   --jury	false	true이면 Critic에서 jury 스킬 호출

2. slug 추출 (orchestrator와 동일 규칙):

   • 따옴표(' 또는 ") 안의 텍스트를 추출한다. 따옴표가 없으면 플래그(--xxx)를 제외한 전체 텍스트를 사용한다.
   • 공백을 -로 치환한다.
   • 한글·영문·숫자·하이픈 이외의 특수문자를 제거한다. 한글은 유지한다.
   • slug가 빈 문자열이면 요청 첫 단어를 slug로 사용하고 경고를 출력한다: [DeepPlan] slug 추출 실패 — 첫 단어를 slug로 사용: {단어}
   • 예시: "건폐율 시각화 추가" → 건폐율-시각화-추가, "add carousel" → add-carousel

3. NOVA-STATE.md 갱신 (파일이 있을 때만):

   • Phase를 deep-planning으로 설정한다.
   • Last Activity 갱신:

     - /nova:deepplan → 시작 — docs/plans/{slug}.md | {ISO 8601}
     

   • 시계열은 events.jsonl 단일 진실원 (v5.44.0+): NOVA-STATE.md의 Recent Activity / Recently Done 표에 행 추가 X. 활동 기록은 hooks/record-event.sh(자동 호출)가 .nova/events.jsonl에, v3 marker 영역은 Stop hook이 scripts/registry-render-state.sh로 자동 갱신. AI는 Current/Phase/Refs/Risks 본문 스냅샷만 손편집 — 트림 의무 없음. (상세: skills/context-chain/SKILL.md)

4. 로그 출력:

   [DeepPlan] 시작 — slug: {slug}, iterations: {N}, jury: {true/false}
   [DeepPlan] 출력 경로: docs/plans/{slug}.md