orchestrator

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 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 hooks/record-event.sh sprint_started "{...}"   # 착수
bash hooks/record-event.sh sprint_completed "{...}" # 종료 (verdict 포함)

블로커 감지/해소 시 (§7 분류):

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 도구 호출	누락 시 영향
Phase 0: 오케스트레이션 등록	orchestration_start — task, complexity, phases 전체 등록	세션 끊기면 복구 불가 + 외부에서 진행 조회 불가
Phase N 시작	orchestration_update — status: "running"	어느 Phase에서 끊겼는지 모름
Phase N 완료	orchestration_update — status: "completed" + result	Phase 소요 시간·산출물 메트릭 공백
Phase N 실패	orchestration_update — status: "failed" + result	실패 패턴 분석 불가
상태 확인	orchestration_status — 현재 진행 상황 조회	(조회용, 선택)

Phase 0: 오케스트레이션 등록 (무조건 최우선)