What problem does it solve?
devflow phase-handoff prevents agents from continuing with stale or mixed context by capturing a deterministic frozen state at phase boundaries and starting the next phase in a clean session.
Core Features & Use Cases
- Freezes phase state to disk: Writes
.devflow/state/<branch>/ with the current phase snapshot so the next session has an explicit, read-only entry point.
- Marks progress in the current session: Uses
mark_chapter (when available) to label the phase you’re leaving and sets a terminal title when possible.
- Spawns the next phase deterministically: Gates the handoff behind a one-click user confirmation, then uses
mcp__ccd_session__spawn_task to create a new Claude Desktop sidebar session with a stable, tool-triggerable slash command.
Quick Start
In the current phase, run phase-handoff for your branch by providing --phase and --next-phase so it writes the frozen-state file and spawns the next-session with the correct first-line slash invocation.