session-continuitylisted
Install: claude install-skill talgolan/session-continuity
# Session Continuity
Four in-repo files plus GitHub Issues act as a handoff between Claude sessions on the same project:
- **`.session-continuity/SESSION_PRIMER.md`** — thin hard-template snapshot (Boot order, Mid-flight, Confirm, Peers). **Refresh Mid-flight + Confirm alongside substantive commits** (stage the update in the same commit as the real change). Never embed a `git log` dump — freshness is `primer-freshness.sh`.
- **GitHub Issues labeled `backlog`** — explicitly deferred follow-ups and decisions (not current state). Identity is `#N`. Title + 1-3 sentence length cap per issue — anything longer moves to a linked file under `meta/superpowers/`. Close with `gh issue close N --reason completed` once the code shows it shipped.
- **`.session-continuity/ROADMAP.md`** — strategic direction: Now/Next/Later. Freeform — no numbering, no permanence rules, no length cap. Rewritten wholesale as direction changes.
- **`.session-continuity/PROJECT_CONTEXT.md`** — stable repo context (layout, module table, workflow conventions, test expectations, "where to look for what"). Changes rarely — only when the project's shape itself changes.
- **`.session-continuity/LEARNINGS.md`** — accumulated wisdom (numbered entries, grouped by layer). Append-only log of bugs that were painful enough to not want to rediscover. **Update when a bug takes 15+ minutes to diagnose.**
These are complementary: primer is volatile current-state, GitHub Issues capture explicitly deferred work, ROADMAP capture