Menu
세션 간 맥락을 연결해야 할 때. — MUST TRIGGER: 세션 시작 시 NOVA-STATE.md 읽기, 커밋 후 상태 갱신, 스프린트 전환 시.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Nova 자체를 진화시킬 때 사용한다. — MUST TRIGGER: /nova:evolve 호출, 외부 기술 동향을 Nova에 반영해야 할 때, Nova 메타-개선(규칙/스킬/훅 구조 변경) 작업.
단일 Evaluator의 편향이 우려되는 중요 판단일 때 여러 관점으로 재검토한다. — MUST TRIGGER: 아키텍처 결정, 릴리스 게이트 의심 케이스, 사용자가 /nova:ask 또는 다관점 평가를 요청할 때.
새 Nova 스킬을 작성하거나 기존 스킬 description을 수정할 때. — MUST TRIGGER: skills/ 하위 신규 SKILL.md 생성, 기존 SKILL description 리팩터, 사용자가 'Nova 스킬 추가/수정' 요청 시.
Nova 방법론을 실제 프로젝트에서 검증해 개선 포인트를 찾을 때. — MUST TRIGGER: 신규 Nova 기능 검증, 사용자가 실전 피드백을 요청할 때, 워크트리 격리 환경에서 방법론을 리허설할 때.
자연어 요청을 받아 전체 개발 사이클을 자동 처리해야 할 때. — MUST TRIGGER: /nova:auto 호출, 사용자가 '전체 알아서 해줘' 유형의 요청을 할 때, 다중 에이전트 편성이 필요한 복합 작업.
Plan 문서의 탐색 폭/검증 깊이가 부족할 때 깊이 있는 Plan을 생성한다. — MUST TRIGGER: 복잡도 8+ 작업, 아키텍처 분기 결정, /nova:plan 결과가 얕다고 판단되는 경우, 사용자가 /nova:deepplan 호출.
| name | context-chain |
| description | 세션 간 맥락을 연결해야 할 때. — MUST TRIGGER: 세션 시작 시 NOVA-STATE.md 읽기, 커밋 후 상태 갱신, 스프린트 전환 시. |
| description_en | Use when session-to-session context must carry over. — MUST TRIGGER: reading NOVA-STATE.md on session start, updating state after commit, or on sprint transitions. |
| user-invocable | false |
docs/nova-rules.md §8 세션 상태 유지 (Known Gaps 필수, 즉시 업데이트 트리거, 커밋 전 일괄 갱신)docs/nova-rules.md §10 관찰성 계약 — NOVA-STATE(사람용) × JSONL(기계용) 역할 분담세션이 끊겨도 작업 맥락이 유지되도록 한다. NOVA-STATE.md를 단일 진입점으로 사용한다.
외부 대안 비교:
docs/comparison/context-chain-vs-external.md— Nova vs claude-mem(vector DB)·Continuous-Claude-v3(ledger+handoffs) 차별점 표.
.nova/events.jsonl(기계용) — v5.44.0+ 재정의| 기록 | 용도 | 수명 | 손편집 책임 |
|---|---|---|---|
NOVA-STATE.md 본문(Current/Goal/Phase/Risks/Refs) | 사람·AI가 읽는 현재 상태 스냅샷 | 프로젝트 생애 | AI/사용자 직접 편집 (작은 영역, 트림 불필요) |
NOVA-STATE.md v3 marker 영역 | 자동 렌더 — Active Tree + 최근 work-item 활동 | 프로젝트 생애 | 손편집 금지 (scripts/registry-render-state.sh 자동 갱신) |
.nova/events.jsonl | 활동 시계열 단일 진실원 — 11 타입 × timestamp | rotation (10MB/5 파일/30일) | hooks/record-event.sh 자동 (AI 호출 X) |
핵심 원칙 (v5.44.0+):
KPI 집계: scripts/nova-metrics.sh가 JSONL을 집계하여 /nova:next가 표시. NOVA-STATE.md는 수치 해석/맥락 역할.
NOVA-STATE.md가 있으면 읽고 현재 상태를 파악한다
NOVA-STATE.md가 없으면 다음을 스캔하여 상태를 추론한다:
git log --oneline -10 — 최근 작업 방향docs/plans/, docs/designs/ — 진행 중인 설계docs/verifications/ — 최근 검증 결과NOVA-STATE.md를 자동 생성한다| 이벤트 | NOVA-STATE.md 손편집 (AI/사용자) | 자동 기록 |
|---|---|---|
| 작업 시작 | Tasks에 행 추가 (Status: doing) | — |
| git commit | 관련 Task의 Status 업데이트 | hooks/record-event.sh (commit 이벤트) |
/nova:plan 완료 | Current Goal/Phase, Refs Plan 경로 | events.jsonl + marker 자동 렌더 |
/nova:design 완료 | Phase → building, Refs Design 경로 | events.jsonl + marker 자동 렌더 |
/nova:deepplan 완료 | Phase → planning, Refs Plan 경로 | events.jsonl + marker 자동 렌더 |
/nova:run 완료 | Phase 갱신 (PASS→done, FAIL→building), Tasks 제거 | events.jsonl + marker 자동 렌더 |
/nova:auto 완료 | (필요 시) Current/Phase 정리 | events.jsonl + marker 자동 렌더 |
/nova:review 완료 | Refs의 Last Verification | events.jsonl + marker 자동 렌더 |
/nova:check 완료 | Refs의 Last Verification | events.jsonl + marker 자동 렌더 |
/nova:ux-audit 완료 | (Critical 있으면) Known Risks 추가 | events.jsonl + marker 자동 렌더 |
| 작업 완료 | Tasks에서 제거 | events.jsonl (work_item_transitioned) |
v5.44.0+ 단일 진실원 모델: AI는 NOVA-STATE.md의 시계열 영역(Recent Activity 표, Recently Done 표)에 직접 행을 추가하지 않는다. 시계열은 hooks/record-event.sh가 .nova/events.jsonl에 자동 기록 + Stop hook이 scripts/registry-render-state.sh로 v3 marker 영역을 자동 갱신. 8개 진입점은 본문 스냅샷(Current/Phase/Refs/Risks)만 손편집한다.
v3 marker 영역: NOVA-STATE.md의 <!-- nova:registry-rendered:start --> ~ <!-- nova:registry-rendered:end --> 사이는 scripts/registry-render-state.sh가 자동 렌더한다. 손편집 금지. work-item index는 .nova/work-items/index.json이 진실원. v2/v1 STATE(marker 부재)는 자동 렌더 silent skip — 시계열 영역이 빈 채로 유지되며 사용자가 활동을 보려면 /nova:status HTML 대시보드(events.jsonl 기반) 사용.
NOVA-STATE.md의 Last Activity는 반드시 1줄로 기록한다:
## Last Activity
- /nova:review → PASS — src/api/ | 2026-04-02T15:30:00+09:00
4줄(커맨드/시각/결과/대상) 포맷은 사용하지 않는다.
docs/verifications/에 보존됨 — STATE에서 지워도 유실 없음.git log (해결 커밋 + 메시지).nova/events.jsonl (work_item_transitioned to=resolved, 자동 기록).nova/work-items/index.json (v3 registry — status 갱신)NOVA-STATE.md가 최신 상태인지 확인한다NOVA-STATE.md + Design 문서로 새 세션에서 상태 복원NOVA-STATE.md가 대체본 스킬은 상태-수준 데이터 모델(events.jsonl 단일 진실원 + NOVA-STATE 본문 스냅샷)을 다룬다. Claude Code 세션 컨텍스트 창 자체의 /clear·/compact 시점은 skills/strategic-compact/SKILL.md. 둘은 별도 트리거·별도 효과 — 토큰 압박은 /clear·/compact로 해소.