Stats
Actions
Available In
Tags
SDK Bridge
PRD-driven parallel development. SDK Bridge turns your feature description into a structured PRD, then orchestrates multiple Claude Code Agent Teams teammates to implement stories simultaneously — with TDD discipline, quality gates, and two-stage review baked in.
One command. Parallel execution. No babysitting.
Based on Geoffrey Huntley's Ralph pattern.
How It Works
You: /sdk-bridge:start
↓
Wizard: Ask 3-5 questions → generate tasks/prd-feature.md
↓
Review: Approve, improve, or edit the PRD
↓
Convert: prd.json + dependency graph analysis
"Group 1: US-001 (no deps)
Group 2: US-002, US-003 (parallel — both depend on US-001)
Group 3: US-004 (depends on US-002 + US-003)
Suggested teammates: 2"
↓
Configure: quality commands (test/build/typecheck) + code review
↓
Execute:
git checkout -b sdk-bridge/your-feature
TaskCreate × N stories
┌─────────────────────────────────────────────────────┐
│ Teammate 1 Teammate 2 Teammate N │
│ claim US-001 claim US-002 claim US-003│
│ TDD → commit TDD → commit TDD → commit│
│ TaskUpdate(done) TaskUpdate(done) TaskUpdate │
└─────────────────────────────────────────────────────┘
validate-task.sh fires on each TaskCompleted
check-idle.sh blocks any teammate from stopping early
↓
Review: reviewer subagent → full branch diff vs all criteria
code-reviewer subagent → architecture, security, types
↓
Done: prd.json marked complete · progress.jsonl updated · report
Prerequisites
| Requirement | Version | Install |
|---|---|---|
| Claude Code CLI | v2.1.84+ | See Claude Code docs |
| Agent Teams | Experimental | export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 |
jq | Any | brew install jq (macOS) or apt install jq |
| Git | Any | Required for branch management |
Permissions: For autonomous execution (no permission prompts), start Claude Code with one of:
# Team/Enterprise plans — safer, uses background classifier
claude --permission-mode auto
# Max/Pro plans — skips all permission checks
claude --dangerously-skip-permissions
Without either, teammates inherit your default permission mode and will prompt for every file edit, bash command, and git operation. The permissionMode declared in agent frontmatter is overridden for Agent Teams teammates. Auto mode requires Team/Enterprise plan + Sonnet 4.6 or Opus 4.6.
Authentication (choose one):
# OAuth (recommended for Max subscribers)
claude setup-token
export CLAUDE_CODE_OAUTH_TOKEN='your-token'
# API key
export ANTHROPIC_API_KEY='your-key'
Installation
# Add the marketplace
/plugin marketplace add flight505/flight505-marketplace
# Install SDK Bridge
/plugin install sdk-bridge@flight505-marketplace
Quick Start
# Enable Agent Teams (add to ~/.zshrc or ~/.bashrc)
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
# Start the wizard
/sdk-bridge:start
The wizard walks you through 5 checkpoints (dependency check → PRD generation → review → conversion → configuration), then takes over as team lead and runs Agent Teams until all stories are complete.
Architecture
Components
| Component | Count | Description |
|---|---|---|
| Commands | 1 | /sdk-bridge:start — interactive wizard + team lead |
| Skills | 2 | PRD generator, PRD converter (with dependency graph) |
| Agents | 3 | implementer (teammate), reviewer, code-reviewer |
| Hooks | 5 | TaskCreated, TaskCompleted, TeammateIdle, SessionStart, PreCompact |
Agents
Implementer (teammate, runs in parallel)
- Claims stories from shared task list via
TaskList/TaskUpdate - Implements with strict TDD: RED → GREEN → REFACTOR per criterion
- Appends patterns to
progress.jsonlto share knowledge with other teammates - Marks task complete;
validate-task.shhook blocks on test/build/typecheck failure
Reviewer (subagent, runs once after all stories complete)
- Reads full
git diff main...HEADacross all commits - Verifies every acceptance criterion in every story with file:line evidence
- Two-phase: spec compliance first, then runs configured quality commands
