alekseiul/subagent-coordinator

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

Активация

Используй когда нужно:

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

Примеры запросов:

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

Workflow

1. Анализ задачи

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

Критерии для разделения:

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

Пример:

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

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

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

Используй 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:

claudeclaw progress "🤖" "Запущено 3 субагента параллельно"

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

Способ 1: Таймер (быстрый)

sleep 90 && ls -lt ~/.claude/plugins/cache/claudeclaw/claudeclaw/1.0.0/.claude/claudeclaw/logs/subagent-* | head -10

Способ 2: Проверка логов (точный)

# Жди пока все 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. Сбор результатов

Прочитай логи всех субагентов:

ls -lt ~/.claude/plugins/cache/claudeclaw/claudeclaw/1.0.0/.claude/claudeclaw/logs/subagent-task-*.log

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

Отправь progress:

claudeclaw progress "📊" "Собираю результаты 3 субагентов"

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

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

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

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

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

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

---

## Выводы

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

Отправь progress:

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