Рой агентов

Сверено с выпуском 0.36.0, 14.11.2026.

Рой — именованный состав ролей, который запускается на репозиторий одной кнопкой. С вами общается только архитектор: он изучает код, раздаёт задания участникам, собирает их отчёты и подводит итог.

Роли

Ведущий — архитектор: единственный, кто говорит с вами. Остальные роли либо правят код (строят), либо только читают (думают и проверяют). У каждой роли Pulse есть персона — фамилия человека из истории космоса, вычислительных машин или фантастики о космосе. Персона — имя и подсказка «кто это и почему эта роль», а не маска: в инструкцию агенту она не попадает. В компактных местах (колонка роя, узел графа) видна фамилия, роль — в подсказке. Выключить имена можно в Настройки → Рой → «Имена участникам».

Роль Персона Работа с кодом Что делает
Архитектор Королёв ведущий общается с вами, видит архитектуру целиком, раздаёт задания и сводит отчёты
Фронтенд-разработчик Энгельбарт правит код интерфейс и клиентский код в стиле проекта, с проверкой сборки
Бэкенд-разработчик Ритчи правит код API, сервисы, данные; правит только серверную часть
DevOps Тесла правит код сборка, CI, конфигурация, окружения
Тестировщик Гагарин правит код пишет и прогоняет тесты, ищет регрессии
Документация Азимов правит код пишет и правит документацию проекта; код не трогает
Аналитик Лавлейс только читает требования, сценарии, критерии приёмки
Продукт Циолковский только читает качество с точки зрения пользователя и ценности
Безопасность Тьюринг только читает уязвимости, секреты, доступы
Приёмщик Келдыш только читает сверяет сделанное с критериями приёмки до «готово»
Инспектор бэкенда фон Нейман только читает оценивает серверный код, который написали другие агенты
Инспектор фронтенда Кубрик только читает оценивает клиентский код, который написали другие агенты
Инспектор качества Лем только читает общая инспекция кода и тестов
Исследователь Кларк только читает изучает варианты, эталоны и первоисточники до решения
Данные Шеннон только читает схемы, миграции, запросы и целостность данных
Дизайнер интерфейса Лоуи только читает путь человека, вид и состояния экранов по дизайн-системе

Роли, которые только читают, не могут править файлы и запускать команды — это держит политика на уровне роли, независимо от режима и настроек (см. Контроль).

Роли и персоны в настройках

Настройки → Рой → вкладка «Роли и персоны» — таблица всех ролей: роль, персона, принцип («строит» или «думает и проверяет»), правит ли код, агент и модель, состояние («как у Pulse», «изменено» или «своя»). Щелчок по строке открывает карточку роли:

  • Роль — название, строка «что делает», работа с кодом («Правит код» или «Только читает»; для новых запусков, идущие сессии сохраняют вид, с которым запущены);
  • Инструкция — текст для агента, со списком ваших версий и «Вернуть инструкцию как у Pulse»;
  • Агент и модель — кого получит новый участник с этой ролью; участник в составе может отступить от роли, его выбор сильнее;
  • Права — что держит Pulse и что держит только инструкция;
  • Наблюдаемость — задания и исходы роли из запущенных роёв и составы, где роль стоит.

«Новая роль» заводит свою роль с нуля, «Сделать копию» — свою роль с инструкцией выбранной. «Вернуть как у Pulse» возвращает умолчание, «Удалить роль» — только у своей роли, которой нет в составах. Открыть карточку можно и с графа: меню узла участника → «Настроить роль…», и из меню его сессии в колонке.

Собрать состав

Настройки → Рой → вкладка «Составы»:

  • кнопки «Собрать: Полный рой / С инспекцией / Разработка / Аудит» создают готовый состав одним кликом («С инспекцией» — архитектор, фронтенд, бэкенд, инспектор фронтенда и инспектор бэкенда);
  • «Новый рой» — свой: выбираете роли, для каждой агента и модель, назначаете ведущего, при необходимости правите инструкцию роли (у неё своя история версий);
  • если у роли выбран агент, который сейчас недоступен, карточка предупредит: рой не запустится, пока агент не подключён (молча обычной задачей он тоже не запустится).

Запуск

В композере доски выберите чип «Рой», репозиторий и опишите задачу целиком — как ставите её команде. Pulse создаст задачу, по сессии на каждую роль и запустит только архитектора; остальные ждут.

Протокол

  1. Архитектор получает бриф: роль, состав роя, ваша задача, заметки задачи, выдержка из памяти репозитория, подсказки подключённых MCP-серверов.

  2. Он осматривает код и раздаёт задания блоком:

    frontend: Перевести LoginForm на общие компоненты из src/ui
    security: Проверить хранение токенов, ничего не править — только отчёт
    tester: Покрыть форму входа тестами и прогнать npm test
  3. Pulse разбирает блок и отправляет каждому участнику его задание. Участник, который ещё не стартовал, получает первый ход с ролью, задачей и контекстом.

  4. Участник работает и заканчивает ход отчётом. Отчёт — это текст после последнего вызова инструмента; он уходит архитектору.

  5. Когда все задания закрыты, архитектор подводит итог. Итог дописывается в память репозитория — следующие задачи начнут с этим знанием.

В колонке сессий задачи видно всё: роли, кто ведущий, чьё задание в работе, чей отчёт отправлен, сколько волн прошло. Кнопка «Граф роя» открывает граф задачи.

Рой на графе: кто кого ждёт

Граф задачи показывает работу роя (решение 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 не готов к запуску с инструментами.