agent-teams is agent-read markdown (skill) from rohitg00/pro-workflow: Coordinate multiple Claude Code sessions as a team — lead + teammates with shared task lists, mailbox messaging, and file-lock claiming. Patterns for team sizing, task decomposition, and when to use teams vs sub-agents vs worktrees..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Agent Teams
Coordinate multiple Claude Code sessions working on the same codebase simultaneously.
## Enable
```bash
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude # starts as team lead
```
The first session becomes the team lead. Subsequent sessions in the same repo join as teammates.
## Architecture
```text
Team Lead (coordinates, delegates, reviews)
├── Teammate 1 (owns task A, messages lead + peers)
├── Teammate 2 (owns task B, messages lead + peers)
└── Teammate 3 (owns task C, messages lead + peers)
│
└── Shared: task list + mailbox + file locks
```
**Key difference from subagents:** Teammates are full Claude Code sessions. They have their own context window, can use all tools, and message each other directly — not just report back to a parent.
## Team Sizing
| Team Size | Best For |
|-----------|----------|
| 2 | One builds, one reviews |
| 3-5 | Parallel features across layers (API, UI, tests) |
| > 5 | Coordination overhead outweighs parallelism |
3-5 teammates is the productive range. Beyond that, the lead spends more time coordinating than the team saves.
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_gzl76uzwz4za7yqp
GET https://markdownregistry.com/api/v1/resolve?ref=rohitg00/pro-workflow/agent-teams
GET https://markdownregistry.com/api/v1/blob/583d500e90c5ba9931fbb0f77324c351448fea1db99464ef944799f8f344ccec
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
rohitg00/pro-workflow · skills/auto-setup/SKILL.md · Auto-configure quality gates, hooks, and settings for a new project. Detects project type and sets up appropriate…
rohitg00/pro-workflow · skills/batch-orchestration/SKILL.md · Decompose large-scale changes into independent units and spawn parallel agents in isolated worktrees. Use for…
rohitg00/pro-workflow · skills/bug-capture/SKILL.md · Capture a user-reported defect as a durable GitHub issue written in the project's own domain language. Explores the…
rohitg00/pro-workflow · skills/compact-guard/SKILL.md · Smart context compaction with state preservation. Saves critical files, task progress, and working state before…
rohitg00/pro-workflow · skills/context-optimizer/SKILL.md · Optimize token usage and context management. Use when sessions feel slow, context is degraded, or you're running out of…
rohitg00/pro-workflow · skills/cost-tracker/SKILL.md · Track session costs, set budget alerts, and optimize token spend. Use to check costs mid-session or set spending limits.
rohitg00/pro-workflow · skills/design-engineering/SKILL.md · Apply interface craft when building or reviewing UI - motion, easing, timing, springs, component feel, and visual…
rohitg00/pro-workflow · skills/deslop/SKILL.md · Remove AI-generated code slop, unnecessary comments, and over-engineering from the current branch diff. Cleans up…
rohitg00/pro-workflow · skills/domain-modeling/SKILL.md · Build the project's shared language and bounded contexts before writing code, so names stay consistent and the agent…
rohitg00/pro-workflow · skills/improve-architecture/SKILL.md · Audit an area of the codebase and propose the smallest structural moves that improve it - untangle boundaries, kill…
athola/claude-night-market · plugins/conjure/skills/agent-teams/SKILL.md · Coordinates Claude agent teams via filesystem protocol. Use when orchestrating parallel agents with task dependencies…
turbokach/claude-code-setup · skills/agent-teams/SKILL.md · Orchestration playbook for parallel multi-agent work in Claude Code. Use when fanning out genuinely parallel…
dmitriyyukhanov/claude-plugins · plugins/agent-teams/skills/agent-teams/SKILL.md · Set up and orchestrate Claude Code agent teams - multiple Claude Code instances working together with shared tasks…
this-hw/claude-code-kit · plugins/common/skills/agent-teams/SKILL.md · SUPERSEDED by control-loop (kept through claude-code-kit 2.x; removed in the successor hiway-kit) — large-scale…