What problem does it solve?
cy-codex-loop solves the problem of reliably running long, multi-step Compozy techspecs across many agent restarts without losing progress, by detecting the current phase from durable state and the filesystem, executing exactly one phase action per iteration, and producing an atomic git checkpoint after each Phase B completion.
Core Features & Use Cases
- Resumable iteration driver: Detects the next phase (bootstrap, execution, QA, done) from
state.yaml plus .compozy/tasks/<slug>/ truth, then runs one deterministic action and stops for the next restart.
- Two execution modes: Runs task-by-task in
mode=tasks, or advances deliverables via time-bounded slices in mode=free, keeping a checklist-backed progress model.
- Durable memory + inspectability: Updates
state.yaml only via the provided scripts and writes workflow memory through cy-workflow-memory using the shared and per-iteration memory paths.
- Atomic git checkpoints: After each completed Phase B iteration, commits the resulting work via
commit-checkpoint.py so completed tasks/slices become restorable snapshots.
- Optional frontend/docs delegation lane: When the goal signature contains
delegation=frontend-docs, qualifying Phase B work can be delegated via compozy exec with strict no-commit and explicit cy-final-verify PASS evidence requirements.
Quick Start
Use the cy-codex-loop skill for a feature slug that already has a .compozy/tasks/<slug>/_techspec.md and either _tasks.md + task_*.md files (for tasks mode) or no task graph (for free mode).