meta-agent-spawn

name	meta-agent-spawn
description	Мета-скилл решения о параллельном запуске субагентов: кого, когда и сколько. Trigger when: почини всё, полный аудит, провери весь проект, комплексный анализ, запусти тесты, параллельный запуск, spawn agents, orchestrator

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
Нужен контроль над процессом	Самому, по шагам