orchestratorlisted

# Nova Orchestrator ## 적용 규칙 (on-demand 로드) - `docs/nova-rules.md §2` Generator-Evaluator 분리 + 핸드오프 (self_verify 필드) - `docs/nova-rules.md §6` 복잡한 작업의 스프린트 분할 (각 스프린트 완료 = Evaluator 필수) - `docs/nova-rules.md §10` 관찰성 계약 — Phase 전이·스프린트 전환 시 이벤트 기록 ## 관찰성 훅 (v5.12.0+) **Phase 전이** 시 (예: Phase A→B, pending→running→completed) 이벤트 기록: ```bash bash hooks/record-event.sh phase_transition "$(jq -cn \ --arg oid "$ORCHESTRATION_ID" \ --arg phase "$PHASE_NAME" \ --arg from "$FROM_STATUS" \ --arg to "$TO_STATUS" \ '{orchestration_id:$oid, phase_name:$phase, from_status:$from, to_status:$to}')" ``` **Sprint 전환** 시: ```bash bash hooks/record-event.sh sprint_started "{...}" # 착수 bash hooks/record-event.sh sprint_completed "{...}" # 종료 (verdict 포함) ``` **블로커 감지/해소** 시 (§7 분류): ```bash bash hooks/record-event.sh blocker_raised "$(jq -cn --arg t \"$BTYPE\" --arg c \"$CAUSE\" '{blocker_type:$t, cause:$c}')" 2>/dev/null || true bash hooks/record-event.sh blocker_resolved "$(jq -cn --arg t \"$BTYPE\" --arg r \"$RESOLUTION\" '{blocker_type:$t, resolution:$r}')" 2>/dev/null || true ``` Safe-default: 실패는 exit 0, 상위 파이프라인 영향 없음. 자연어 한 줄을 받아서 설계→구현→검증→수정 전체 파이프라인을 자동 실행한다. ## 핵심 원칙 - 설계가 구현보다 먼저다 (CPS) - Generator ≠ Evaluator (역할 분리) - 구조화된 프롬프트가 자연어보다 낫다 - 멀티 프로젝트 병렬 지원 ## 오케스트레이션 추적 (MCP 도구) — **필수 계약** **이 섹션은 soft 권고가 아니라 계약이다.** 각 Phase 진행 상황은 반드시 MCP 도구로 추적한다. 세션 중단 시 `.nova-orchestration.json`으로 복구 지점이 되며, 누락 시 Evolve 피드백 루프의 관찰 데이터가 공백이 된다. | 시점 | MCP 도구 호출 | 누락 시 영향