Goal: nothing from this session is lost. The next session starts with full context.
- Ask ONE question: "Paste or dictate everything from this session: what you did, learned, broke, decided{{SPENT}}, and what's next." Accept messy notes.
- File each piece in the area it belongs to (see "Where things live" in CLAUDE.md). Create new files from the area's _template.md; append dated entries to existing ones. If a piece fits no area, ask; do not invent a folder.
- Update shared files:
- decisions.md: any choice made, with the reason {{LEDGER_LINE}}
- projects/now.md: "Where I stopped", "Next step", tick off must-dos, park new ideas
- If something broke or Claude repeated a mistake, add one line to "Common pitfalls" in CLAUDE.md: what broke -> rule, status [happened]. If a seeded pitfall really happened, change it to [happened].
- Before filing "X lives in Y" or a status, check Y still exists and matches. Fix or flag stale notes.
- If I stated a new rule ("always...", "never..."), ask where it goes (CLAUDE.md or a rules file). Keep CLAUDE.md under 150 lines.
- Never invent. Missing = "unknown", listed for me.
- End with 5 lines: files changed, open questions, the one next step.