Agent Teams Advanced Patterns

Claude Code Agent Teams enable parallel multi-agent coordination within a shared task context. This skill covers production-grade patterns for designing, scaling, and debugging agent team topologies.

Agent Teams Mechanics

Enablement:

• Set environment variable: CLAUDE_ENABLE_TEAMS=true
• Or pass --enable-teams flag to Claude Code CLI
• Each teammate gets an independent context window and git worktree

How teams differ from subagents:

• Subagents are sequential, fire-and-forget workers. Main agent waits for results then continues.
• Teammates run in parallel with peer-to-peer messaging. All teammates share a task list and can see each other's progress in real-time.
• Independent sessions: Each teammate maintains its own conversation state and can recover if it fails without blocking other teammates.
• Shared responsibility: Teammates collectively own the goal, not individual subtasks assigned by a parent.

Team Topology Patterns