coordinating-agent-teamslisted
Install: claude install-skill lenneTech/claude-code
# Coordinating Agent Teams
Claude Code Agent Teams (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`) coordinate multiple independent Claude Code sessions with inter-agent messaging and a shared task list. Unlike subagents (Agent tool), teammates communicate directly and challenge each other.
## Not the same as peer sessions
Two different things run several Claude Code sessions at once, and only one of them is this skill.
| | Agent teams (this skill) | Peer sessions (`coordinating-peer-sessions`) |
|---|---|---|
| Who starts them | This session spawns them | The user opens each terminal |
| Structure | A lead supervises, teammates share a task list | Nobody leads; each session owns its work |
| Lifetime | Bound to the lead's session | Independent; any of them can outlive the others |
| Coordination | Task list, plan approval, teammate messaging | Linear and Git first, `ListAgents` second, one message only for LANDED / CLAIM / CONFLICT / SOLVED / READY / ASK |
| Gate | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | On by default from v2.1.224 |
`SendMessage` serves both, which is what makes them easy to confuse. The test is who started the other session: if this session spawned it, the rules here apply; if the user did, the peer rules do. Never treat a peer as a teammate to assign work to. It has its own task and its own user, and a peer message is not an instruction it owes you compliance with.
## Gotchas
- **`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` must be set BEFORE session star