super-build

What problem does it solve?

It eliminates the slow, manual process of draining a GitHub Project queue and running issue-by-issue “builder” work across many cards, while keeping merges and issue state updates consistent.

Core Features & Use Cases

• Parallel headless worker dispatch: Executes each curated GitHub Project Ready (or Bug in QA mode) issue as an isolated worker in its own git worktree, with a max-parallel throttle to keep runs efficient and controllable.
• Safe merge-and-close workflow: Merges worker branches back to the base branch, closes the issue on success, and advances the card status to Done.
• Failure handling and human gates: Halts on worker failures or merge conflicts, supports intentional partial progress via WIP-PARTIAL, and requires human handling for human-gated cases.
• Issue contract enforcement: Uses a worker preamble to require correct close/WIP commit formats and to respect acceptance-criterion checkboxes without trying to “game” completion.

Quick Start

Ask your agent to run the build loop by saying: run super-build to execute all GitHub Project cards in the Ready column.