/pause - Session Handoff

Capture ephemeral session reasoning into durable artifacts so the next session can resume without wasting time on context reconstruction. task_plan.md records WHAT tasks exist; this skill captures WHY the current session chose a particular approach, what it rejected, and what it planned to do next.

Two output files serve different audiences because each addresses a distinct use case:

• HANDOFF.json — machine-readable, consumed by /resume-work for automated state reconstruction. Must always be produced to enable /resume-work routing.
• .continue-here.md — human-readable, for users who want to understand session state without starting a new session. Must always be produced to support human-only resumption paths.

Skipping either file breaks half the use case: without the JSON, /resume-work cannot detect handoff state automatically; without the markdown, users cannot quickly grok where things stand.

Instructions

Phase 1: GATHER

Goal: Collect all state needed for the handoff.

Step 1: Read CLAUDE.md

Read and follow the repository CLAUDE.md before any other operations because it establishes conventions for the current project that may differ from defaults.