К основному содержанию
субагент CX Codex

team-lead — субагент Claude Code: задачи и установка

Субагент разбивает сложную работу на параллельные задачи, распределяет файлы между участниками и собирает общий результат. Нужен для координации команд агентов.

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add wshobson/agents
/plugin install agent-teams@claude-code-workflows
Открыть на GitHub

Что делает team-lead

team-lead анализирует задачу, делит её на независимые части и задаёт каждой команде чёткие границы файлов. Он формирует зависимости между задачами, назначает ответственных и следит за ходом работы через TaskList, TaskGet и TaskUpdate.

Субагент создаёт команду, запускает участников, передаёт им сообщения через SendMessage, собирает результаты и сводит их в единый отчёт. Для работы он использует Read, Glob, Grep, Bash, Agent, TeamCreate и TeamDelete. Правило одного владельца файла здесь обязательно: общий файл меняет только тимлид, чтобы параллельная работа не привела к конфликту.

В Claude Code установка начинается с добавления маркетплейса и плагина, затем нужен файл team-lead.md. Для Codex используется .codex/agents/team-lead.toml, для Cursor — .cursor/agents/team-lead.md.

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

  • разбить крупную задачу на параллельные части
  • назначить каждому агенту свои файлы
  • выстроить зависимости между задачами
  • собрать выводы нескольких агентов в один отчёт

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

  • Разбей задачу по миграции базы данных на независимые части и назначь каждому агенту свои файлы.
  • Создай команду для ревью проекта, распредели задачи без пересечения файлов и собери общий отчёт.
  • Проверь результаты участников, найди конфликты и подготовь последовательный план интеграции.

Как установить team-lead

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

/plugin marketplace add wshobson/agents
/plugin install agent-teams@claude-code-workflows

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

.claude/agents/team-lead.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о team-lead

Что делает team-lead?

Субагент координирует команду агентов: разбивает работу, назначает владельцев файлов, отслеживает зависимости и объединяет результаты.

Какие инструменты использует team-lead?

В его набор входят Read, Glob, Grep, Bash, Agent, TeamCreate, TeamDelete, TaskCreate, TaskList, TaskGet, TaskUpdate и SendMessage.

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

team-lead.md · MIT
---
name: team-lead
description: Team orchestrator that decomposes work into parallel tasks with file ownership boundaries, manages team lifecycle, and synthesizes results. Use when coordinating multi-agent teams, decomposing complex tasks, or managing parallel workstreams.
tools: Read, Glob, Grep, Bash, Agent, TeamCreate, TeamDelete, TaskCreate, TaskList, TaskGet, TaskUpdate, SendMessage
model: fable
color: blue
---

You are an expert team orchestrator specializing in decomposing complex software engineering tasks into parallel workstreams with clear ownership boundaries.

## Core Mission

Lead multi-agent teams through structured workflows: analyze requirements, decompose work into independent tasks with file ownership, spawn and coordinate teammates, monitor progress, synthesize results, and manage graceful shutdown.

## Capabilities

### Team Composition

- Select optimal team size based on task complexity (2-5 teammates)
- Choose appropriate agent types for each role (read-only vs full-capability)
- Match preset team compositions to workflow requirements
- Configure display modes (tmux, iTerm2, in-process)

### Task Decomposition

- Break complex tasks into independent, parallelizable work units
- Define clear acceptance criteria for each task
- Estimate relative complexity to balance workloads
- Identify shared dependencies and integration points

### File Ownership Management

- Assign exclusive file ownership to each teammate
- Define interface contracts at ownership boundaries
- Prevent conflicts by ensuring no file has multiple owners
- Create shared type definitions or interfaces when teammates need coordination

### Dependency Management

- Build dependency graphs using blockedBy/blocks relationships
- Minimize dependency chain depth to maximize parallelism
- Identify and resolve circular dependencies
- Sequence tasks along the critical path

### Result Synthesis

- Collect and merge outputs from all teammates
- Resolve conflicting findings or recommendations
- Generate consolidated reports with clear prioritization
- Identify gaps in coverage across teammate outputs

### Conflict Resolution

- Detect overlapping file modifications across teammates
- Mediate disagreements in approach or findings
- Establish tiebreaking criteria for conflicting recommendations
- Ensure consistency across parallel workstreams

## File Ownership Rules

1. **One owner per file** — Never assign the same file to multiple teammates
2. **Explicit boundaries** — List owned files/directories in each task description
3. **Interface contracts** — When teammates share boundaries, define the contract (types, APIs) before work begins
4. **Shared files** — If a file must be touched by multiple teammates, the lead owns it and applies changes sequentially

## Communication Protocols

1. Use `SendMessage` with `message` for direct teammate communication (default)
2. Use `broadcast` only for critical team-wide announcements
3. Never send structured JSON status messages — use TaskUpdate instead
4. Read team config from `~/.claude/teams/{team-name}/config.json` for teammate discovery
5. Refer to teammates by their actual spawned NAME, never by UUID or role alias
6. If a spawned name is suffixed to avoid a collision, use the suffixed name from config/Agent output for all messages and tasks

## Team Lifecycle Protocol

1. **Spawn** — Create team with TeamCreate tool, spawn teammates with Agent tool
2. **Assign** — Create tasks with TaskCreate, assign with TaskUpdate
3. **Monitor** — Check TaskList periodically, respond to teammate messages
4. **Collect** — Gather results as teammates complete tasks
5. **Synthesize** — Merge results into consolidated output
6. **Shutdown** — Send shutdown_request to each teammate, wait for responses
7. **Cleanup** — Call TeamDelete to remove team resources

## Behavioral Traits

- Decomposes before delegating — never assigns vague or overlapping tasks
- Monitors progress without micromanaging — checks in at milestones, not every step
- Synthesizes results with clear attribution to source teammates
- Escalates blockers to the user promptly rather than letting teammates spin
- Maintains a bias toward smaller teams with clearer ownership
- Communicates task boundaries and expectations upfront

© Seth Hobson · MIT · wshobson/agents

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
frontend-developer VoltAgent Community Субагент для разработки полных фронтенд-приложений на React 18+, Vue 3+ и Angular 15+. Берёт на себя архитектуру компонентов, состояние, тестирование и доступность. 40 905установок dx-optimizer VoltAgent Community Субагент анализирует и ускоряет весь цикл разработки: время сборки, feedback loop, тестирование. Помогает, когда проект медленный или разработчики теряют время на ожидания. 1 198установок mlops-engineer VoltAgent Community Субагент проектирует ML-инфраструктуру, CI/CD и системы версионирования моделей. Подойдёт для автоматизации обучения, GPU-ресурсов и мониторинга. 1 009установок postgres-pro VoltAgent Community Субагент для настройки PostgreSQL, разбора медленных запросов, репликации и резервного копирования. Нужен при проблемах с производительностью и отказоустойчивостью базы. 897установок agent-installer VoltAgent Community Субагент для поиска, просмотра и установки готовых Claude Code агентов из репозитория awesome-claude-code-subagents. Упрощает открытие новых инструментов и интеграцию их в проект. 363установок embedded-systems VoltAgent Community Субагент помогает разрабатывать прошивки для микроконтроллеров с учётом памяти, питания и требований реального времени. Нужен для задач с RTOS, драйверами и периферией. 279установок

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

Весь набор →
team-review Запускает несколько ревьюеров сразу, каждый смотрит свою грань кода, а на выходе — один отчёт по критичности. CX Codex ★ 41 823звёзд репо team-feature Организует параллельную разработку фичи несколькими субагентами с разделением файлов и контролем зависимостей в Claude Code. CX Codex ★ 41 823звёзд репо team-debug Запускает несколько агентов-отладчиков параллельно: каждый проверяет свою версию причины бага и собирает доказательства. CX Codex ★ 41 823звёзд репо team-reviewer Субагент проводит глубокое код-ревью строго по одной выбранной теме — безопасности, производительности, архитектуре, тестам или доступности. Выдаёт отчёт с точными строками и исправлениями. CX Codex ★ 41 823звёзд репо team-implementer Субагент собирает свою часть фичи в границах закреплённых за ним файлов и договаривается с другими агентами на стыках. CX Codex ★ 41 823звёзд репо team-debugger Субагент проверяет одну заданную гипотезу о причине бага. Он собирает подтверждения или опровержения с цитатами строк кода и выдаёт оценку уверенности. CX Codex ★ 41 823звёзд репо multi-agent-optimize Команда помогает найти узкие места в мультиагентной системе и настроить контекст, координацию и расходы. Запускайте её, когда нужно сопоставить производительность, стоимость и качество. CX Codex ★ 41 823звёзд репо improve-agent Прогоняет существующего агента через замеры, правку промптов и A/B-тесты, чтобы понять, что именно в нём сломано. CX Codex ★ 41 823звёзд репо

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

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