К основному содержанию
скилл CX Codex

agent-teams · rohitg00 — скилл для Claude Code: координация команды агентов

Скилл agent-teams для Claude Code объединяет несколько сессий в команду с общими задачами, сообщениями и блокировками файлов. Координатор делегирует работу над разными частями кода.

MIT ★ 2 966 обновлён 2026-09-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Открыть на GitHub

Что делает agent-teams

agent-teams превращает отдельные сессии Claude Code в координированную группу. Первая сессия становится координатором, остальные — товарищами. Они видят друг друга через общий mailbox, одновременно работают над разными задачами и блокируют файлы, чтобы избежать конфликтов. Товарищи — это полноценные сессии Claude Code с собственным контекстом и всеми инструментами, не просто подчинённые, которые отчитываются.

Задачи разбиваются на юниты, которые трогают разные файлы и проверяются независимо. Координатор утверждает план перед внедрением, товарищи берут незаблокированные задачи, объявляют зависимости. Оптимально работает команда из 3–5 человек; свыше 5 координация замедляет работу больше, чем параллелизм ускоряет.

Чтобы включить, установите флаг окружения CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 и запустите claude. Можно переключаться между товарищами клавишей Shift+Down или запустить каждого в отдельном tmux-окне. Координатор может перейти в режим делегирования (Shift+Tab), чтобы только управлять, не редактируя код сам.

Какие задачи решает

  • разделить большую задачу между несколькими AI-сессиями без конфликтов
  • координировать параллельную работу на API, UI и тестах одновременно
  • убедиться, что товарищи не зависят друг от друга в неправильном порядке
  • утвердить план перед реализацией, чтобы не переделывать

Примеры запросов агенту

  • Запустите координатора: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 && claude, потом в других окнах запустите товарищей в том же репо
  • Разделите работу: «Задача 1 — добавить middleware rate-limiting в src/middleware/rate-limit.ts, Задача 2 — тесты в tests/rate-limit.test.ts, Задача 3 — Redis-конфиг в src/config/redis.ts»
  • Переключайтесь между сессиями Shift+Down, смотрите текущую задачу каждого, утверждайте планы перед внедрением

Как установить agent-teams

1Через маркетплейс плагинов

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

Команда ставит плагин pro-workflow целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add rohitg00/pro-workflow --skill agent-teams -a claude-code

3Вручную: положить файлы

~/.claude/skills/agent-teams/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/agent-teams/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об agent-teams

Как установить agent-teams в Claude Code?

Запустите /plugin marketplace add rohitg00/pro-workflow, потом /plugin install pro-workflow@pro-workflow, затем npx skills add rohitg00/pro-workflow --skill agent-teams -a claude-code. Или откройте ~/.claude/skills/agent-teams/SKILL.md.

Чем agent-teams отличается от субагентов?

Товарищи — полноценные сессии Claude Code с собственным контекстом и всеми инструментами, они общаются между собой напрямую. Субагенты — облегчённые помощники, которые рапортуют только координатору. Teams подходят для параллельной работы на коде, субагенты — для быстрого фона.

Сколько товарищей должно быть в команде?

3–5 оптимально: хватает параллелизма, координация не перегружает. Выше 5 координатор тратит больше времени на управление, чем команда экономит. Каждому товарищу — 5–6 задач, чтобы не было переключений контекста и простоев.

Исходный текст

SKILL.md · MIT
---
name: agent-teams
description: 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.
user-invocable: true
---

# 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.

**Task granularity:** Aim for 5-6 tasks per teammate. Fewer means underutilization; more means excessive context switching.

## Display Modes

**In-process navigation:**
- `Shift+Down` — cycle through teammates (wraps around)
- See each teammate's current task and output

**Split-pane (recommended for >2 teammates):**
- tmux: `tmux split-window -h` per teammate
- iTerm2: Cmd+D for vertical split
- Each pane runs its own `claude` session

## Task Management

Tasks flow through states:

```text
pending → in-progress → completed
              │
              └── blocked (waiting on dependency)
```

### Task Decomposition

Break work into units that:
- Touch non-overlapping files
- Can be verified independently
- Have clear done criteria

**Good decomposition:**
```text
Task 1: Add rate limiting middleware (src/middleware/rate-limit.ts)
Task 2: Add rate limit tests (tests/rate-limit.test.ts)
Task 3: Update API docs for rate limit headers (docs/api.md)
Task 4: Add Redis config for rate limit store (src/config/redis.ts)
```

**Bad decomposition:**
```text
Task 1: Implement rate limiting
Task 2: Fix rate limiting bugs
Task 3: Improve rate limiting
```

### Dependencies

Tasks can declare dependencies:
```text
Task 3 (API docs) → depends on Task 1 (middleware)
Task 2 (tests) → depends on Task 1 (middleware)
Task 4 (Redis config) → no dependencies
```

Teammates pick up unblocked tasks automatically.

## File-Lock Claiming

Teammates claim files before editing to prevent conflicts:

1. Teammate checks if file is locked
2. If free, claims it (file-lock-based)
3. Edits the file
4. Releases lock on task completion

If two teammates need the same file, one waits or the lead reassigns.

## Plan Approval

Teammates plan before implementing:

1. Teammate receives task
2. Writes a brief plan (files to change, approach)
3. Lead reviews plan
4. Lead approves or redirects
5. Teammate implements

This prevents wasted work from misunderstood requirements.

## Delegate Mode

`Shift+Tab` toggles delegate mode for the lead:
- Lead coordinates only — no direct code edits
- All implementation delegated to teammates
- Lead reviews, approves plans, manages task flow

## Hook Events

| Hook | Fires When |
|------|------------|
| TeammateIdle | A teammate finishes its task and has no pending work |
| TaskCreated | New task added to the shared list |
| TaskCompleted | A teammate marks a task done |

Use these to trigger notifications, auto-assign next tasks, or run integration tests when all tasks complete.

## When to Use Teams vs Alternatives

| Scenario | Use |
|----------|-----|
| Parallel work on non-overlapping files | Agent teams |
| Quick background exploration | Subagent |
| Isolated feature branch work | Worktree (`claude -w`) |
| Competing approaches to same problem | Worktrees (compare results) |
| Cross-layer changes (API + UI + tests) | Agent teams |
| One-off delegation | Subagent with `isolation: worktree` |
| Large-scale migration (20+ files) | `/batch` command |

## Anti-Patterns

- More than 5 teammates — coordination overhead dominates
- Tasks that share mutable state or the same files
- Skipping plan approval — leads to rework
- Lead doing implementation instead of coordinating (use delegate mode)
- Not setting dependencies — teammates race on coupled tasks

## Example Session

```text
Lead: "We need rate limiting. Breaking into 4 tasks."

  Task 1: middleware implementation → Teammate 1
  Task 2: Redis config → Teammate 2 (no deps)
  Task 3: tests → Teammate 1 (after Task 1)
  Task 4: API docs → Teammate 2 (after Task 1)

Teammate 1 plans → Lead approves → implements Task 1
Teammate 2 plans → Lead approves → implements Task 2
Task 1 completes → unblocks Tasks 3 and 4
Teammate 1 picks up Task 3, Teammate 2 picks up Task 4
All complete → Lead runs integration tests → commits
```

## Docs

https://code.claude.com/docs/agent-teams

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — agent-teams от других авторов.

agent-teams alinaqi Скилл agent-teams организует разработку через команду ИИ-агентов и обязательный TDD-конвейер. Подходит для проектов, где нужны проверки кода, безопасности и pull request. CX Codex +1 300установок agent-teams travisjneuman Учит Claude собирать команды агентов: когда они уместны, сколько участников брать и как писать промпты запуска. Работает только при включённых Agent Teams. CX Codex +1 153установок suede-agent-teams JasonColapietro Скилл suede-agent-teams координирует параллельную работу субагентов с разделением файлов по дорожкам, проверкой коллизий через Git и фиксацией статусов в журнале. Помогает распределять задачи без взаимных правок. CX Codex +1 ★ 121звёзд репо Microsoft Teams Automation Claude Office Skills Скилл Microsoft Teams Automation для работы с Microsoft Teams из ИИ-агента: отправка сообщений в каналы, планирование встреч, вебхуки и боты. CX Codex +1 4 900установок openhuddle nika110 MCP-сервер openhuddle связывает ИИ-агентов команды в совместный режим с общей доской задач, защитой от конфликтов в файлах и обсуждениями. CX Codex +1 ★ 6звёзд репо team-coordination alinaqi Скилл team-coordination организует совместную работу нескольких сессий Claude Code в одном репозитории через синхронизацию задач и статусов в Markdown. Пригодится команде, чтобы избежать конфликтов при параллельной разработке. CX Codex +1 321установок agenthub Alireza Rezvani Плагин agenthub запускает параллельных субагентов в отдельных git worktree для соревнования разных подходов к коду. Оценивает итог по метрикам или LLM-судье и сливает лучшее решение. ★ 30 251звёзд репо agents-crewai Orchestra Research Скилл agents-crewai для сборки команд автономных агентов с ролями, памятью и последовательным или иерархическим выполнением задач. CX Codex +1 371установок

Из того же набора83

Весь набор →
insights Команда insights в Claude Code считает статистику сессий: правки файлов, самоисправления агента и сработавшие правила. Показывает повторяющиеся ошибки. CX Codex +1 ★ 2 966звёзд репо doctor Команда doctor проверяет здоровье установки pro-workflow и конфигурации Claude Code: хуки, база данных, контекст, MCP-серверы, гит-статус. Помогает отловить сломанные скрипты и конфликты настроек на ранней стадии. CX Codex +1 ★ 2 966звёзд репо thoroughness-scoring Скилл thoroughness-scoring обязывает ассистента оценивать инженерные решения по шкале от 1 до 10 и предпочитать надёжный код быстрым костылям. CX Codex +1 ★ 2 966звёзд репо skill-optimizer Скилл skill-optimizer анализирует накопленные исправления и предлагает правки для SKILL.md. Изменения проходят проверку на отложенных примерах, прежде чем попасть в файл. CX Codex +1 ★ 2 966звёзд репо sprint-status Скилл sprint-status организует отслеживание параллельных сессий Claude Code через строки статуса и явное указание проекта, ветки и задачи. CX Codex +1 ★ 2 966звёзд репо skill-router Скилл skill-router для Claude Code показывает навыки и слэш-команды pro-workflow по задачам и объясняет, как они запускаются. Указывает, с какого элемента pro-workflow начать. CX Codex +1 ★ 2 966звёзд репо permission-analyst Субагент permission-analyst для Claude Code. Анализирует запросы разрешений и отказы, рекомендует правила permissions и записи autoMode — разбирает случаи, когда промпты тормозят работу или авторежим откатывается к подтверждениям. CX Codex ★ 2 966звёзд репо safe-mode Скилл safe-mode защищает проект от разрушительных команд терминала и ограничивает правки одной папкой через хуки Claude Code. CX Codex +1 ★ 2 966звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой