Аддон Herdr
Herdr размещает агентов для программирования в панелях — на вашей машине и на машинах, до которых он дотягивается по SSH. Этот аддон позволяет Deep Work Plan использовать этих агентов как peer-агентов: план может передать ограниченную задачу агенту в другой панели, получить ровно один авторизованный ответ и сохранить запись этого обмена.
Это опциональный аддон DWP v7 (pack v7.9.0). Методология работает так же и без него: если аддон отсутствует или отключён, каждая задача выполняется в текущей сессии, как и раньше.
Что он интегрирует
Аддон — тонкий интегратор. Работу выполняет herdr-peers — самостоятельный навык под лицензией MIT, закреплённый на v1.1.0 и полезный и без Deep Work Plan. Он определяет то, что сам Herdr оставляет открытым: кто может отвечать, как ответ возвращается между машинами, как двум агентам избежать бесконечных ответов друг другу и где хранится запись «я спросил, он ответил».
| Элемент | Значение |
|---|---|
| Продукт | DailybotHQ/herdr-peers, тег v1.1.0, протокол 1 |
| Ключ реестра | herdr в .dwp/config.json |
| Транспорт | интерактивный: peer-агент в панели Herdr |
| Предоставляет | subagents, cancel_children |
| Требует | разрешения agent_delegation в контракте плана |
Стабилен начиная с v1.0.0. Публичный интерфейс следует семантическому версионированию: глаголы CLI и их документированные флаги, коды выхода 0–7, документированные переменные HERDR_PEERS_*, DWP_PLAN и DWP_TASK, протокол 1, а также JSON-контракты herdr-peers/lanes-v1, herdr-peers/lead-v1 и запись делегирования. Несовместимое изменение любого из них повышает мажорную версию, а изменение формата передачи также повышает номер протокола. v1.0.0 не меняет никакого поведения по сравнению с v0.3.3, и релизы 0.x больше не поддерживаются.
Установка
Установите herdr-peers и официальный навык Herdr, от которого он зависит. Каждой машине, агенты которой должны отвечать, этот навык тоже нужен.
npx --yes skills add https://github.com/DailybotHQ/herdr-peers/tree/v1.1.0 --skill herdr-peers -g -y
npx --yes skills add https://github.com/herdrdev/herdr/tree/v0.9.3 --skill herdr -g -y
Требования: Herdr 0.9.1 или новее, bash и python3 3.9 или новее (только стандартная библиотека). Онбординг предлагает аддон и фиксирует ваш ответ в реестре аддонов; без согласия он никогда не включается.
Что он добавляет в план
- Делегирование peer-агенту. В плане v7, контракт которого предоставляет
agent_delegation,executeможет передать задачуparallel_safeили вопрос только для чтения агенту в другой панели — на этой или другой машине. - Один авторизованный ответ. Запрос несёт штамп, который авторизует ровно один ответ. Peer-агент отвечает один раз через helper, и ответ несёт собственный штамп.
- Запись до использования. Каждое делегирование записывается в
analysis_results/delegations.ndjsonплана до того, как ответ будет использован, и соответствует событию журнала v7delegation. - Результаты остаются утверждениями до проверки. Ответ peer-агента является доказательством
asserted, пока собственный gate runner плана его не зафиксирует. Он никогда сам не закрывает задачу.
Модель безопасности
| Правило | Что оно означает |
|---|---|
| Сначала разрешение | Делегирование выполняется только тогда, когда контракт плана предоставляет agent_delegation. |
| Лимит глубины 1 | На сообщение со штампом depth=1 или reply-to= никогда не отвечают, а делегат никогда не делегирует дальше. |
| Ограничение fan-out | По умолчанию не более четырёх peer-агентов на одного инициатора. |
| Данные, а не инструкции | Ответ никогда не даёт полномочий, которых у получателя ещё не было. |
| Один писатель на путь | Peer-агент, который пишет, работает в собственном git worktree. |
herdr-peers не аутентифицирует отправителя: поле from= в штампе — лишь утверждение. Мерой защиты служит allow-list HERDR_PEERS_SCOPE, который ограничивает рабочие пространства и машины, принимаемые peer-агентом.
Контейнеры и хост
С аддоном devcontainer на devcontainer-kit v1.1.1 каждый контейнер dck поставляется с herdr-peers и присоединяется к сети при dck up: его агенты могут обращаться к агентам на хосте, в других контейнерах и в других loopback-контейнерах хоста и получать ответ. dck setup устанавливает проверенный herdr-peers на хост, поэтому агенты хоста тоже отвечают. Listener на хосте и дополнительные ключи, которые впускают другие контейнеры, — ваши решения в профиле хоста kit; этот аддон никогда их не задаёт. Начиная с herdr-peers (v0.2.3), каждая машина хранит собственное состояние ($XDG_STATE_HOME/herdr-peers/<server>/), поэтому рабочая копия, общая для хоста и контейнера, больше не смешивает их записи, а начиная с devcontainer-kit (v0.3.3) контейнер сам экспортирует HERDR_PEERS_SELF, так что агенты Codex внутри него обращаются к другим машинам без ручных шагов.
Herdr или agentkit
Оба аддона реализуют один и тот же интерфейс делегирования — launch, observe, collect, cancel — с разными транспортами.
| Ситуация | Использовать |
|---|---|
Ограниченная задача parallel_safe с объявленным результатом |
agentkit (headless ak run в worktree) |
| Задача требует взаимодействия, выполняется долго или находится на другой машине | Herdr (peer-агент в панели) |
Если ведущий агент ведёт множество линий одновременно — панели на хосте, в контейнерах и на других машинах, каждая на собственной учётной записи, — herdr-peers lanes показывает каждую линию с её состоянием, herdr-peers status <pane> классифицирует экран, на котором стоит заблокированная линия, а каждая запись делегирования называет учётную запись и поставщика, которые её выполнили. См. Запуск множества агентов.
Каждый лейн называет свою панель. Согласно правилам автономии роя (Guide §17.2), каждый лейн передает свою панель с помощью в каждом глаголе herdr-peers (, , , , , , ), чтобы предотвратить ошибочную атрибуцию сообщений и насыщение слотов. Лейны Codex требуют этого особенно строго из-за общего фонового сервера между сессиями.
Уведомления и лидерство
herdr-peers (v0.3.2) добавляет то, что позволяет рою пережить своего ведущего агента (Автономия роя):
- Уведомления.
herdr-peers notify <addr|lead> "<text>" --pane <pane>отправляет одностороннее сообщение со штампомreply=no.checkполучателя классифицирует его как уведомление, записывает как данные и никогда не отвечает. Уведомления не занимают слот fan-out и могут отправляться, пока открыт запрос; используйте их для объявлений о передаче работы, смене ведущего агента и рассылок о релизах. - Запись ведущего агента для каждого плана.
herdr-peers lead claim --plan <P> --succession <A,B> --lanes <A,B>делает агента ведущим одного плана;lead showвыводит запись (схемаherdr-peers/lead-v1: план, ведущий агент, эпоха, порядок преемственности, линии, время обновления).lead handover <addr> --plan <P>передаёт лидерство,lead takeover --plan <P>позволяет первому доступному заместителю принять его, когда ведущий агент пропал, аlead release --plan <P>завершает его. Каждое изменение повышает эпоху и уведомляет каждую линию. Делайте claim плана до запуска его линий:leadразрешается, только когда запись существует. Начиная сv0.3.2запись хранит локально репозиторий, сделавший claim, и отклоняет claim того же id плана из другого репозитория; называйте такой план--plan <repo>/<id>. - Ограждение (fencing). Линия принимает уведомление ведущего агента только от агента, который дал ей задание (первый claim), от текущего ведущего агента на следующей эпохе (handover) или от первой доступной записи в порядке преемственности на следующей эпохе (takeover). Всё остальное записывается и игнорируется, а вернувшийся ведущий агент, который видит более высокую эпоху, уходит в сторону.
- Адрес
lead.ask lead …иnotify lead …разрешаются в текущего ведущего агента плана--plan(иначе$DWP_PLAN), поэтому ни одно задание линии не прописывает панель ведущего агента жёстко. - Экраны
usage_limit.statusиlanesраспознают сообщение CLI о лимите использования как класс экранаusage_limit, следующий шаг для которого — передача работы. На него никогда не отвечают клавишами.lanes --jsonдобавляет план, его ведущего агента, эпоху и последний сообщённый запас каждой линии.
Линии также могут спрашивать друг друга об информации и координации — интерфейс, имя флага, состояние ветки, — но работу назначает только ведущий агент. Глубина 1 и ограничение fan-out по-прежнему действуют. В v0.2.x нет ни уведомлений, ни записей ведущего агента: линии отправляют запросы по адресу ведущего агента из своего задания, а о смене ведущего агента сообщает разработчик.
Дебаты
herdr-peers 1.1.0 добавляет встроенный подскилл debate (debate.md): ведущий агент проводит панель пиров в панелях Herdr через раунды и завершает её одним результатом, которому человек может доверять, вместе с доказательствами и особыми мнениями. Используйте его только тогда, когда человек просит дебаты, панель, красную команду, исследование силами нескольких агентов или с нескольких точек зрения либо вторую панель по результату; мнение одного агента — это один ask.
- Сначала цель. Ведущий выбирает цель — решить, исследовать современное состояние области, провести стресс-тест, проверить или сгенерировать — и у каждой свои форматы, свой подсчёт и свой итоговый документ. Цели можно выстраивать в цепочку (исследовать → решить, решить → проверить), а масштаб дебатов бывает быстрым, стандартным или глубоким.
- Обязательства ведущего. Ведущий никогда не голосует; слова человека переносятся дословно; брифы попадают к панели по одному каналу; каждая панель записывает позицию на диск и отвечает одной строкой; ни одна панель не совершает внешних действий.
- Форматы. Исследование по ракурсам, классические раунды, пакет черновика, перекрёстный допрос по каждому утверждению, сначала красная команда, потом защитники, сначала steelman, потом суждение, слепой вызов со свежим контекстом, панель репликации и расходящиеся предложения. Решение всегда завершается заданным набором вердиктов.
- Команда
herdr-peers debate.tallyподсчитывает ранжированные бюллетени и вердикты по пунктам (Борда, Копленд, попарные дуэли, победитель и проигравший по Кондорсе);claimsсводит реестры утверждений от линий в статусы вроде «установлено», «оспаривается» или «опровергнуто» — это кворум, а не проверка;anonкопирует позиции под анонимными именами, а соответствие хранит в закрытом ключе;filingsперечисляет поданные, отсутствующие и слишком короткие позиции, чтобы повторно опрашивать только недостающие панели. - Состав панели.
panelпредлагает панель и ничего не запускает. Места распределяются по кругу между поставщиками моделей, а внутри поставщика первым идёт место с наибольшей квотой — из свободных панелей и, если установлен agentkit (ak), из аккаунтов, которые предлагаетak pick. Безakрекомендуется coding-agents-kit (необязательно,v1.0.1или новее). - Шаблоны. Шестнадцать шаблонов в
templates/debate/— от заметки человека и брифов исследования, стресс-теста и раундов до файлов бюллетеней и утверждений, пакета передачи дел ведущего и записей решения, состояния области, стресс-теста и репликации. - Доставка заблокированному пиру.
replyиnotifyповторяют доставку пиру, остановившемуся на вопросе, до--wait-blockedсекунд; ответ по-прежнему ровно один.
Релиз только дополняет: протокол 1 и все команды, флаги, коды выхода и JSON-контракты не меняются.
Примечания
Опционален и никогда не обязателен. Репозиторий без опциональных аддонов полностью соответствует требованиям, и ни один поток не зависит от этого аддона. Полный цикл между двумя панелями и машинами покрыт тестами на симулированном Herdr; запланируйте первый запуск под наблюдением.