Guides

Your first run

A real story start-to-finish: clone, init, start, watch, ship. With the actual artifacts each phase writes.

Multi-story program

Going beyond a single feature: writing a program intent, reviewing the roadmap, and watching stories ship in DAG order.

Brownfield upgrade

Migrating an existing system safely. Audit → plan → migrate one PR at a time with rollback gates.

Handling escalations

What to do when the agent gives up: reading the failing artifact, editing it, and resuming.

Cost control

Model tiering, escalation gates, and the cost-estimate command — how to keep token spend predictable.