AI-consumed reference. Optimized for Claude to read during execution. Human-readable explanation: see docs/architecture/HIERARCHICAL_PLANNING.md or docs/getting-started/ depending on topic.

Session Continuation

Manage workflow state across sessions.

Triggers

Token ≥75% → suggest handoff. User says handoff/save → execute. User says resume + name/ID → load.

Handoff = one file per session, named after the session

.claude/handoffs/<name>.{json,md} — <name> = slug of the session title: /rename custom title → auto (ai) title → session-<id8>. Two sessions in one project never overwrite each other; a same-title clash gets -<id8>.

Handoff Flow (user says handoff)