菜单
세션 간 맥락을 연결해야 할 때. — MUST TRIGGER: 세션 시작 시 NOVA-STATE.md 읽기, 커밋 후 상태 갱신, 스프린트 전환 시.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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로 해소.