handofflisted

# Handoff — Write State Down Before You Lose It Quality degrades as context grows, well before the window is full, and worst for information in the middle of a long session. The model summarising at the end is already impaired by the thing you are trying to escape. So write the handoff **deliberately, while judgment is intact** — not when auto-compact fires. **HARD GATE: this skill writes one file. It does not change code, run tests, or commit.** ## The loop ``` /handoff → writes plans/handoffs/<date>-<slug>.md → tells you: /clear or /compact you → run it /resume-work → reads the newest handoff, you carry on ``` **You run the reset, not this skill.** `/clear` and `/compact` are REPL commands with no tool behind them — no skill can invoke them. Anything claiming otherwise is guessing. --- ## Step 1: Gather state ```bash ~/.claude/skills/handoff/scripts/gather-state.sh ``` Reads branch, status, diff stat, staged stat, recent log, and files touched. If the script is missing, run the equivalents by hand — but prefer the script; it keeps its own output out of context. ## Step 2: Write the file Path is computed in bash, never assembled in the prompt — a title you pass through is untrusted input and the allowlist is what keeps it out of the shell. ```bash ~/.claude/skills/handoff/scripts/handoff-path.sh "<title>" # prints the safe path; use it verbatim ``` Files are **append-only**. Never overwrite an existing handoff, never delete one. Each save