nguyenthienthanh 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 + ID → load.
Handoff Flow
- Save to
.claude/logs/runs/[id]/run-state.json: workflow_id, status, current_phase, agents, phases_completed (with deliverables), key decisions, token_usage - Output: workflow ID, phase progress, deliverables, resume command
Resume Flow
- Load state file → validate exists/valid
- Restore: project context, agents, phase rules, decisions
- Show summary → continue from saved phase
Auto-Save
Phase completion, every 5 min, token milestones (100K/150K/175K). Silent except warning thresholds.
TOON State Format (~160 tokens vs JSON ~600)
workflow:
id: AUTH-1234
phase: 3
status: in_progress
agents[2]: architect,tester
Error Handling
Not found → show available, suggest /run. Corrupted → restore from .backup.json.
Cleanup
Completed: 30 days. Cancelled: 7 days. Paused: indefinitely.