EricTechPro/super-board / skills/super-build
super-build
VerifiedBuilder lane of the super-board pipeline — takes a `Ready` GitHub Project card into its own per-issue git worktree, makes the smallest safe change test-first (TDD, `ponytail` simplest-first, official docs first for third-party APIs, upgrades and auth/billing), opens a draft PR and hands it to QA and Review through the board; it never merges — merges go through the Reviewer's merge gate. Inside `super-board run` it runs as a lane agent in the in-session wave workflow (`workflows/super-board-wave.js`, no worker cap unless `max_workers` is set); standalone headless `claude -p` dispatch is legacy opt-in. Use when the user says "Super Build", "run the build loop", "/super-build", or invokes the skill.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.8 KB |
| SKILL.md | skill md | 21.9 KB |
| references/decision-policy.md | markdown | 11.5 KB |
| references/worker-preamble.md | markdown | 9.0 KB |
| scripts/super-build-dispatch.shexecutable | script | 7.8 KB |
README.md
View on GitHub# /super-build
The Builder: turns a `Ready` card into a branch, the smallest safe change, tests and a draft PR.
## What It Does
- **Works in its own git worktree** on `issue-<N>-<slug>`, and picks up an existing branch if a stopped run left one.
- **Routes skills by the card's type label**: `bug` → `diagnosing-bugs` + `tdd`, `feature` → `implement` + `tdd` + `codebase-design`, `refactor`/`tech-debt` → `codebase-design` + `tdd`, `docs` skips `tdd`. A `Skills:` line in the card overrides the row.
- **Simplest solution first**: runs `ponytail:ponytail` before the first line of code, or an inline ladder when the plugin is absent. Validation, security, data-loss protection and accessibility are never cut.
- **Reads official docs first** when a card touches a third-party API or SDK, an upgrade, or auth/billing, and lists them as `Docs:` bullets in the PR's Solution block.
- **On a rebuild** it fixes every `[builder]` review thread and the Tester's latest failure, and fixes the code, not just the thread.
- **Never merges.** Merging belongs to the Reviewer and the merge gate.
## When To Use It
- Inside a super-board run (the Building lane). This is the normal path.
- Standalone, as `/super-build` (legacy, opt-in), to drain the `Ready` column of a project with headless `claude -p` workers (3 at a time unless `max_workers` is set); each finished branch becomes a PR and its card moves to `QA`.
## Standalone flags
| Command | Does |
|---|---|
| `/super-build` | Process every `Ready` issue in board order |
| `/super-build --only N` | Execute only issue #N |
| `/super-build --dry-run` | Print the dispatch plan, change nothing |
## Install
Part of the super-board pack: `./install.sh /path/to/project`. Lane details: `skills/super-board/references/run.md` → Builder.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |