Аддон 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 плану до того, як відповідь буде використано, і відповідає події журналу v7 delegation.
Результати залишаються твердженнями до перевірки. Відповідь 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; заплануйте перший запуск під наглядом.