super-board — autonomous GitHub Project pipeline

SkillDev tools

GitHub-Project-driven autonomous pipeline. Five verbs, onboard, lint, status, run, stop, that take a Project board from empty to drained across Build → QA → Review → Done lanes (labels qa · bug · feature route each card), with graceful shutdown / resume. Use when the user says "super-board", "/super-board", "drain my GitHub project", "set up the autonomous loop", "kick off the headless build/QA pipeline", or "stop super-board".

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the super-board skill

What this skill tells your AI

The instructions your AI receives, as published by erictechpro/super-board in skills/super-board/SKILL.md and read by ahel’s review.

Five verbs

VerbWhereWhat it does
super-board onboardinteractiveone-time setup wizard; writes .claude/super-board/configs/<slug>.json
super-board lintinteractivewalks active-pipeline issues, flags vague ACs, runs pre-flight readiness
super-board statusinteractive (read-only)snapshot of active config, column counts, in-flight workers
super-board runin-session (default)the autonomous loop: waves of the super-board-wave dynamic workflow, run from this session (worker_backend: "claude-p" opts into the legacy headless runner .claude/bin/super-board-run.sh). Also the resume command — state lives on the board, not in process memory. Accepts a model-tier flag: --low (haiku/sonnet/opus ladder), default = medium (sonnet/opus/session), --high (opus/session — strongest models only).
super-board stopinteractivegraceful shutdown: posts "stopped mid-flight" comments on every in-flight issue + PR, releases assignee mutexes, kills workers + dispatcher. Next super-board run resumes.

If invoked with no verb, ask which one.

Routing

If user saysLoad
super-board onboard ...references/onboard.md
super-board lint ...references/lint.md
super-board status ...references/status.md
super-board run ... (default — worker_backend unset or "workflow")references/run-workflow.md (lane lifecycles still come from references/run.md)
super-board run ... with config worker_backend: "claude-p" (legacy, explicit opt-in)references/run.md
super-board stop ... / "stop the run" / "pause the loop" / "kill super-board"references/stop.md
"resume" / "pick up where I left off" / "restart after stop"references/stop.md (resume = run; no separate verb)
Anything about Blocked exits, 🙋 needs you, or dropping a cardreferences/block-template.md
Config structure questionsreferences/config-schema.json
Worker gh-call discipline / rate-limit recoveryreferences/rate-limit-etiquette.md (+ scripts/super-board-gh-guard.sh)

Orchestrator vs worker — the cardinal rule

super-board is an autonomous trader. The interactive Claude session that invokes any of the five verbs is an orchestrator, not a worker. The orchestrator:

  • Validates preconditions, then dispatches per the config's worker_backend: "workflow" (default) → stay in-session and run the wave loop in references/run-workflow.md (launch workflow, reconcile, repeat); "claude-p" (legacy, explicit opt-in only) → nohup .claude/bin/super-board-run.sh, report PID + log path, exit. In both backends the orchestrator never does product work itself.
  • Delegates all build / QA / review work to workers — headless claude -p (claude-p backend) or workflow lane agents (workflow backend).
  • Must NOT do product work itself, must NOT patch the dispatcher mid-run, must NOT wait for workers, must NOT hold context for multi-card progress.

If anything goes wrong during a run, the orchestrator captures the symptom and reports back — it does not silently expand the task into a fix. See references/run.md "Orchestrator delegation contract" for the full rule.

Signals

GitHub stars
30
Forks
12
Last commit
Oct 2026

ahel review

  • K4binfo
    destructive-scoped (in references/config-schema.json)
  • K1binfo
    installs-packages (in references/onboard.md)

Automated review, not a security audit. Ruleset v1+k2.

Advanced
Item type
skill
Key
super-board
Source
github.com/erictechpro/super-board