REMvisual/claude-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

### Compact mode

# Handoff Plan

**IMPORTANT: This skill writes files. You MUST NOT be in Claude Code's built-in plan mode.**
If you are currently in plan mode, **exit plan mode first** (use ExitPlanMode) before proceeding. This skill produces plan *files* — it does not use Claude Code's plan mode feature. They are different things.

**Step 1: Run `/handoff` to create the data file — FULL TWO-PHASE PROCESS.**

Execute the full `/handoff` skill first, including the **mandatory two-phase write process**:
- **Phase 1:** Write the handoff file (all sections, narrative + evidence)
- **Phase 2 (MANDATORY for Deep and Chunked passes):** Read it back, scan conversation for uncaptured data, use Edit to expand toward the ceiling (800 lines for 1M context)

This is not optional. The handoff is the data store — a thin handoff produces a thin plan. Follow the handoff skill's mining-pass detection, line count checks, and gap research pass exactly as specified.

**Do NOT skip or abbreviate the handoff.** Do NOT skip Phase 2. If the handoff is under 500 lines on a Chunked pass, you haven't mined deep enough — go back and expand before writing the plan.