EricTechPro/super-board

super-board

Add tasks, walk away, get merged PRs with proof.

8 skills (5 you type, 3 the board runs) · 9 commands · 6 guard hooks

🌐 Live site: erictechpro.github.io/super-board

Install · Quick start · How it works · Skills · Commands · Guards

_{The skill map. Click it for the live version: zoom, pan, open any node.}

Install

In your project folder:

curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash

Or as a Claude Code plugin:

/plugin marketplace add EricTechPro/super-board
/plugin install super-board@super-board

[!NOTE]

The plugin ships the skills only. Run /super-board:super-board onboard and its 🔍 Checks step adds the guard hooks, scripts and workflows. Needs Claude Code, gh, jq, bash 3.2+ and Python 3.9+; the installer checks.

Quick start

1. Install

curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash

2. Onboard

/super-board onboard

Checks · GitHub · Board · Branch · AGENTS.md · Policies · Bug sources · Review. Enter takes the recommended answer.

3. Run

/super-board run my-app

Add cards to Ready. The board drains on its own.

How it works

▶ Watch on YouTube: I Built a Self-Improving Software Factory

Skills

8 skills (5 you type, 3 the board runs). Uses Matt Pocock skills, ponytail, impeccable and humanizer.

You type — 5 skills

| Skill | What it does | |---|---| | /super-board | Orchestrator: plans waves, runs Build → QA → Review, merges when green. | | /super-collect | Finds problems (Sentry, PostHog, issues, PRs, architecture) and files verified Backlog cards. | | /ui-refine-loop | Critique → refine loop that polishes one page or component. | | /visual | One HTML page: branch recap, plan, or codebase map with diagrams. | | /git-sync | Commit per logical change, merge-pull, push without force, report. |

The board runs — 3 lanes

| Skill | What it does | |---|---| | /super-build | Builder lane: worktree, smallest safe change, tests, draft PR. | | /super-qa | Tester lane: evidence, test-gap check, screenshots, or bounce to Build. | | /super-review | Reviewer lane: own hypotheses, remembers prior findings, merge gate. |

Each name links to that skill's README. Adding a skill? Write its SKILL.md and README.md, add a line to skills/families.json, and this table updates itself.

Commands

/super-board onboard          # 8-step setup, resumes
/super-board lint             # vague ACs?
/super-board status           # read-only snapshot
/super-board run        # drain the board
/super-board stop             # stop workers
/super-collect [source]       # file problems to Backlog
/ui-refine-loop        # polish one page
/visual [recap|plan|path]     # one HTML page
/git-sync                     # commit, pull, push

Flags: run --low|--high · run --codex[=] · super-collect --since 30d

Guards & hooks

Run automatically once installed. Python stdlib, JSON in, JSON out.

| | | | --- | --- | | guard-worktree-path | Blocks git worktree add outside .claude/worktrees/ | | guard-secrets | Blocks reading or piping dotenv files, SSH keys and credential files; key names via super-board-env-check.sh | | guard-key-literals | Blocks a live-looking API key written into a file; flags one already there | | guard-delete-outside | Blocks rm, find -delete and git clean aimed outside the project, ~ or / | | guard-protected-push | Opt-in (onboard asks, or install.sh --protect-main): blocks direct and force pushes to main/master/base | | README sync | Regenerates the skill table; pre-commit and PostToolUse hooks keep it fresh | | cleanup-wt | Removes merged worktrees and branches after each merge and at session start, with a recovery file | | merge gate | Merges only after the current base plus your verify_commands pass, pinned to the reviewed commit; applies merge_policy and runs allowed DB migrations |

Models

A cheap router grades each card easy, medium or hard first; the run flag picks the model for each grade. With --codex, every lane runs on Codex GPT models instead of Claude.

| Command | Router | Easy card | Medium card | Hard card | | --- | --- | --- | --- | --- | | /super-board run | Haiku 4.5 | Sonnet 5.5 | Opus 5.5 | session model | | /super-board run --low | Haiku 4.5 | Haiku 4.5 | Sonnet 5.5 | Opus 5.5 | | /super-board run --high | Sonnet 5.5 | Opus 5.5 | Opus 5.5 | Opus 5.5 | | /super-board run --codex | gpt-6-luna | gpt-6.1-sol | gpt-6.1-sol | gpt-6-astra | | /super-board run --codex --low | gpt-6-luna | gpt-6-luna | gpt-6.1-sol | gpt-6.1-sol | | /super-board run --codex --high | gpt-6-luna | gpt-6-astra | gpt-6-astra | gpt-6-astra |

/super-board run --codex= pins one model for every card and skips the router.

Run inside Codex? plain /super-board run switches to the Codex ladder by itself. Codex has no /super-board command: it finds skills in .agents/skills/ (symlinks followed), so link .claude/skills/super-board there and type $super-board run.

Writing standard

Commits, tickets, PR bodies and comments all follow one writing standard, in the pack and in every project it is installed into.

Credits

MIT © Eric Tech (LICENSE). Built on obra/superpowers, mattpocock/skills, BuilderIO/skills and tt-a1i/archify.

---

Live site · Skill map · Writing standard · Setup simulator · Impeccable map · Release notes · Release checks · YouTube walkthrough

_{Made by Eric Tech}