agent-swarm

Универсальный скилл для больших задач, которые делятся на 8+ независимых кусков: код и миграции, аудиты, research, документы, данные, дизайн, инфраструктура. Лид планирует, пакует контекст, запускает волны (через workflow, subagent или последовательно — если инструмента нет) и интегрирует. Воркеры не пересекаются по файлам/артефактам, каждый получает пакет и возвращает структурный отчёт.

Вызов

/agent-swarm <задача>

или просто опишите задачу — скилл подключится по описанию.

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

Процесс — опциональный, quality gates — нет. Для продуктовой работы заранее выбирается профиль prototype или product. В product обязательны release-замеры производительности, реальный UX-сценарий, сравнение с baseline и явный вердикт пользователя. Технический pass verifier'а не заменяет приёмку продукта.

Что происходит

Fit-check. Если задача не делится на 8+ независимых юнитов, скилл скажет не использовать swarm.
Prerequisite gate. Скилл проверяет toolchain, runtime, сервисы, display, credentials и baseline. Ставит только project-local/pinned и только с разрешения; если обязательный prerequisite не закрывается — спрашивает пользователя до запуска работы. Воркеры ничего не устанавливают.
Recon. 2–4 агента картографируют репозиторий/источники/данные; лид пишет .swarm/brief.md, .swarm/profile.md и выбирает domain-адаптер из references/domains.md.
План. Задачи, владельцы файлов, контракты, критерии приёмки. Гейт: без этого волны не стартуют.
Волны. Воркеры идут батчами по 6–8 (реальный лимит активных детей узнаётся перед запуском и записывается в state.json; recon не должен занимать слоты). Затем 4–6 независимых верификаторов на «замороженном» дереве, затем интегратор.
Аудит. scripts/audit-scope.mjs сравнивает изменения с картой владения.
Интеграция. Один интегратор собирает общие файлы и прогоняет полный acceptance suite.
Product gate. Для product: release-замеры, реальный сценарий, baseline и вердикт пользователя. Без этого следующий milestone не начинается.
Отчёт. .swarm/final-report.md.

Артефакты

Всё лежит в .swarm/ в корне рабочей папки: бриф, профиль домена, план, карточки задач, отчёты, ревью, baseline, финальный отчёт. .swarm/ можно удалить после задачи или добавить в .gitignore; структура подходит и для кода, и для research/контента/данных/дизайна.

Ограничения

Это инструкция, а не плагин: запуск идёт через инструмент workflow.
Одновременно выполняется столько агентов, сколько разрешает runtime (часто 8, не 14). Лимит проверяется preflight-ом; wave.workflow.js запускает задачи батчами, а не одним большим fan-out.
Дети не общаются между собой и не делегируют дальше; координация — через файлы и лида.
Верификаторы работают на замороженном дереве; полный разбор пишется в .swarm/reviews/Vxx.md, а workflow возвращает только {task_id, verdict, summary, review_file}.
blocked-воркер не заменяется: лид правит контракт/shared-файл и продолжает того же агента через send_message.
Evidence зависит от домена: команда и тест для кода, источник и дата для research, отрендеренный артефакт для дизайна, reproducible metric для данных.
Токены — потолок, а не цель: 20–30% резервируется на verify/integration и polish, после фиксов делается delta-review, а не полная перепроверка. Детали — в references/token-economy.md.
Визуальные агенты работают в отдельных Xvfb/display-окружениях, со своим HOME/config/копией проекта; общий рабочий стол для скриншотов не используется. Детали — в references/visual-testing.md.
Computer-use — крайний tier: один агент, одноразовый desktop/VM, только после детерминированных проверок и никогда как единственное evidence.
Стоимость: 30–40 агентов ≈ 0.5–1.5M токенов.
Для задачи, которую один агент делает за 15 минут, swarm не нужен.

Настройка

Шаблоны: assets/, включая prerequisites.md.tmpl.
Prerequisites: references/prerequisites.md.
Product quality: references/product-quality.md.
Подробный runbook: references/playbook.md.
Оркестрация: references/orchestration.md.
Проверка скоупа: node scripts/audit-scope.mjs --init перед стартом, затем node scripts/audit-scope.mjs.
Для директорий в plan.json используйте glob path/**, особенно для ещё не созданных папок.

7.0 KiB Raw Blame History Unescape Escape