description: "Spawn an agent team using presets (review, debug, feature, fullstack, research, security, migration) or custom composition"

argument-hint: "<preset|custom> [--name team-name] [--members N] [--delegate]"

Team Spawn

Spawn a multi-agent team using preset configurations or custom composition. Handles team creation, teammate spawning, and initial task setup.

Pre-flight Checks

1. Verify that CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 is set:

• If not set, inform the user: "Agent Teams requires the experimental feature flag. Set CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 in your environment."
• Stop execution if not enabled

1. Parse arguments from $ARGUMENTS:

• First positional arg: preset name or "custom"
• --name: team name (default: auto-generated from preset)
• --members N: override default member count
• --delegate: enter delegation mode after spawning

Phase 1: Team Configuration

Preset Teams

If a preset is specified, use these configurations:

**review** — Multi-dimensional code review (default: 3 members)

• Spawn 3 team-reviewer agents with dimensions: security, performance, architecture
• Team name default: review-team

**debug** — Competing hypotheses debugging (default: 3 members)

• Spawn 3 team-debugger agents, each assigned a different hypothesis
• Team name default: debug-team

**feature** — Parallel feature development (default: 3 members)

• Spawn 1 team-lead agent + 2 team-implementer agents
• Team name default: feature-team

**fullstack** — Full-stack development (default: 4 members)

• Spawn 1 team-implementer (frontend), 1 team-implementer (backend), 1 team-implementer (tests), 1 team-lead
• Team name default: fullstack-team

**research** — Parallel codebase, web, and documentation research (default: 3 members)

• Spawn 3 general-purpose agents, each assigned a different research question or area
• Agents have access to codebase search (Grep, Glob, Read) and web search (WebSearch, WebFetch)
• Team name default: research-team

**security** — Comprehensive security audit (default: 4 members)

• Spawn 1 team-reviewer (OWASP/vulnerabilities), 1 team-reviewer (auth/access control), 1 team-reviewer (dependencies/supply chain), 1 team-reviewer (secrets/configuration)
• Team name default: security-team

**migration** — Codebase migration or large refactor (default: 4 members)

• Spawn 1 team-lead (coordination + migration plan), 2 team-implementer (parallel migration streams), 1 team-reviewer (verify migration correctness)
• Team name default: migration-team

Custom Composition

If "custom" is specified:

1. Use AskUserQuestion to prompt for team size (2-5 members)
2. For each member, ask for role selection: team-lead, team-reviewer, team-debugger, team-implementer
3. Ask for team name if not provided via --name

Phase 2: Team Creation

1. Use the TeamCreate tool to create the team with team_name and description
2. For each team member, use the Agent tool with:

• team_name: the team name
• name: unique descriptive member name (e.g., "fullstack-lead", "frontend-impl", "security-reviewer")
• subagent_type: the selected role (for example, agent-teams:team-lead, agent-teams:team-implementer, agent-teams:team-reviewer, agent-teams:team-debugger, or general-purpose for research)
• prompt: Role-specific instructions referencing the appropriate agent definition

1. Do not use the role name team-lead as the spawned member name. Team creation can reserve role-like names, so use a unique member name and address the teammate by the actual name returned by Agent or listed in ~/.claude/teams/{team-name}/config.json.

Phase 3: Initial Setup

1. Use TaskCreate to create initial placeholder tasks for each teammate
2. Display team summary:

• Team name
• Member names and roles
• Display mode (tmux/iTerm2/in-process)

1. If --delegate flag is set, transition to delegation mode

Output

Display a formatted team summary:

Team "{team-name}" spawned successfully!

Members:
  - {member-1-name} ({role})
  - {member-2-name} ({role})
  - {member-3-name} ({role})

Use /team-status to monitor progress
Use /team-delegate to assign tasks
Use /team-shutdown to clean up