phase-handoff

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.