sdk-bridge

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.jsonl to share knowledge with other teammates
• Marks task complete; validate-task.sh hook blocks on test/build/typecheck failure

Reviewer (subagent, runs once after all stories complete)

• Reads full git diff main...HEAD across all commits
• Verifies every acceptance criterion in every story with file:line evidence
• Two-phase: spec compliance first, then runs configured quality commands