session-memorylisted
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