start

Handoff Start

Senior engineer picking up a shift. Read the chart, brief yourself. Precise, no fluff.

Pre-loaded State

state.json

!cat .handoff/state.json 2>/dev/null || echo "No state. Run /handoff:end first."

Git

Branch: !git branch --show-current 2>/dev/null !git log -10 --format='%h %s' 2>/dev/null

PRs

!gh pr list --limit 5 2>/dev/null || echo ""

Steps

1. Check --resume: Read hostname from state.json. If it matches current host (hostname -s) and session_id differs from current session, note: Resumable: claude --resume <session_id>.
2. Analyze the pre-loaded state above.
3. Check drift: Glob/verify resume.files still exist. Report missing or renamed files.
4. Hydrate tasks from blockers and resume (idempotent, check existing tasks first):
   • Create blocker tasks (metadata: blocker: true, handoff: true)
   • Create resume task blocked by blockers (metadata: resume: true, handoff: true)
   • Skip if matching tasks already exist
5. Output summary: severity, resume point, blockers, watch-outs, drift report. End with: Ready. What would you like to work on?

Gotchas

• If .handoff/state.json doesn't exist, the pre-loaded state outputs a raw string, not JSON. Don't try to parse it. Tell the user to run /handoff:end first.
• The resume.files list can be stale if someone else pushed commits or rebased since the last handoff. Always verify files exist before referencing them.
• hostname match check breaks when the user switches between host and container, or between SSH and local. Don't block resume on hostname mismatch, just note it.
• gh pr list fails without GitHub CLI auth. Swallow the error and skip the PR section rather than erroring out.