Create a New Team

Define a multi-agent team composition that coordinates two or more agents to accomplish tasks requiring multiple perspectives, specialties, or phases. The resulting team file integrates with the teams registry and can be activated in Claude Code by name.

When to Use

• A task requires multiple perspectives that a single agent cannot provide (e.g., code review plus security audit plus architecture review)
• You need a recurring collaborative workflow with consistent role assignments and handoff patterns
• An existing agent composition is being used repeatedly and should be formalized
• A complex process naturally decomposes into phases or specialties handled by different agents
• You want to define a coordinated group for sprint-based, pipeline-based, or parallel work

Inputs

• Required: Team name (lowercase kebab-case, e.g., data-pipeline-review)
• Required: Team purpose (one paragraph describing what problem requires multiple agents)
• Required: Lead agent (must exist in agents/_registry.yml)
• Optional: Coordination pattern (default: hub-and-spoke). One of: hub-and-spoke, sequential, parallel, timeboxed, adaptive
• Optional: Number of members (default: 3-4; recommended range: 2-5)