burndownlisted

# $burndown - Bounded Epic-Completion Loop (Codex Native) > **Quick Ref:** Drive a finite target (epic / set of epics / explicit bead list) to every in-scope bead merged on `main`, one bead per cycle, then STOP. The terminating counterpart to `$evolve` (open-ended). Output: merged PRs + a completion report. **You must execute this workflow. Do not just describe it.** ## When to use which | You want… | Command | |---|---| | Drive *this specific* epic/set to completion, then stop | **`$burndown`** | | Always-on, whole-repo improvement (no finish line) | `$evolve` | | One-shot **parallel** fan-out of an epic into worker waves | `$crank` | | Define/validate the PROGRAM.md contract | `$autodev` | | One bead, full lifecycle, once | `$rpi` | `$burndown` is **serial and resumable** (one PR in flight); `$crank` is **parallel and one-shot**. ## Invocation ```bash $burndown <epic-id> # drive the epic to merged, then stop $burndown <epic-id> --max-cycles=20 # cap bead-cycles $burndown <epic-a> <epic-b> # finite set of epics $burndown --beads ag-x.1,ag-x.2 # explicit bead list $burndown <epic-id> --hold-merges # open PRs, leave green for operator ``` The **target set** = transitive in-scope (non-closed) beads of the arguments, fixed at start. It is the loop's definition of "done." ## Per-cycle algorithm (idempotent) Each firing does ONE of: merge an outstanding PR, finish, or advance one bead. 1. **Reconcile in-flight.** `git worktre