crew-handoff git:20260929.b7001cdA

Immutable. This exact content never changes and is served at /api/v1/blob/590e5e3fe1560ccd.

---
name: crew-handoff
description: Session handover — SESSION_STATE.md + /clear suggestion.
metadata:
  kind: command
---
# /crew-handoff
applies the `handoff` skill:
1. Read the measured fill: the `🔋 Session` line, or `bash .claude/hooks/context-usage.sh --verbose` (Bash tool, not PowerShell).
2. Write an actionable handover to `docs/SESSION_STATE.md`: Done · In progress (exactly where) · Next step · Open decisions · File pointers · Blockers.
3. Preserve decision rationale; the next session should not start from scratch.
4. **Cold-reader pass** (`handoff/references/cold-reader.md`): the questions are written from the work BEFORE the
   file, then answered from the file alone. Anything unanswerable goes back into the handover and is re-checked.
5. Once written — and only once every question is answerable — suggest `/clear`.