Multi-Agent Orchestration: Patterns for Claude Code Swarms

{
  "security": {
    "description": "Security auditor focused on vulnerabilities",
    "prompt": "You are a security expert. Focus ONLY on: auth bugs, input validation, secrets exposure, injection risks. Ignore style issues. Output JSON: {findings: [{severity: 'critical'|'high'|'medium'|'low', file, line, issue, fix}]}"
  },
  "types": {
    "description": "TypeScript type safety specialist", 
    "prompt": "You are a TypeScript expert. Focus ONLY on: any types, missing null checks, unsafe casts, error boundary gaps. Output JSON: {findings: [{file, line, issue, fix}]}"
  },
  "architect": {
    "description": "Software architecture reviewer",
    "prompt": "You are a senior architect. Focus ONLY on: coupling, abstraction leaks, pattern violations, scalability concerns. Output JSON: {findings: [{file, issue, recommendation}]}"
  },
  "synthesizer": {
    "description": "Merges and prioritizes findings from specialists",
    "prompt": "You receive findings from security, types, and architecture reviewers. Merge them, remove duplicates, and prioritize. Output a concise summary with the top 5 issues to fix first."
  }
}

#!/bin/bash
# code-review-swarm.sh

CODE=$(cat "$1")  # File or directory to review
AGENTS_FILE="./agents.json"

# Spawn workers in parallel (& backgrounds each)
echo "🔒 Security review..."
claude -p --output-format json \
  --agents "$(cat $AGENTS_FILE)" --agent security \
  --model sonnet --max-budget-usd 0.50 \
  "Review this code: $CODE" > /tmp/security.json &

echo "📝 Type safety review..."  
claude -p --output-format json \
  --agents "$(cat $AGENTS_FILE)" --agent types \
  --model sonnet --max-budget-usd 0.50 \
  "Review this code: $CODE" > /tmp/types.json &

echo "🏗️ Architecture review..."
claude -p --output-format json \
  --agents "$(cat $AGENTS_FILE)" --agent architect \
  --model sonnet --max-budget-usd 0.50 \
  "Review this code: $CODE" > /tmp/arch.json &

# Wait for all workers to complete
wait
echo "✅ All reviews complete"

# Synthesize results
echo "🔄 Synthesizing..."
claude -p --agents "$(cat $AGENTS_FILE)" --agent synthesizer \
  "Merge these code reviews:
   Security: $(cat /tmp/security.json)
   Types: $(cat /tmp/types.json)  
   Architecture: $(cat /tmp/arch.json)"

import { spawn } from 'child_process';
import { promisify } from 'util';

const agents = {
  security: { prompt: "You are a security auditor..." },
  types: { prompt: "You are a TypeScript expert..." },
  architect: { prompt: "You are a senior architect..." },
};

async function runAgent(name: string, code: string): Promise<string> {
  return new Promise((resolve, reject) => {
    const proc = spawn('claude', [
      '-p',
      '--output-format', 'json',
      '--append-system-prompt', agents[name].prompt,
      '--model', 'sonnet',
      `Review this code: ${code}`
    ]);
    
    let output = '';
    proc.stdout.on('data', (data) => output += data);
    proc.on('close', (code) => code === 0 ? resolve(output) : reject());
  });
}

async function swarmReview(code: string) {
  // Run all agents in parallel
  const [security, types, arch] = await Promise.all([
    runAgent('security', code),
    runAgent('types', code),
    runAgent('architect', code),
  ]);
  
  // Synthesize
  return runAgent('synthesizer', 
    `Merge: Security: ${security} Types: ${types} Arch: ${arch}`);
}