kissrosecicd-hub/meta-agent-spawn

Meta: Agent Spawn

Решает когда, кого и сколько субагентов запускать параллельно.

Когда спавнить

| Сигнал | Действие | |--------|----------| | «почини всё», «полный аудит», «комплексная проверка» | Спавн 3-4 агентов параллельно | | «провери код» на конкретном файле | НЕ спавнить — сделать самому | | «напиши тесты + документацию» | Спавн 2 агентов (test + docs) параллельно | | Один запрос, одна задача | НЕ спавнить — оверхед |

Правило: Спавн оправдан когда 3+ независимых задач в одном запросе.

Когда НЕ спавнить

• Задача решается одним действием (один файл, один фикс)
• Пользователь ждёт ответ здесь и сейчас (спавн = задержка)
• Контекст уже загружен и я знаю ответ
• Только один агент нужен (лучше сделать самому)

Выбор агентов по типу задачи

| Тип задачи | Агент(ы) | Параллельно? | |---|---|---| | Аудит кода | code-reviewer + security-auditor | ✅ Да, независимы | | Баг + починить | debugger | ❌ Один агент | | Баг + тесты | debugger + test-architect | ✅ Да | | Рефакторинг + документация | refactor-architect + docs-writer | ✅ Да | | Полный релиз | release-manager | ❌ Один мета-агент | | Новый проект | onboarding-scout | ❌ Один агент | | Git + зависимости | git-doctor + dependency-manager | ✅ Да |

Лимиты параллелизма

| Уровень | Макс агентов | Когда | |---------|-------------|-------| | Минимальный | 2 | Простые независимые задачи | | Стандартный | 3 | Аудит: code + security + tests | | Максимальный | 4 | Комплекс: code + security + tests + docs | | Перебор | 5+ | Контекст деградирует, НЕ делать |

Порядок запуска

Фаза 1 (параллельно, read-only):
  ├─ code-reviewer     → анализ кода
  ├─ security-auditor  → аудит безопасности
  └─ onboarding-scout  → если новый проект

Фаза 2 (параллельно, зависит от Фазы 1):
  ├─ debugger          → чинит найденные баги
  └─ test-architect    → пишет тесты

Фаза 3 (последовательно, финализация):
  ├─ docs-writer       → документация изменений
  └─ git-doctor        → коммит

Правило: Read-only всегда первые. Пишущие — после. Финализация — последовательно.

Конфликты агентов

| Ситуация | Решение | |----------|---------| | Два агента меняют один файл | Последовательно, не параллельно | | Агент A ждёт результат агента B | Последовательно | | Агент меняет конфиг, другой его читает | Последовательно (конфиг сначала) | | Оба читают один файл | Параллельно (read-only безопасно) |

Решение о спавне (алгоритм)

1. Запрос содержит 2+ независимых задач?
   NO → делать самому, НЕ спавнить
   YES → дальше

2. Задачи независимые (не ждут друг друга)?
   NO → последовательно, одного за другим
   YES → дальше

3. Сколько независимых задач?
   2 → 2 агента параллельно
   3 → 3 агента параллельно
   4 → 4 агента параллельно (максимум!)
   5+ → сгруппировать в 4, остальное в фазу 2

4. Есть ли конфликт по файлам?
   YES → разделить на последовательные фазы
   NO → запускать параллельно

Когда спавн через Agent tool, когда через промпт

| Ситуация | Метод | |----------|-------| | general-purpose стабильный | Agent tool, параллельные вызовы | | general-purpose зависает | Читать SKILL.md → применить инструкции самому | | Explore для сбора инфы | Agent tool (стабильный) | | Специализированный агент доступен | Agent tool | | Нужен контроль над процессом | Самому, по шагам |