| name | done |
| description | Close out a work session: write a short HANDOFF.md snapshot so the next session picks up where this one left off. Run at the end of any substantive session. |
Done — end-of-session handoff
Close out this session. Plain Write tool only — no scripts, no state files, no routing logic. Everything stays in the current folder.
-
Summarize the session from the conversation: what we worked on, where it stands, what was decided, and the next concrete steps.
-
Overwrite ./HANDOFF.md — it's a snapshot, not a log, so replace the whole file. 30 lines maximum, exactly these sections:
# Handoff — <project>
## Status
## Next steps
- [ ] <one concrete step a fresh session could start on without asking questions>
## Key files
## Decisions
A few short lines per section. Next steps are checkboxes, most important first; leave finished items out. Key files = the handful of files the next session should open first.
-
If ./SESSION_LOG.md exists, also append a dated entry of 3–6 bullets — what happened this session. Append at the end; never edit earlier entries. (If the file doesn't exist, skip this — don't create it.)
-
End by telling the user: "Next session, open this folder and I'll read HANDOFF.md to pick up where we left off."
