context-chainlisted

# Nova Context Chain ## 적용 규칙 (on-demand 로드) - `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-STATE(사람용) × `.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+)**: - **시계열 진실원은 events.jsonl 하나.** NOVA-STATE.md의 Recent Activity 표 / Recently Done 표는 v3 marker가 있으면 자동 렌더, 없으면 사용자 손편집 영역(자연 안정화). - **AI는 STATE 본문 스냅샷만 손편집** — Current/Goal/Phase/Refs/Risks. 시계열 표에 행 추가 X. - **트림 의무 없음.** 본문 스냅샷은 본질적으로 작고, marker 영역은 스크립트가 상수 크기로 유지. **KPI 집계**: `scripts/nova-metrics.sh`가 JSONL을 집계하여 `/nova:next`가 표시. NOVA-STATE.md는 수치 해석/맥락 역할. ## 세션 시작 프로토콜 1. 프로젝트 루트에 `NOVA-STATE.md`가 있으면 읽고 현재 상태를 파악한다 - Current → 지금 뭘 하고 있었는지 - Tasks → 진행 중/대기 중인 작업 (Status: todo/doing/done) - Blocker → 막혀 있는 것이 있는지 - Refs → 관련 설계/검증 문서