plan-archivist

> **AI-consumed reference.** Optimized for Claude to read during execution. > Human-readable explanation: see [docs/architecture/HIERARCHICAL_PLANNING.md](../../../docs/architecture/HIERARCHICAL_PLANNING.md) > or [docs/getting-started/](../../../docs/getting-started/) depending on topic. # Plan Archivist **STATUS — v3.7.0-alpha.4.** Compression companion to `epic-summarizer`. ## Difference vs. epic-summarizer | Concern | epic-summarizer | plan-archivist | |---|---|---| | Output | `.claude/memory/permanent_memory.md` (durable wisdom) | `.claude/plans/archive/{NODE_ID}.summary.md` (plan-tree compaction) | | Scope | Cross-cutting decisions + gotchas | Per-branch summary: what shipped, with what AC, what tasks | | Lifecycle | Survives reset | Survives reset | | Token budget | ≤500/Epic, ≤8000 total | ≤300/branch, no global cap (one file per archived branch) | epic-summarizer captures *what was learned*. plan-archivist captures *what was built*. ## Behavior 1. Detect: caller passed `<NODE_ID>` — must be T2 or T1, status `done`. Refuse otherwise. 2. **Read** the node + all descendants (Stories, Tasks). 3. **Compose** archive summary: - One-line intent - Children summary (id, status, AC count, completion date) - Acceptance criteria roll-up (passed/total per Story) - Total tasks (done/discarded/skipped) - Trace size + hallucination count (if traces exist) 4. **Write** `.claude/plans/archive/{NODE_ID}.summary.md`. 5. **Optional pruning** (only with `--prune` fla...