project-memory
project-memory
An umbrella memory system for a project. Lives at project-memory/ at the project root so teammates see it immediately, and is committed to git so the memory travels with the code.
Today the only subsystem is project-memory/lesson-learned/ (per-session retrospectives). Future subsystems — decisions, glossaries, onboarding notes, whatever — land as sibling folders under project-memory/ and are auto-indexed by the same qmd collection.
Every new session is seeded from a capture-shape preset chosen by the agent at start — session (the standard 11-section retrospective) or spec (a lighter six-section template focused on the spec axis). Presets define which sections come pre-seeded; sections are additive, so a session can grow new sections later via scripts/promote_to_session.sh (spec → session widen) or by starting with --with-spec-axis (session preset with the spec axis included). See workflows/start-session.md for the decision rule.
Entry points — pick one and load that workflow
- First time in a project → workflows/bootstrap-memory.md. Check for
project-memory/_CONTEXT.md; if missing, bootstrap before anything else. - Starting a new mission → workflows/start-session.md. Pick
--mode=sessionfor open-ended work or--mode=specwhen implementing a written specification; pass--with-spec-axisfor gray-zone missions that mix the two. The workflow page has the full decision rule. - Mission drifted past the spec mid-session → workflows/start-session.md#if-drift-happens-mid-session. Run
scripts/promote_to_session.shto widen the file additively — preserves all spec-axis content, adds the standard sections. - Mid-session notable moment (steering, frustration, win, takeaway) → workflows/capture-moment.md.
- Mission ending → workflows/wrap-up-session.md.
- User asks about prior work ("have we seen this", "what did we learn about X") → workflows/query-memory.md.