$start-work
Execute a Prometheus plan until every checkbox is done, with durable Boulder progress.
$start-work executes a Prometheus work plan until every top-level checkbox is done. It is the implementation half of the plan-first flow: hand it a plan, and it drives the plan to completion.
Syntax
$start-work [plan-name] [--worktree <absolute-path>]plan-name— optional. The plan to execute (fromplans/<slug>.md). Omit it to use the most recent plan.--worktree <absolute-path>— optional. Run the work in an isolated git worktree.
How it works
- Durable Boulder state in
.omo/boulder.jsonsurvives across turns and sessions, so progress is never lost between runs. - A Stop-hook re-injects the next turn until the plan is complete — the loop keeps itself going.
- Independent sub-tasks fan out to parallel subagents.
- Strict TDD plus five evidence gates: plan reread, automated verification, manual QA, adversarial QA, and cleanup.
- Progress is recorded to a ledger as each checkbox is checked.
Done
When every checkbox is checked, it prints an ORCHESTRATION COMPLETE block.
ORCHESTRATION COMPLETETypical flow
Have a plan ready
Either write one with $ulw-plan or point $start-work at an existing plans/<slug>.md.
$ulw-plan "add OAuth login with refresh tokens"Execute it
$start-work oauth-refresh-tokensIndependent work fans out to parallel subagents; durable Boulder progress survives interruptions.
Wait for completion
$start-work stops only when every checkbox is checked and prints ORCHESTRATION COMPLETE.