Агенты и команды Claude Code — субагенты и параллелизм

Простым языком

Агенты — это как разные специалисты в одной команде. Один проверяет безопасность. Другой ревьюит код. Третий пишет тесты. Ты не вызываешь их сам — они подключаются автоматически когда нужны.

Самое крутое: несколько агентов могут работать одновременно. Пока один пишет код, другой уже проверяет — это экономит время. Сначала это кажется магией, но логика простая.

Зачем нужны субагенты

Один AI-агент — бутылочное горлышко: он последовательный, у него один контекст, он может писать код или проверять безопасность — но не всё одновременно. Субагенты решают это: каждый специализируется, работают параллельно, каждый со своим контекстом.

Teammates на Sonnet стоят ~5x дешевле, чем если бы всё делал Opus. Lead координирует, рутину делегирует. Умно, а не дорого.

Каталог субагентов

Фазовые — специальные роли для Проекта

business-analyst — глубинное интервью в 7 циклов: от «что хочет пользователь» до edge-cases. Предлагает варианты ответов
system-analyst — технические вопросы: стек, модель данных, API-контракты
pm — менеджер продукта в эпиках: читает tech-spec, строит execution plan, координирует

Валидаторы — проверяют корректность

skeptic — детектор «миражей»: несуществующих файлов, функций, пакетов
completeness-validator — трассировка user-spec → tech-spec в обе стороны
task-validator — атомарность задач, шаблон, согласованность зависимостей
reality-checker — существование файлов на диске, реализуемость
security-reviewer — OWASP Top 10 в спецификации, до написания кода

Код-ревьюеры — проверяют качество

code-reviewer — 10-мерный анализ: корректность, безопасность, производительность, DRY, SOLID
security-auditor — хардкод секретов, SQL инъекции, XSS, открытые эндпоинты
test-reviewer — покрытие, edge-cases, антипаттерны в тестах
architect — оверинжиниринг, архитектурные решения, масштабируемость

Исполнители — делают конкретную работу

task-creator — генерирует файлы задач из tech-spec по шаблону
tdd-guide — ведёт TDD-цикл: тесты → код → рефакторинг
build-error-resolver — диагностика и исправление ошибок сборки
doc-writer — обновляет документацию после реализации фичи

Agent Teams: параллельная работа

Для эпиков используй Agent Teams. Lead (Opus) координирует, Teammates (Sonnet) выполняют задачи параллельно.

# Конфигурация Agent Team

Team Lead (claude-opus-4-5):
  - Читает tech-spec и user-spec
  - Строит execution plan с волнами
  - Распределяет задачи между teammates
  - Собирает результаты, запускает интеграционные проверки
  - Принимает решение о переходе к следующей волне

Teammates (claude-sonnet-4-5, параллельно):
  - Каждый получает свой контекст: задачу + нужные файлы
  - Пишут код, тесты, документацию
  - Сообщают о блокерах Lead-у
  - Не видят работу других teammates

Wave-параллелизм

Задачи группируются в волны по зависимостям. Внутри одной волны — независимые задачи, запускаются параллельно. Следующая волна ждёт завершения предыдущей.

Wave 1: Фундамент (параллельно, ~15 мин)
  task-001: Модель User + миграция
  task-002: Конфиг БД + Docker Compose
  ↓ Ждём завершения...

Wave 2: Бизнес-логика (параллельно, ~20 мин)
  task-003: UserService.create(), .findByEmail()
  task-004: JWT хелпер + refresh tokens
  ↓ Ждём завершения...

Wave 3: API (параллельно, ~25 мин)
  task-005: POST /api/auth/register
  task-006: POST /api/auth/login
  task-007: POST /api/auth/refresh
  ↓ Ждём завершения...

Wave 4: Интеграция (последовательно, ~20 мин)
  task-008: Middleware авторизации
  task-009: Интеграционные тесты

Как определить зависимость задач

task-005 импортирует из task-003 → разные волны (task-005 после task-003)
task-005 и task-006 не пересекаются по файлам → одна волна (параллельно)
task-008 использует результаты всех API → последняя волна

Как вызывать агентов

# Явный вызов code-reviewer
claude "Запусти code-reviewer для src/api/auth.ts"

# Security-аудит
claude "Проведи security-аудит auth flow"

# Agent Team для эпика
claude "/ship epic:auth-system"

# Автоматический вызов через Quality Gates:
# - После >20 строк нового кода → code-reviewer
# - Для авторизации/платежей → + security-auditor