handoff

# Session Handoff Two-mode skill: **Save** state at end of session, **Resume** state at start of next session. ## Mode: Save Save current session state for later resumption. This is the **end-of-session boundary** skill — for mid-task rollback points before risky operations, use `/checkpoint`. ### Usage ```bash bun ~/.claude/src/scripts/handoff.ts create ``` Or use the native command: ``` /handoff ``` ### What Gets Saved Every handoff — auto or manual — always captures real, git-derived data at creation time: - **Project**: name, path, current branch - **Pending changes**: `git status --porcelain` (first 20 lines) - **Key files**: uncommitted paths **union** the files the session ledger observed being changed (see below) - **Recent commits**: subjects of the last 3 commits - **Source**: `manual` or `auto` (see below) Plus three sections built purely from **observed** tool activity, not inference: - **Files Modified** — every path a `Write`/`Edit`/`NotebookEdit` touched - **Files Read** — every path a `Read` touched - **Tool Failures** — the exact tool name and error string, bounded and secret-redacted These come from the session ledger, a bounded JSONL at `~/.claude/tmp/session-ledger/<session_id>.jsonl` written by the `PostToolBatch` hook. It exists to fix a specific hole: **`git status` forgets everything you committed.** A file edited at the start of a long session and committed an hour later is invisible to a `git status`-only handoff, so the longer the sess...