A short, enforceable closing discipline for agent and coding sessions. Run it when you finish meaningful work so the next session — or your teammate, or you in two weeks — starts warm instead of cold.
Closing without writing anything down is how context dies: the next session re-derives what you already knew and repeats mistakes you already solved. This skill is the fix — five durable artifacts + one habit, doable in a couple minutes.
Six steps (full detail in SKILL.md):
- Session memory — a dated prose file: what happened and why.
- Handoff — a short
HANDOFF.mdthe next session reads first. - Resolve dirty state — commit / revert / hold; never ambiguous.
- Completion signal — emit it, then verify it landed (don't trust exit codes).
- Enforce it — a hook that fires if you skip the close (the part that makes it stick).
- Final report — print the real file paths you wrote.
The irreducible core for a solo project is just step 1 + clean git; add the handoff and enforcement the moment a second session or a teammate appears.
# Claude Code (user-level skills)
git clone https://github.com/jeremyknows/session-end ~/.claude/skills/session-endOther agents: clone anywhere and point your skills loader at the directory, or just
copy the six steps from SKILL.md into your own workflow — the discipline is
runtime-agnostic.
- Claude Code: invoke
/session-end(or say "wrap up") at the end of a substantial session. For automatic enforcement, add the copy-paste Stop hook fromreferences/adapting-to-your-runtime.md. - Any other runtime: follow the six steps in
SKILL.md; wire steps 4 and 5 using the per-runtime examples (CI, git pre-push, cron, plain log file) in the adapting guide.
| File | What it is |
|---|---|
SKILL.md |
The spec — the six-step discipline + gotchas |
references/scorecard.md |
8-point "is the close complete?" checklist + a filled-in worked example |
references/adapting-to-your-runtime.md |
How to wire steps 4 & 5 on Claude Code / CI / git / plain setups (+ a full multi-agent example) |
LICENSE |
MIT |
MIT — see LICENSE.