Workflow State Management Skill

Overview

Manage persistent workflow state that survives context auto-summarization.

State files store: task details, worktree locations, PR URLs, and review status.

Triggers

Activate this skill when:

• Starting a new workflow (/exarchos:ideate)
• Transitioning between workflow phases
• Restoring context after summarization (/exarchos:rehydrate <featureId>)
• Saving progress for later continuation (/exarchos:checkpoint)

Phase Transitions

Valid transitions, guards, and prerequisites for all workflow types are documented in references/phase-transitions.md. CRITICAL: Phase mutation is a separate action from field mutation. When a transition has a guard, action: "update" the prerequisite fields first, then action: "transition" — guards read the most recent state, so updates land before guards evaluate. Attempting to mutate phase via action: "update" returns a RESERVED_FIELD error pointing at transition (see "Reserved fields" below).