← ClaudeAtlas

session-memorylisted

Persistent memory and session-handoff protocol for Fable sessions. Maintains a decision log (why choices were made), a working notes file (current state of play), and a defined boot/handoff sequence so a fresh context window resumes work without re-deriving past reasoning. Use at the start of any session on an existing project, whenever an architectural or contract decision is made or reversed, whenever a review-loop or qa-loop ruling constrains future work, when context is running long and compaction is near, and at the end of any working session. Also use when the user asks to "pick up where we left off", resume, or continue a project.
Caelumca/claude-codex-skeleton · ★ 0 · AI & Automation · score 62
Install: claude install-skill Caelumca/claude-codex-skeleton
# Session memory: decisions, notes, handoff Context windows end; projects don't. This skill defines the three files that carry state across resets and the exact protocol for writing and reading them. The principle is the article's structured note-taking: persist outside the window, pull back in on demand — and keep what's persisted *distilled*, because these files are read at every boot and compete for the same attention budget as everything else. ## The two memory files **One fact, exactly one home.** The system has several memory surfaces, and the same fact written to two of them will eventually disagree. The routing rule: **CLAUDE.md** (if the project has one) holds what doesn't change — stack, commands, house rules; **`decisions.md`** holds *why*; **`working.md`** holds *now*; **skills** hold *how to work*; **`.briefs/`** holds what each lane was told. Before writing anywhere, ask which of these the fact is — and if it already lives elsewhere, link, don't copy. ### `.notes/decisions.md` — why things are the way they are Append-only log of rulings that constrain future work. A decision earns an entry when reversing it later would be expensive or when a future lane could plausibly contradict it. That means: - Architecture choices and the alternatives rejected, one line each on *why not* — the rejected options are the valuable half; they stop the same debate from re-running in a fresh context. - Contracts frozen: schemas, signatures, invariants that briefs will cit