Рой агентов
Сверено с выпуском 0.36.0, 14.11.2026.
Рой — именованный состав ролей, который запускается на репозиторий одной кнопкой. С вами общается только архитектор: он изучает код, раздаёт задания участникам, собирает их отчёты и подводит итог.
Роли
Ведущий — архитектор: единственный, кто говорит с вами. Остальные роли либо правят код (строят), либо только читают (думают и проверяют). У каждой роли Pulse есть персона — фамилия человека из истории космоса, вычислительных машин или фантастики о космосе. Персона — имя и подсказка «кто это и почему эта роль», а не маска: в инструкцию агенту она не попадает. В компактных местах (колонка роя, узел графа) видна фамилия, роль — в подсказке. Выключить имена можно в Настройки → Рой → «Имена участникам».
| Роль | Персона | Работа с кодом | Что делает |
|---|---|---|---|
| Архитектор | Королёв | ведущий | общается с вами, видит архитектуру целиком, раздаёт задания и сводит отчёты |
| Фронтенд-разработчик | Энгельбарт | правит код | интерфейс и клиентский код в стиле проекта, с проверкой сборки |
| Бэкенд-разработчик | Ритчи | правит код | API, сервисы, данные; правит только серверную часть |
| DevOps | Тесла | правит код | сборка, CI, конфигурация, окружения |
| Тестировщик | Гагарин | правит код | пишет и прогоняет тесты, ищет регрессии |
| Документация | Азимов | правит код | пишет и правит документацию проекта; код не трогает |
| Аналитик | Лавлейс | только читает | требования, сценарии, критерии приёмки |
| Продукт | Циолковский | только читает | качество с точки зрения пользователя и ценности |
| Безопасность | Тьюринг | только читает | уязвимости, секреты, доступы |
| Приёмщик | Келдыш | только читает | сверяет сделанное с критериями приёмки до «готово» |
| Инспектор бэкенда | фон Нейман | только читает | оценивает серверный код, который написали другие агенты |
| Инспектор фронтенда | Кубрик | только читает | оценивает клиентский код, который написали другие агенты |
| Инспектор качества | Лем | только читает | общая инспекция кода и тестов |
| Исследователь | Кларк | только читает | изучает варианты, эталоны и первоисточники до решения |
| Данные | Шеннон | только читает | схемы, миграции, запросы и целостность данных |
| Дизайнер интерфейса | Лоуи | только читает | путь человека, вид и состояния экранов по дизайн-системе |
Роли, которые только читают, не могут править файлы и запускать команды — это держит политика на уровне роли, независимо от режима и настроек (см. Контроль).
Роли и персоны в настройках
Настройки → Рой → вкладка «Роли и персоны» — таблица всех ролей: роль, персона, принцип («строит» или «думает и проверяет»), правит ли код, агент и модель, состояние («как у Pulse», «изменено» или «своя»). Щелчок по строке открывает карточку роли:
- Роль — название, строка «что делает», работа с кодом («Правит код» или «Только читает»; для новых запусков, идущие сессии сохраняют вид, с которым запущены);
- Инструкция — текст для агента, со списком ваших версий и «Вернуть инструкцию как у Pulse»;
- Агент и модель — кого получит новый участник с этой ролью; участник в составе может отступить от роли, его выбор сильнее;
- Права — что держит Pulse и что держит только инструкция;
- Наблюдаемость — задания и исходы роли из запущенных роёв и составы, где роль стоит.
«Новая роль» заводит свою роль с нуля, «Сделать копию» — свою роль с инструкцией выбранной. «Вернуть как у Pulse» возвращает умолчание, «Удалить роль» — только у своей роли, которой нет в составах. Открыть карточку можно и с графа: меню узла участника → «Настроить роль…», и из меню его сессии в колонке.
Собрать состав
Настройки → Рой → вкладка «Составы»:
- кнопки «Собрать: Полный рой / С инспекцией / Разработка / Аудит» создают готовый состав одним кликом («С инспекцией» — архитектор, фронтенд, бэкенд, инспектор фронтенда и инспектор бэкенда);
- «Новый рой» — свой: выбираете роли, для каждой агента и модель, назначаете ведущего, при необходимости правите инструкцию роли (у неё своя история версий);
- если у роли выбран агент, который сейчас недоступен, карточка предупредит: рой не запустится, пока агент не подключён (молча обычной задачей он тоже не запустится).
Запуск
В композере доски выберите чип «Рой», репозиторий и опишите задачу целиком — как ставите её команде. Pulse создаст задачу, по сессии на каждую роль и запустит только архитектора; остальные ждут.
Протокол
Архитектор получает бриф: роль, состав роя, ваша задача, заметки задачи, выдержка из памяти репозитория, подсказки подключённых MCP-серверов.
Он осматривает код и раздаёт задания блоком:
frontend: Перевести LoginForm на общие компоненты из src/ui security: Проверить хранение токенов, ничего не править — только отчёт tester: Покрыть форму входа тестами и прогнать npm testPulse разбирает блок и отправляет каждому участнику его задание. Участник, который ещё не стартовал, получает первый ход с ролью, задачей и контекстом.
Участник работает и заканчивает ход отчётом. Отчёт — это текст после последнего вызова инструмента; он уходит архитектору.
Когда все задания закрыты, архитектор подводит итог. Итог дописывается в память репозитория — следующие задачи начнут с этим знанием.
В колонке сессий задачи видно всё: роли, кто ведущий, чьё задание в работе, чей отчёт отправлен, сколько волн прошло. Кнопка «Граф роя» открывает граф задачи.
Рой на графе: кто кого ждёт
Граф задачи показывает работу роя (решение 0063):
- Узел участника называет причину ожидания словом: «ждёт задание · роль» (тихая полоса), «ждёт вашего ответа», «ждёт разрешения», «ждёт входа агента» (полоса цвета внимания дышит), «готов к запуску». Закрытый шаг подписан исходом: «успех», «неудача», «пропущен», «остановлен».
- Узел «ЗАДАНИЕ» стоит у каждого задания между участником и его ходами: номер и текст задания, знак агента, состояние и исход, ход, попытка, длительность и слово «отчёт», если он пришёл.
- Рёбра выполнения между заданиями показывают, кто кого ждёт: ждёт — тихая линия, управление передано идущему заданию — бегущий поток, оба закрыты — зелёная, не дошло — красная рваная. Условие на ребре одно — «при успехе».
- Колонки участников стоят по зависимостям их заданий; ведущий — первым. Легенда в углу холста объясняет разделы «Связи выполнения» и «Исход задания».
Зависимости есть у заданий, которые архитектор раздал командой swarm.assign с deps; у блока pulse-assign
их нет, и рёбер у такого роя не будет. Ответить и разрешить с узла задания пока нельзя — это делается на узле
участника и в «Требует внимания». Узел «ЗАПУСК» над задачами, ворота приёмки и ответ с узла задания — в работе.
Свои worktree у разработчиков
Роли-разработчики (фронтенд, бэкенд, тестировщик, DevOps) работают каждый в своём
worktree на ветке <ветка задачи>-<роль>. Ревьюеры и архитектор — в worktree задачи.
- Перед заданием ветка задачи вливается в worktree участника (незакоммиченное с обеих сторон сначала коммитится сообщением «рой: …»).
- После отчёта работа участника коммитится и вливается обратно в ветку задачи.
- Конфликт слияния откатывается (
merge --abort), архитектор получает список файлов и просьбу решить, кто правит. В задании и в предпросмотре задачи видно «есть конфликт слияния». - Порог перед слиянием (Настройки → Качество): можно требовать, чтобы ветка участника вливалась только после проверки инспектором и при оценке не ниже заданной. Иначе работа остаётся у участника, а архитектор получает объяснение. См. Инспекторы качества.
Когда что-то идёт не так
- Участник упал — Pulse повторяет его задание (до двух попыток, с пометкой «прошлая попытка оборвалась»), сессия перезапускается сама. После второй неудачи задание помечается провалённым, архитектор получает сообщение.
- Участник завис — задание без отчёта дольше 20 минут прерывается и считается сбоем: дальше работает та же логика повтора.
- Нужно вмешаться вручную — кнопка «Дать задание» у участника в колонке сессий отправляет ему задание напрямую от вас; отчёт всё равно вернётся архитектору.
- Рой на паузе. После перезапуска приложения, отмены задачи или «Стоп» в сессии роя задания не рассылаются, на узле графа и в колонке сессий видно «Рой на паузе» и сколько заданий ждут отправки. «Продолжить рой» снова разрешает архитектору раздавать задания; то, что он раздал на паузе, он повторит по вашей просьбе. Задание, по которому участник уже отчитался до перезапуска, не отменяется: Pulse доводит слияние его работы. Задание, чьи предшественники остановлены, упали или отменены, после перезапуска не ждёт их вечно, а получает исход.
Инспекторы в рое
Роли-инспекторы работают на самой сильной доступной модели и оценивают работу остальных: оценка по шести осям, находки и корректировка автору. Отчёт уходит архитектору, как у любого ревьюера, и он решает, кому раздать правки. Подробнее — Инспекторы качества.
Ограничения
- Задания раздаёт архитектор; вы можете дать задание участнику вручную, но роль «раздающего» одна.
- Отчётом считается последний текст хода участника — если модель заканчивает ход вызовом инструмента без слов, отчёт будет пустым.
- Рой считает волны: одна волна — один блок заданий и все отчёты по нему.
Состояние decision-слоя автономного роя 24/7
Пакеты packages/pulse-* и apps/pulse-server развивают отдельный автономный рой 24/7.
Описанный выше рой в окне Pulse не использует их decision-слой. В packages/pulse-core
реализованы интерфейс DecisionEngine, детерминированный rulesEngine, обёртка
loggingEngine, запись в pulse.decisions и расчёт rulesCoverage. Это проверяемые
компоненты библиотеки; к исполнению инструментов они не подключены.
packages/pulse-agents/src/runner.ts пока собирает контекст роли, а runRoleTurn делает
один запрос к модели и возвращает текст. Реализации AgentExecutor с вызовами
инструментов нет; очередь предоставляет beforeToolCall, но рабочий диспетчер
его ещё не вызывает. Флаг requiresGate в реестре ролей только объявлен;
модуля gate в packages/pulse-guard нет. Рабочие ходы не записывают решения в
pulse.decisions, метрика покрытия правилами не отражает их выполнение, а ошибка
DECISION_ESCALATION не возникает из этого слоя.
Пока не реализована задача #125, правила §5 не являются работающей защитой перед исполнением инструментов. Автономный рой 24/7 не готов к запуску с инструментами.