---
name: subagent-coordinator
description: "Запуск нескольких субагентов параллельно с автоматической сборкой результатов в единый отчёт. Используй для независимых задач которые можно выполнить одновременно. Триггеры: 'параллельно', 'несколько субагентов', 'запусти агентов', 'исследуй рынок', 'проанализируй конкурентов'."
---

# Subagent Coordinator — Параллельные задачи с автосборкой

## Активация

Используй когда нужно:
- Запустить несколько субагентов параллельно
- Дождаться завершения всех
- Собрать результаты в единый отчёт

**Примеры запросов:**
- "Проанализируй конкурентов (3 направления)"
- "Исследуй рынок (опроси 5 источников)"
- "Проверь код (анализ + тесты + документация)"

## Workflow

### 1. Анализ задачи
Разбей задачу на независимые подзадачи (2-5 субагентов).

**Критерии для разделения:**
- Подзадачи независимы (можно выполнять параллельно)
- Каждая подзадача возвращает осмысленный результат
- Результаты можно объединить в единый отчёт

**Пример:**
```
Задача: "Проанализируй конкурентов в AI-агентах"

Подзадачи:
1. competitor-research → найти 5 конкурентов
2. differentiation-analysis → выявить отличия
3. positioning-strategy → предложить стратегию
```

### 2. Запуск субагентов

**Используй Bash с фоновыми задачами:**
```bash
cd ~/.claude/plugins/cache/claudeclaw/claudeclaw/1.0.0 && \
bun src/index.ts subagent run "task-1" "промпт задачи 1" 2>&1 | tee /tmp/task-1.log &
bun src/index.ts subagent run "task-2" "промпт задачи 2" 2>&1 | tee /tmp/task-2.log &
bun src/index.ts subagent run "task-3" "промпт задачи 3" 2>&1 | tee /tmp/task-3.log &
```

**Отправь progress:**
```bash
claudeclaw progress "🤖" "Запущено 3 субагента параллельно"
```

### 3. Ожидание завершения

**Способ 1: Таймер (быстрый)**
```bash
sleep 90 && ls -lt ~/.claude/plugins/cache/claudeclaw/claudeclaw/1.0.0/.claude/claudeclaw/logs/subagent-* | head -10
```

**Способ 2: Проверка логов (точный)**
```bash
# Жди пока все 3 лог-файла появятся
while [ $(ls ~/.claude/plugins/cache/claudeclaw/claudeclaw/1.0.0/.claude/claudeclaw/logs/subagent-task-*.log 2>/dev/null | wc -l) -lt 3 ]; do
  sleep 10
done
```

### 4. Сбор результатов

**Прочитай логи всех субагентов:**
```bash
ls -lt ~/.claude/plugins/cache/claudeclaw/claudeclaw/1.0.0/.claude/claudeclaw/logs/subagent-task-*.log
```

**Используй Read tool для каждого лог-файла.**

**Отправь progress:**
```bash
claudeclaw progress "📊" "Собираю результаты 3 субагентов"
```

### 5. Формат единого отчёта

```markdown
# 📊 [Название задачи]

## Результаты

### [Подзадача 1]
[Вывод субагента 1]

### [Подзадача 2]
[Вывод субагента 2]

### [Подзадача 3]
[Вывод субагента 3]

---

## Выводы

[Объединённая сводка всех результатов]
```

**Отправь progress:**
```bash
claudeclaw progress "✅" "Отчёт готов"
```

## Примеры использования

### Пример 1: Конкурентный анализ
```
Задача: "Найди 5 конкурентов и определи мои отличия"

Субагенты:
1. competitor-research → поиск конкурентов
2. differentiation-analysis → анализ отличий
3. positioning-strategy → стратегия позиционирования

Время: ~90 сек параллельно (vs ~4.5 мин последовательно)
```

### Пример 2: Исследование рынка
```
Задача: "Изучи рынок подписок на AI-контент"

Субагенты:
1. market-size → размер рынка, статистика
2. pricing-analysis → ценообразование конкурентов
3. customer-feedback → анализ отзывов пользователей

Время: ~120 сек параллельно
```

### Пример 3: Рефакторинг кода
```
Задача: "Проверь качество кода перед PR"

Субагенты:
1. code-analysis → анализ архитектуры
2. test-coverage → проверка покрытия тестами
3. documentation → обновление документации

Время: ~60 сек параллельно
```

## Лимиты

- **Макс субагентов:** 5 (больше не ускорит, API лимиты)
- **Время ожидания:** 120 сек (если дольше - субагент завис)
- **Размер промпта:** до 2000 символов на субагента

## Ошибки

**Субагент завис (нет лога >120 сек):**
- Проверь `/tmp/task-name.log` - возможно ошибка
- Перезапусти субагента отдельно
- Уменьши промпт

**Лог обрезан (неполный результат):**
- Субагент вернул слишком большой вывод
- Прочитай лог напрямую - он полный
- Если нужно больше - увеличь timeout

**Координатор не собрал все результаты:**
- Проверь что все логи созданы: `ls -lt ~/.claude/plugins/cache/claudeclaw/claudeclaw/1.0.0/.claude/claudeclaw/logs/subagent-*`
- Прочитай каждый лог отдельно
- Собери отчёт вручную

## Настройки (опционально)

**Автоматическая сборка отчёта:**
По умолчанию включено. Если нужно только запустить субагенты без сборки отчёта - скажи "только запусти, отчёт не собирай".

**Время ожидания:**
По умолчанию 90 сек. Если задача сложная - укажи `sleep 120` или `sleep 180`.

---

**Subagent Coordinator v1.0** — создан для ClaudeClaw