What problem does it solve? When an AI coding session is cleared, compacted, or restarted, all working context—task intent, decisions, failed approaches, and verbal instructions—is lost. This Skill captures that state in a HANDOFF.md file so the next session can resume work as if the interruption never happened. ## Core Features & Use Cases - Write mode: Dumps a structured HANDOFF.md at the project root covering task, state, decisions, dead ends, next steps, and standing user instructions, then excludes it from git via .git/info/exclude. - Resume mode: Reads the handoff, verifies branch and SHA against current repo state to detect drift, consumes the file by renaming it to HANDOFF.md.read, and continues the work. - Automatic mode detection: With no argument, infers write vs. resume from whether an unconsumed HANDOFF.md exists at the project root. - Use Case: Before ending a long debugging session, run /handoff to record the exact failing test, the two approaches already ruled out, and the next command to try; the next morning a fresh session resumes with full context. ## Quick Start Ask the agent to run /handoff before clearing the context so it writes a HANDOFF.md the next session can resume from.
