handoff-preparelisted

# Handoff Prepare Capture the current session into a handoff file a fresh session can resume from. ## Scope — writing the file is the entire task - Write the handoff. Nothing else. - Do **not** start, finish, fix, tidy, or commit work you notice while gathering. Unfinished work goes in `next-steps`, not into the working tree. - Do **not** re-run tests, re-read files you already know, or re-verify the handoff after writing it. (Confirming a `path:line` you're about to cite is fine — a wrong line number costs the next session more than the lookup costs you.) Report what this session actually established; mark anything unverified as unverified. - Resuming is a separate, explicit step the user takes: they start a fresh session (/clear), then run /handoff-continue. Never claim the context was cleared — only the user can do that. ## Workflow 1. **Gather from the conversation, not just the disk**: goal, what was done and why, dead ends, what broke, what's open. The diff is on disk; the reasoning only exists in this context — that is the part worth saving. 2. **Git state** — only if a git repo: `git status --short` and `git log --oneline -5` (single commands, no pipes). Otherwise skip. 3. **Write the file** to `.handoff/{timestamp}-{slug}.md` in the format below. - `mkdir -p .handoff/` first. Timestamp: `date +%Y%m%d-%H%M%S`. Slug: 2-4 distinctive kebab-case words (/handoff-continue matches on it). - Project-local dir, not system temp — the path must survive the reset. 4.