spawn-team

/spawn-team - Spawn Agent Team

Spawn the default agent team for this project. Creates a coordinated team of agents that implement features in parallel following the strict TDD pipeline.

Pipeline: Specs > Tests > Ensure tests fail > Implement > Test again > Code Review > Security > Create branch > Create PR

---

Phase 1: Prerequisites Check

1.1 Detect Container Mode

Check if Polyphony container isolation is available. Container mode is the default when both Docker and polyphony CLI are present.

BOOTSTRAP_DIR=$(cat ~/.claude/.bootstrap-dir 2>/dev/null)
DETECTED_AGENTS=$("$BOOTSTRAP_DIR/scripts/detect-agents.sh" 2>/dev/null || echo "claude")

CONTAINER_MODE="false"
if echo "$DETECTED_AGENTS" | grep -qE "docker|orbstack"; then
    if command -v polyphony &>/dev/null; then
        CONTAINER_MODE="true"
        echo "✓ Container mode: ON (Docker + polyphony detected)"
        echo "  Each feature agent will run in its own isolated container"
    else
        echo "⚠ Docker found but polyphony CLI missing"
        echo "  Run: cd \$(cat ~/.claude/.bootstrap-dir) && ./install.sh"
        echo "  Falling back to native agents (shared workspace)"
    fi
else
    echo "ℹ Docker not found — using native agents (shared workspace)"
    echo "  Install Docker for container isolation: brew install --cask docker"
fi

1.2 Check Agent Definitions

Verify .claude/agents/ exists and has the required agent definitions:

ls .claude/agents/

Required files (with proper frontmatter: name, description, model, tools, disallowedTools, maxTurns):

• team-lead.md
• quality.md
• security.md
• code-review.md
• merger.md
• feature.md

If missing, copy from the agent-teams skill:

cp -r ~/.claude/skills/agent-teams/agents/ .claude/agents/

1.3 Check Feature Specs

ls _project_specs/features/

If no feature specs exist, ask the user:

No feature specs found. The agent team needs features to implement.

What are the key features of this project? I'll create a spec file for each one.