handoff

name	handoff
description	Use before running /compact to preserve session context. Generates a structured .handover.md and a ready-to-use /compact instruction so the next session resumes without information loss. Trigger when context reaches ~65-70%. Do NOT use for general summaries or task documentation.

Handoff

Generates a structured handover document before compaction so the next session resumes with full context. Three hooks automate the rest.

Pipeline

Step 1 — Load template Read assets/handover-template.md.

Step 2 — Fill handover Fill every section from the current conversation. Follow each section's guardrail. For Key Decisions: include all decisions made this session, including implicit choices Claude made without explicit user confirmation.

Step 3 — Write file If .handover.md exists in the project root, Read it once, then Write (overwrite). pending in frontmatter must be false at write time.

Step 4 — Output action sequence Extract 3–5 keywords from Key Decisions + Remaining Tasks to form a focused /compact instruction. Show:

━━━ Handover saved → .handover.md ━━━

① /compact Focus on [task]. Preserve: [decision], [decision], [next task].
   Apply compaction rules from .handover.md.

② (PostCompact hook will auto-restore on your next message)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━