Run
Router. Drives the project forward by repeatedly picking the next action from project.md and handing off to the appropriate skill.
Preconditions
project.mdexists. If not, hand off to brainstorm to draft one.
Procedure
Read state. Open
project.md. Parse the Pending Work section into a list of items withslugandstatus.Pick the next action.
- If any items have
status: done, hand off to save-work to persist them before doing anything else. Batching in one call is fine. - Else if any item has
status: ready, pick the first one and hand off to do-work with that slug. - Else if any item has
status: pending-plan, pick the first one and hand off to plan-work with that slug. - Else if any item has
status: needs-input, stop and ask the user to resolve it. - Else (no actionable items) stop and hand off to brainstorm.
- If any items have
After the handoff returns, re-read
project.mdand loop back to step 2. Stop when:- There is nothing actionable, or
- The user has interrupted, or
- The same item failed twice in a row (avoid tight failure loops — surface to the user).
Status conventions
| Status | Meaning | Next skill |
|---|---|---|
pending-plan |
Goal known, no detailed plan yet | plan-work |
pending-review |
Plan written, awaiting review-plan | (handled internally by plan-work) |
ready |
Plan approved, ready to execute | do-work |
in-progress |
do-work is running | (skip; do not re-enter) |
done |
Work and review complete | save-work |
needs-input |
Blocked, requires user input | (stop and ask) |
Out of scope
This skill never modifies project.md or work READMEs directly. It only reads state and dispatches.