---

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.

1. Summarize the session from the conversation: what we worked on, where it stands, what was decided, and the next concrete steps.

2. 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.

3. 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.)

4. End by telling the user: "Next session, open this folder and I'll read HANDOFF.md to pick up where we left off."