SpecRouter

Ship an SDD AI team
you actually own.

A wizard configures @specrouter-dev — an orchestrator agent that drives the whole HU → SPEC → CODE → QA flow for OpenCode and Claude Code. Plain markdown prompts and skills. You write them, you ship the ZIP, you keep the code.

Every phase transition, every artifact, every gate — visible in a local kanban. No cloud. No account. Just your docs/.

  • No signup
  • Bring your own API key
  • Free during beta
  • MIT licensed
specrouter-output.zip
Inside the ZIP
AGENTS.mdregistry + flow mode
.opencode/agents/specrouter-dev.mdorchestrator (you talk to this one)
.opencode/skills/bootstrap/SKILL.mdentry-point @bootstrap
.opencode/agents/phase-hu.mdphase 1: user story
.opencode/agents/phase-spec.mdphase 2: spec
.opencode/agents/phase-code.mdphase 3: implementation
.opencode/agents/phase-qa.mdphase 4: verification
.opencode/skills/vault/SKILL.mdopt-in: @vault
.opencode/skills/backlog/SKILL.mdopt-in: @backlog
docs/project-context.mdproject facts
.env.exampleAPI key hint
README.mdsetup guide
specrouter-dev.md (excerpt)
# SpecRouter.dev (Orchestrator)

You drive a 4-phase SDD flow. Between phases
you stop and wait for human approval.

## What you load
Each phase is a sub-agent — invoke it as the
orchestrator signals:
- @phase-hu   → docs/user-stories/US-<id>-<slug>.md
- @phase-spec → docs/specs/SPEC-<id>-<slug>.md
- @phase-code → implementation + tests + commit
- @phase-qa   → docs/qa/QA-<id>-<slug>.md (verdict)

## Approval modes (picked in the wizard)
strict · assisted · autonomous · custom

## Opt-in skills you can also load
@vault    — token usage report
@backlog  — capture a product idea

Generates ready-to-use ZIPs for

OpenCodeAvailable today
handle
@specrouter-dev
agents
.opencode/agents/
skills
.opencode/skills/
Claude CodeAvailable today
handle
/specrouter-dev
agents
.claude/agents/
skills
.claude/skills/
CursorRoadmap
CodexRoadmap
KiroRoadmap
Continue.devRoadmap

From blank repo to your AI team in 5 minutes.

Three steps. No GitHub login. No account. No telemetry.

STEP 01

Pick the tool, mode & approval flow

OpenCode or Claude Code. The single-agent orchestrator (recommended) or four separate agents. Strict, assisted, autonomous, or custom approval between phases. The wizard remembers your choices — re-run anytime to iterate.

STEP 02

Customize every prompt & skill

Describe each agent in one sentence. The LLM drafts the system prompt — you edit, accept, or rewrite. Same for skills. Or skip AI and write them yourself. You stay in control of every word in the ZIP.

STEP 03

Download, install, ship

One ZIP with the orchestrator, phase sub-agents, opt-in skills, and project files. Drop it in your repo, add your API key, run @bootstrap. Five minutes from zero to a working SDD team.

One flow, two ways to run it.

Pick the mode in the wizard. You can change it any time by regenerating the ZIP — your custom prompts and skills stay.

Recommended

One orchestrator drives it all

The wizard emits a single agent — @specrouter-dev — that owns the full HU → SPEC → CODE → QA flow. Phase sub-agents are loaded on demand. You talk to one handle, it sequences everything for you, and pauses for approval between phases.

  • Cleanest Tab selector (one agent in your picker)
  • Default in the wizard — most users pick this
  • Works in strict / assisted / autonomous / custom approval modes
  • The orchestrator handles phase ordering and gates for you
Maximum control

Four agents, each with its own gate

The wizard emits four separate agents — @product-owner, @sdd, @coder, @qa. You invoke each one yourself in any order. Every phase is its own hard gate: nothing moves forward until you say so.

  • Full control over the order you run phases
  • Each agent is a separate handle in your Tab picker
  • Approval mode applies independently to each agent
  • Best when you want explicit, per-phase human judgment

Both modes ship with the same approval flow knob — strict, assisted (default), autonomous, or custom. Both ship with the same opt-in skills (@vault, @backlog). The only thing that changes is how many agents you see in your Tab picker.

A customizable alternative to opinionated SDD frameworks.

Most agent tools ship a curated preset and ask you to live with it. SpecRouter ships a generator and a blank canvas.

You define the agents

SpecRouter ships a generator, not a curated preset. Every agent prompt starts blank — or from a starter you can rename, rewrite, or delete. No persona baked in.

You own the prompts

The ZIP is plain markdown. Edit it, fork it, version it in your repo. SpecRouter does not phone home, inject telemetry, or wrap your agents in a proxy. MIT-licensed code, all of it.

You compose the flow

Pick strict gates or relaxed ones. Bundle the optional local dashboard. Add or remove phase sub-agents as your project grows. SpecRouter fits your team, not the other way around.

Built for the people who refuse to rent their tools.

Three audiences. One generator. Zero opinions baked into the output.

Solo dev

Ship with structure, not chaos

You're tired of copy-pasting prompt fragments between projects. Generate a clean SDD flow once, version it in your repo, and re-import it next time.

  • One ZIP you own end-to-end
  • Plain markdown prompts you can grep
  • Bring-your-own key — pay cents, not dollars
Team lead

Standardize without dictating

Every teammate ships a slightly different AI flow. SpecRouter gives you a baseline the team agrees on, with room for each project to diverge.

  • Re-import your edited prompts next sprint
  • Bundle the local dashboard for shared visibility
  • MIT license — no per-seat pricing math
Enterprise / OSS maintainer

Open prompts, open code

Auditable. Forkable. No proxy. SpecRouter generates artifacts you can review line by line and ship to your compliance team without translation.

  • No telemetry, no phone-home, no SaaS lock-in
  • Plain markdown survives any code review
  • Source on GitHub, license is MIT

The handles your team actually types.

Every handle below is a file in your ZIP. Edit them. Commit them. Rename them. They are plain markdown.

Single-agent mode (default)

One handle to talk to. It loads the 4 phase sub-agents itself.
  • @bootstrap

    Initialize project context, then hand off to @specrouter-dev.

  • @specrouter-dev

    The orchestrator. Drives HU → SPEC → CODE → QA, pauses between phases for human approval.

  • @phase-hu

    Phase sub-agent — produces a single user story. Loaded by the orchestrator; you can also invoke directly.

  • @phase-spec

    Phase sub-agent — refines the HU into a technical spec with ordered tasks.

  • @phase-code

    Phase sub-agent — implements the spec with TDD, writes the commit.

  • @phase-qa

    Phase sub-agent — verifies the implementation against the original HU. Closes the flow.

Four-agents mode (legacy, opt-in)

Maximum control. Each phase is a separate handle with its own gate.
  • @product-owner

    Produces the user story (HU) with acceptance criteria.

  • @sdd

    Refines the HU into a technical spec. Independent approval gate.

  • @coder

    Implements the spec with TDD. Independent approval gate.

  • @qa

    Verifies the implementation. Independent approval gate. Closes the flow.

Opt-in skills (any mode)

Shipped in the ZIP, enabled per-skill in the wizard. Each is a separate file you can invoke at any time.
  • @vault

    Reports token usage across the SDD flow's LLM calls (per-phase breakdown + grand total).

  • @backlog <idea>

    Captures a product idea to docs/backlog.md (timestamped, git-tracked).

  • @backlog list

    Reads docs/backlog.md and outputs the pending ideas.

Your SDD flow, finally visible

See every HU, spec, and QA verdict — in one place.

The dashboard shows your SDD flow organized in a kanban that updates as your agents work. Every phase transition, every artifact, every gate — visible at a glance. Runs locally. No cloud. No account. Just your docs/.

Local
Runs on localhost:7777. No cloud, no account, no telemetry.
Zero infra
One Node.js process. One SQLite file. Reuses your existing repo.
Auto-started
OpenCode / Claude Code spawns the server when the agent needs it.
Opt-in
Off by default. Existing ZIPs stay byte-identical to pre-feature behavior.
SpecRouter dashboard kanban view showing pending, approved, in-progress, and done HUs
  • SDD Kanban

    See your HUs move from pending → approved → in progress → done. Every phase transition is visible.

  • Phase Transitions

    Watch your flow progress in real time. Know exactly where each feature stands.

  • Instant Search

    Find any HU, spec, or QA report across your entire project. No more grep.

  • Audit Trail

    Trace every HU to its SPEC, modified files, and tests. Full lifecycle visibility at a glance.

  • Docs as Database

    Reads from docs/ — the markdown you already commit. Zero sync, zero drift.

The dashboard exposes the same data the agents see. To enable, check the “SpecRouter dashboard” box in the wizard's flow-preferences step.

Free today. Fair when we ship Pro.

The generator stays free. Pro funds the hosted features so the open-source core keeps moving.

Forever
Free
$0no card required

The full generator. Both delivery modes (single-agent & four-agents). All four phases. Both tools. Use it as long as you want.

Generate my ZIP
  • Unlimited ZIP downloads
  • OpenCode + Claude Code ZIPs
  • Both delivery modes: @specrouter-dev (default) or 4 separate agents
  • AI-assisted prompt customization (BYO key)
  • Opt-in: @vault, @backlog, local dashboard
  • MIT-licensed, source on GitHub
Coming soon
Pro
TBAjoin the waitlist

For teams that want hosted prompt libraries, shared dashboards, and priority AI refinement.

Join the waitlist
  • Everything in Free
  • Hosted team prompt library
  • Shared dashboard across teammates
  • Faster AI refinement queue
  • Priority support on GitHub issues

No pricing set yet — we will email you when it ships.

SpecRouter is MIT-licensed open source. Read the source on GitHub.

We don't do the usual SaaS things.

Most agent tools hide their hooks behind a marketing page. We'd rather show our work.

Open source, MIT

Source on GitHub. License is MIT. No proprietary hooks, no SaaS-only features, no upgrade wall for the things the generator already does.

No telemetry

We do not track what you generate, what you download, or what you ship. The wizard runs in your browser; the LLM customization step uses your key in memory and discards it.

No vendor lock-in

The ZIP is plain markdown. Edit it in your repo. Fork it. Ship it without us. We win by being useful, not by holding your agents hostage.

Bring your own key

We never see, store, or proxy your LLM API key. Pay your model provider directly — pay cents, not dollars. No middleman markup.

Common questions.

What tools does SpecRouter support?+

OpenCode and Claude Code today. Both consume plain markdown for agents and skills, so the generated ZIP drops in without extra adapters. Cursor, Codex, Kiro, and Continue.dev are on the roadmap — vote on the next one by opening a GitHub issue.

Do I need an account or a subscription?+

No. SpecRouter is a generator that runs in your browser — no login, no signup, no server-side library. You bring your own LLM API key for the prompt-customization step; the key is used in memory and immediately discarded. The generated ZIP is yours.

How is SpecRouter different from Cursor, Kiro, or other agent-configuration tools?+

Most agent-configuration tools ship a curated preset — their authors' opinions baked in — and ask you to live with it. SpecRouter ships a generator and a blank canvas: every agent prompt is yours to define, rename, or delete. No preset persona, no routing rules you didn't pick, no telemetry wrapper around your agents, no SaaS lock-in.

Can I edit the generated agents after downloading?+

Yes — that's the whole point. The ZIP contains plain markdown files. Edit them in your repo, commit them, ship them. The next time you run SpecRouter you can re-import your edited prompts or start fresh.

Will the generator stay free?+

Yes. The generator is MIT-licensed open source and will stay free forever. A Pro tier is on the roadmap for hosted team features (shared prompt library, hosted dashboards, priority AI refinement), but the generator, the ZIP output, and the core flow remain free. Read more on the pricing page.

What does Pro cost?+

We have not set Pro pricing yet — we will email waitlist subscribers when we do. Pro is opt-in only; existing free users keep everything they have today even when Pro ships.

Is my API key safe?+

Yes. Your key is held in your browser's memory only, used for the single customization request you triggered, and never written to disk, sent to our servers, or included in the ZIP. Three independent regression suites verify this — see the security tests in the repo.

Does SpecRouter work offline?+

The generator runs entirely in your browser and works without network access for the UI. The only network call is the optional AI customization step (POST /api/generate-agent), which requires your key and a reachable model provider.

What commands do I get once I unzip the ZIP?+

It depends on the mode you picked. Single-agent (default) ships one orchestrator (@specrouter-dev) plus four phase sub-agents (@phase-hu, @phase-spec, @phase-code, @phase-qa) and the @bootstrap entry-point. Four-agents ships four separate agents (@product-owner, @sdd, @coder, @qa). Both modes can opt into @vault (token usage report) and @backlog (capture product ideas with @backlog <idea>, retrieve with @backlog list).

What's the difference between @specrouter-dev and the @phase-* sub-agents?+

@specrouter-dev is the orchestrator — it owns ordering, gates, and human approval. The @phase-* sub-agents contain the procedures the orchestrator runs (one per phase). You can also invoke a phase sub-agent directly when you want to skip the orchestrator for a single re-run, but you'll lose the gating and the audit trail of the full flow.

Your next SDD ZIP is five minutes away.

Pick your tool. Pick your flow. Generate. You keep the prompts, you keep the ZIP, you keep the code.

Free during beta · MIT licensed · No signup