keel-distill

# /keel-distill — the memory consolidation ritual ("sleep" for the project) Run when `HANDOVER.md` exceeds **5 session blocks / ~200 lines**, when `LESSONS.md` or `TASKS.md` exceeds **~100 lines** (the SessionStart hook warns on all of these), or every ~5 sessions as hygiene — that cadence is yours to keep, the hook only detects cap overflows. Memory that is written but never reviewed degrades the project — consolidation is what keeps it useful (rules.md §9). Propose the full plan, get user approval, then apply. Never lossy-delete. ## 1. Rotate HANDOVER blocks (oldest first, until ≤4 blocks AND under ~200 lines) For each block being rotated, triage by criticality — **content-aware, not age-blind**: - **(b) Tried, didn't work** → PERMANENT: distill each to one `LESSONS.md [fail]` line (`<date> — <approach> → FAILED: <reason>. (full trace: docs/handover-archive.md, block <date>)`). - **Open questions** live in HANDOVER's global section, not in blocks — leave them until resolved. - **(a) Completed** → nothing to move: git history + the archive keep it. - **(c) Latest updates** → superseded by newer blocks — nothing to promote; the verbatim archive keeps it. - **(d) Next steps** of an old block → dead (that work is done or re-planned) — no promotion. - Then move the WHOLE block **verbatim** to the TOP of `docs/handover-archive.md` (prepend, newest first — restorable compression: the distilled lines keep pointers back to it). ## 2. Consolidate LESSONS.md (write-policy: add...