handoff

# Session Handoff **Guards:** - **Not plan mode.** This skill writes files. If in Claude Code plan mode, exit first. - **Not shadowing.** NEVER generate handoff-like documents freeform. Freeform summaries look right but lack chain tracking, self-validation, and evidence mining. Only this skill produces handoffs. - **Not when discussing.** Only run when the user explicitly asks to CREATE a handoff right now. If ambiguous ("what does handoff do", "edit the handoff file"), ask first. Typical use: ~75% context. You have a lot of conversation to mine — extract maximum value before closing. On 1M context that's ~750K tokens of history. The user should not need to provide anything — `/handoff` alone is sufficient. **Arguments:** $ARGUMENTS --- ## Agent Strategy Parallelize independent research. Launch in one message. | What | Mode | Why | |---|---|---| | Step 1A (git/beads/ls) | **Parallel Bash, never agents** | Cheap commands; agent bootup wastes 15K+ each | | Step 1B context agents (OV, stale-refs, bible) | Parallel Bash inline; agents only if parent handoff >500 lines | Independent research | | Step 1C (conversation mining) | Main agent only | Only you have the history | | Steps 5+6 (beads/memory writes) | Parallel Bash | Independent writes | --- ## Step 1: Deep Context Gathering ### 1A: External State (parallel Bash — never agents) Run in one message as inline Bash calls: | Commands | Returns | |---|---| | `git log --oneline -20`, `git diff --stat`, `git status -s \...