Аддон Herdr
Herdr размещает агентов для программирования в панелях — на вашей машине и на машинах, до которых он дотягивается по SSH. Этот аддон позволяет Deep Work Plan использовать этих агентов как peer-агентов: план может передать ограниченную задачу агенту в другой панели, получить ровно один авторизованный ответ и сохранить запись этого обмена.
Это опциональный аддон DWP v7 (v7.0.0). Методология работает так же и без него: если аддон отсутствует или отключён, каждая задача выполняется в текущей сессии, как и раньше.
Что он интегрирует
Аддон — тонкий интегратор. Работу выполняет herdr-peers — самостоятельный навык под лицензией MIT, закреплённый на v0.1.0 и полезный и без Deep Work Plan. Он определяет то, что сам Herdr оставляет открытым: кто может отвечать, как ответ возвращается между машинами, как двум агентам избежать бесконечных ответов друг другу и где хранится запись «я спросил, он ответил».
| Элемент | Значение |
|---|---|
| Продукт | DailybotHQ/herdr-peers, тег v0.1.0, протокол 1 |
| Ключ реестра | herdr в .dwp/config.json |
| Транспорт | интерактивный: peer-агент в панели Herdr |
| Предоставляет | subagents, cancel_children |
| Требует | разрешения agent_delegation в контракте плана |
Установка
Установите herdr-peers и официальный навык Herdr, от которого он зависит. Каждой машине, агенты которой должны отвечать, этот навык тоже нужен.
npx --yes skills add https://github.com/DailybotHQ/herdr-peers/tree/v0.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-агентом.
Herdr или agentkit
Оба аддона реализуют один и тот же интерфейс делегирования — launch, observe, collect, cancel — с разными транспортами.
| Ситуация | Использовать |
|---|---|
Ограниченная задача parallel_safe с объявленным результатом |
agentkit (headless ak run в worktree) |
| Задача требует взаимодействия, выполняется долго или находится на другой машине | Herdr (peer-агент в панели) |
Примечания
Опционален и никогда не обязателен. Репозиторий без опциональных аддонов полностью соответствует требованиям, и ни один поток не зависит от этого аддона. Полный цикл между двумя панелями и машинами покрыт тестами на симулированном Herdr; запланируйте первый запуск под наблюдением.