Рой агентов

Задача — команде.
Разговор — с архитектором

Рой — именованный состав ролей, который запускается на репозиторий одной кнопкой. Архитектор изучает код, раздаёт задания, собирает отчёты и подводит итог. Разработчики работают каждый в своей рабочей копии, ревьюеры ничего не правят, инспекторы оценивают результат. Итог уходит в память репозитория — следующая задача начнёт с этим знанием.

11 ролей 4 готовых состава worktree на разработчика автоповторы · таймаут 20 мин
Задача-рой: колонка ролей с заданиями и отчётами, чат архитектора, заметки и память репозитория 1 2 3 4
  • 1Колонка «Рой» — роли, кто ведущий, у кого своя рабочая копия, чей отчёт уже отправлен, сколько прошло волн.
  • 2Отчёты участников приходят архитектору в чат: видно, кто отчитался и по какому заданию.
  • 3Итог архитектора — что сделано, что решено и что вынесено в отдельную задачу. Отсюда он уходит в память репозитория.
  • 4Заметки задачи и память репозитория — контекст, который получает первым ходом каждый участник роя.
Роли

Одиннадцать ролей трёх видов

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

Ведущий

Архитектор

Единственный, кто говорит с вами. Изучает репозиторий, разбивает работу, раздаёт задания, сводит отчёты, пишет итог в память.

Разработчик

Фронтенд-разработчик

Интерфейс и клиентский код. Своя рабочая копия на ветке <задача>-frontend.

Разработчик

Бэкенд-разработчик

Сервер, API, данные. Своя рабочая копия, слияние в ветку задачи после отчёта.

Разработчик

Тестировщик

Пишет и гоняет тесты. Отчёт — что покрыто, что упало, что не воспроизвелось.

Разработчик

DevOps

Сборка, CI, окружение. Всё, что не код приложения, но без чего он не поедет.

Ревьюер

Аналитик

Разбирает требования и данные, ничего не правит. Его отчёт — уточнённая постановка.

Ревьюер

Безопасность

Ищет риски, секреты, небезопасные вызовы. Только отчёт — править ему нельзя.

Ревьюер

Продукт

Смотрит на задачу глазами пользователя: что непонятно, что лишнее, чего не хватает.

Инспектор

Инспектор фронтенда

Оценивает клиентский код других агентов по шести осям. Работает на самой сильной модели.

Инспектор

Инспектор бэкенда

То же для серверного кода: оценка, находки «файл:строка», корректировка автору.

Инспектор

Инспектор качества

Общая оценка изменения вне деления на фронт и бэк. Выбирается по составу файлов.

Составы

Четыре готовых — и свой

В «Настройки → Рой» кнопки собирают состав одним кликом. «Новый рой» — свой: роли, для каждой агент и модель, ведущий, инструкции с историей версий. Если у роли выбран агент, который сейчас недоступен, карточка предупредит.

Полный рой

Все восемь базовых ролей. Для задач, которые трогают и интерфейс, и сервер, и инфраструктуру.

АрхитекторАналитикФронтендБэкендБезопасностьПродуктТестировщикDevOps

С инспекцией

Разработка под надзором: двое пишут, двое оценивают. Отчёты инспекторов возвращаются архитектору и влияют на следующую волну правок.

АрхитекторФронтендБэкендИнспектор фронтендаИнспектор бэкенда

Разработка

Минимум для фичи: постановка, две руки, тесты. Быстро и дёшево.

АрхитекторФронтендБэкендТестировщик

Аудит

Никто ничего не правит: только отчёты. Для проверки чужого кода, приёмки и разбора инцидентов.

АрхитекторАналитикБезопасностьПродукт
Протокол

Пять шагов одной волны

Волна — один блок заданий и все отчёты по нему. Рой считает волны; обычно хватает двух-трёх.

  1. Архитектор получает бриф

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

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

    Блоком pulse-assign — по строке на роль. Pulse понимает id ролей, русские подписи, @роль и продолжение на следующих строках.

  3. Участники получают задания

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

  4. Работают и отчитываются

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

  5. Архитектор подводит итог

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

# так архитектор раздаёт задания
 
```pulse-assign
frontend: Перевести LoginForm на общие
  компоненты из src/ui, не трогать роутинг
security: Проверить хранение токенов,
  ничего не править — только отчёт
tester: Покрыть форму входа тестами
  и прогнать npm test
```
# ветки одной задачи-роя
 
pulse/a41c ← ветка задачи, worktree архитектора
├─ pulse/a41c-frontend ← своя копия, вливается после отчёта
├─ pulse/a41c-backend
└─ pulse/a41c-tester
 
# ревьюеры и инспекторы работают
# в worktree задачи: им нечего вливать

Незакоммиченное с обеих сторон сначала коммитится сообщением «рой: …». Конфликт слияния откатывается (merge --abort), архитектор получает список файлов и просьбу решить, кто правит. В задании и в превью задачи видно «есть конфликт слияния».

Когда что-то идёт не так

Рой не ждёт вас, чтобы починиться

упал

Участник упал

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

завис

Участник завис

Задание без отчёта дольше 20 минут прерывается и считается сбоем. Дальше работает та же логика повтора. Сторож проверяет задания по таймеру, а не по событию — зависание не может остаться незамеченным.

конфликт

Конфликт слияния

Слияние откатывается, задание помечается, архитектор получает список файлов и решает, кто правит. Ветки участников остаются — ничего не теряется.

вручную

Нужно вмешаться

Кнопка ✈ у участника в колонке «Рой» отправляет ему задание напрямую от вас. Отчёт всё равно вернётся архитектору — единственный раздающий по-прежнему он.

На графе

Кто работает, кто отчитался, у кого ошибка

Сессии ролей расходятся от задачи, у каждой свои ходы и вызовы. Ноды светятся по состоянию, дорожка задачи окрашивает всех участников. Справа — чат архитектора: видно, как он раздал задания и что ответил на отчёты.

  • Таймлайн внизу перематывает рой на любой момент: что каждый знал на второй волне.
  • Стоимость роя видна по сессиям и суммой в чипе задачи; бюджет задачи действует на всех участников.
Граф роя: задача → ведущий архитектор и участники → их ходы и записи файлов
Рой на графе задачи
Инспекторы в рое

Ревью встроено в волну

Добавьте в состав «Инспектора фронтенда» и «Инспектора бэкенда» — готовый состав «С инспекцией». Архитектор даёт им задания наравне с остальными, их отчёты с оценкой по шести осям и находками возвращаются ему и влияют на следующую волну правок. Инспектор работает на самой сильной доступной модели и не может править ничего — по политике роли.

  • Оценки копятся в «Настройки → Качество»: со временем видно, какой агент в какой роли пишет лучше.
  • Корректировка от инспектора — готовая правка в инструкцию участника на следующий рой.
Настройки → Рой: состав ролей с агентом и моделью у каждой, кнопки готовых составов
Настройки → Рой
Когда рой не нужен

Один агент дешевле, если задача одна

Рой имеет смысл на задачах, которые разбиваются на части: интерфейс + сервер + тесты, или «проверить чужой код с трёх сторон». На правке одного файла хватит одного агента — рой только добавит волн и стоимости. Хорошая эвристика: если вы не смогли бы раздать задачу трём людям, не давайте её и трём агентам.

Ограничения сегодня

Что стоит знать заранее

  • Задания раздаёт только архитектор; вы можете дать задание участнику вручную, но раздающий один.
  • Отчётом считается последний текст хода — если модель заканчивает ход вызовом инструмента без слов, отчёт будет пустым. Инструкции ролей об этом напоминают.
  • Участники не видят транскрипты друг друга — только задания и отчёты через архитектора. Общая память и заметки задачи компенсируют это.
Дальше

Соберите свой первый рой

Один клик в «Настройки → Рой», один промпт в композере — и архитектор уже осматривает ваш репозиторий.