Addon Herdr
Herdr umieszcza agentów kodujących w panelach, na Twojej maszynie i na maszynach, do których dociera przez SSH. Ten addon pozwala Deep Work Plan używać tych agentów jako peerów: plan może przekazać ograniczone zadanie agentowi w innym panelu, otrzymać dokładnie jedną autoryzowaną odpowiedź i zachować zapis tej wymiany.
Jest to opcjonalny addon DWP v7 (pack v7.9.0). Metodyka działa bez niego tak samo: gdy addonu brak lub jest wyłączony, każde zadanie wykonuje się w bieżącej sesji, dokładnie jak dotąd.
Co integruje
Addon jest cienkim integratorem. Pracę wykonuje herdr-peers, samodzielny skill na licencji MIT przypięty do v1.1.0, użyteczny także bez Deep Work Plan. Definiuje to, co sam Herdr pozostawia otwarte: kto może odpowiedzieć, jak odpowiedź wraca między maszynami, jak dwaj agenci unikają odpowiadania sobie nawzajem bez końca i gdzie znajduje się zapis „zapytałem, odpowiedział”.
| Element | Wartość |
|---|---|
| Produkt | DailybotHQ/herdr-peers, tag v1.1.0, protokół 1 |
| Klucz rejestru | herdr w .dwp/config.json |
| Transport | interaktywny: peer w panelu Herdr |
| Zapewnia | subagents, cancel_children |
| Wymaga | uprawnienia agent_delegation w kontrakcie planu |
Stabilny od v1.0.0. Publiczny interfejs stosuje wersjonowanie semantyczne: czasowniki CLI i ich udokumentowane flagi, kody wyjścia 0–7, udokumentowane zmienne HERDR_PEERS_*, DWP_PLAN i DWP_TASK, protokół 1 oraz kontrakty JSON herdr-peers/lanes-v1, herdr-peers/lead-v1 i rekord delegowania. Niekompatybilna zmiana któregokolwiek z nich podnosi wersję główną, a zmiana formatu przesyłu podnosi także numer protokołu. v1.0.0 nie zmienia żadnego zachowania względem v0.3.3, a wydania 0.x nie są już wspierane.
Instalacja
Zainstaluj herdr-peers oraz oficjalny skill Herdr, od którego zależy. Każda maszyna, której agenci mają odpowiadać, również potrzebuje tego skilla.
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
Wymagania: Herdr 0.9.1 lub nowszy, bash oraz python3 3.9 lub nowszy (tylko biblioteka standardowa). Onboarding proponuje addon i zapisuje Twoją odpowiedź w rejestrze addonów; nigdy nie jest on włączany bez zgody.
Co dodaje do planu
- Delegowanie do peera. W planie v7, którego kontrakt przyznaje
agent_delegation,executemoże przekazać zadanieparallel_safelub pytanie tylko do odczytu agentowi w innym panelu, na tej samej lub innej maszynie. - Jedna autoryzowana odpowiedź. Żądanie niesie stempel, który autoryzuje dokładnie jedną odpowiedź. Peer odpowiada raz przez helper, a odpowiedź niesie własny stempel.
- Zapis przed użyciem. Każde delegowanie jest zapisywane w
analysis_results/delegations.ndjsonplanu, zanim odpowiedź zostanie użyta, i odpowiada zdarzeniu dziennika v7delegation. - Wyniki pozostają twierdzeniami do czasu sprawdzenia. Odpowiedź peera jest dowodem
asserted, dopóki własny gate runner planu jej nie zaobserwuje. Nigdy sama nie zamyka zadania.
Model bezpieczeństwa
| Reguła | Co oznacza |
|---|---|
| Najpierw uprawnienie | Delegowanie działa tylko wtedy, gdy kontrakt planu przyznaje agent_delegation. |
| Limit głębokości 1 | Wiadomość ze stemplem depth=1 lub reply-to= nigdy nie otrzymuje odpowiedzi, a delegat nigdy nie deleguje dalej. |
| Limit fan-out | Domyślnie najwyżej czterech peerów na wywołującego. |
| Dane, nie instrukcje | Odpowiedź nigdy nie przyznaje uprawnień, których odbiorca jeszcze nie miał. |
| Jeden zapisujący na ścieżkę | Peer, który zapisuje, pracuje we własnym git worktree. |
herdr-peers nie uwierzytelnia nadawcy: pole from= w stemplu jest twierdzeniem. Środkiem zaradczym jest lista dozwolonych HERDR_PEERS_SCOPE, która ogranicza workspace’y i maszyny akceptowane przez peera.
Kontenery i host
Z addonem devcontainer na devcontainer-kit v1.1.1 każdy kontener dck zawiera herdr-peers i dołącza do sieci przy dck up: jego agenci mogą pytać agentów na hoście, w innych kontenerach i w pozostałych kontenerach loopback hosta, i otrzymać odpowiedź. dck setup instaluje na hoście zweryfikowany herdr-peers, więc agenci hosta także odpowiadają. Listener na hoście i dodatkowe klucze, które wpuszczają inne kontenery, to twoje decyzje w profilu hosta kitu; ten addon nigdy ich nie ustawia. Od herdr-peers (v0.2.3) każda maszyna przechowuje własny stan ($XDG_STATE_HOME/herdr-peers/<server>/), więc checkout współdzielony przez host i kontener nie miesza już ich zapisów, a od devcontainer-kit (v0.3.3) kontener sam eksportuje HERDR_PEERS_SELF, więc agenci Codex wewnątrz docierają do innych maszyn bez ręcznych kroków.
Herdr czy agentkit
Oba addony implementują ten sam interfejs delegowania — launch, observe, collect, cancel — z różnymi transportami.
| Sytuacja | Użyj |
|---|---|
Ograniczone zadanie parallel_safe z zadeklarowanym wynikiem |
agentkit (headless ak run w worktree) |
| Zadanie wymaga interakcji, trwa długo lub działa na innej maszynie | Herdr (peer w panelu) |
Jeśli prowadzący uruchamia wiele torów naraz — panele na hoście, w kontenerach i na innych maszynach, każdy na własnym koncie — herdr-peers lanes wyświetla każdy tor z jego stanem, herdr-peers status <pane> klasyfikuje ekran, na którym stoi zablokowany tor, a każdy zapis delegacji podaje konto i dostawcę, które ją wykonały. Zobacz Uruchamianie wielu agentów.
Każdy lane podaje swój panel. Zgodnie z zasadami autonomii roju (Guide §17.2) każdy lane przekazuje własny panel za pomocą przy każdym czasowniku herdr-peers (, , , , , , ), aby zapobiec błędnemu przypisaniu wiadomości i nasyceniu slotów. Lane’y Codexa wymagają tego szczególnie rygorystycznie ze względu na współdzielenie serwera w tle między sesjami.
Powiadomienia i przywództwo
herdr-peers (v0.3.2) dodaje to, co pozwala rojowi przetrwać swojego prowadzącego (Autonomia roju):
- Powiadomienia.
herdr-peers notify <addr|lead> "<text>" --pane <pane>wysyła jednokierunkową wiadomość ze znacznikiemreply=no.checkodbiorcy klasyfikuje ją jako powiadomienie, zapisuje jako dane i nigdy nie odpowiada. Powiadomienia nie zajmują miejsca w rozgałęzieniu i można je wysyłać, gdy ask jest otwarty; używaj ich do ogłoszeń przekazania, zmian prowadzącego i rozgłaszania wydań. - Rekord prowadzącego na plan.
herdr-peers lead claim --plan <P> --succession <A,B> --lanes <A,B>czyni agenta prowadzącym jednego planu;lead showwypisuje rekord (schematherdr-peers/lead-v1: plan, prowadzący, epoka, sukcesja, tory, czas aktualizacji).lead handover <addr> --plan <P>przekazuje przywództwo dalej,lead takeover --plan <P>pozwala pierwszemu osiągalnemu zastępcy je przejąć, gdy prowadzącego zabraknie, alead release --plan <P>je kończy. Każda zmiana podnosi epokę i powiadamia każdy tor. Obejmij plan przed uruchomieniem jego torów:leadrozwiązuje się dopiero, gdy istnieje rekord. Odv0.3.2rekord przechowuje lokalnie repozytorium, które objęło plan, i odrzuca objęcie tego samego identyfikatora planu z innego repozytorium; nazwij taki plan--plan <repo>/<id>. - Odgradzanie (fencing). Tor przyjmuje powiadomienie prowadzącego tylko od agenta, który go zlecił (pierwsze objęcie), od bieżącego prowadzącego w następnej epoce (przekazanie) albo od pierwszego osiągalnego wpisu sukcesji w następnej epoce (przejęcie). Wszystko inne jest zapisywane i ignorowane, a powracający prowadzący, który widzi wyższą epokę, ustępuje.
- Adres
lead.ask lead …inotify lead …wskazują bieżącego prowadzącego planu z--plan(w przeciwnym razie$DWP_PLAN), więc żadne zlecenie toru nie zapisuje na sztywno panelu prowadzącego. - Ekrany
usage_limit.statusilanesrozpoznają komunikat limitu zużycia CLI jako klasę ekranuusage_limit, której następnym krokiem jest przekazanie. Nigdy nie odpowiada się na nią klawiszami.lanes --jsondodaje plan, jego prowadzącego, epokę i ostatnio zgłoszoną pojemność każdego toru.
Tory mogą też prosić się nawzajem o informacje i koordynację — interfejs, nazwę flagi, stan gałęzi — ale tylko prowadzący przydziela pracę. Głębokość jeden i limit rozgałęzienia nadal obowiązują. W v0.2.x nie ma powiadomień ani rekordów prowadzącego: tory pytają adres prowadzącego ze swojego zlecenia, a zmianę prowadzącego przekazuje deweloper.
Debaty
herdr-peers 1.1.0 dodaje natywny podskill debate (debate.md): agent prowadzący przeprowadza panel peerów w panelach Herdr przez kolejne rundy i kończy jednym wynikiem, któremu człowiek może zaufać, wraz z dowodami i zdaniami odrębnymi. Używaj go tylko wtedy, gdy człowiek prosi o debatę, panel, red team, research z udziałem wielu agentów lub z wielu perspektyw albo drugi panel w sprawie wyniku; opinia jednego agenta to jedno zapytanie.
- Najpierw cel. Prowadzący wybiera cel — zdecydować, zbadać stan wiedzy, przeprowadzić test obciążeniowy, zweryfikować lub wygenerować — a każdy ma swoje formaty, sposób liczenia i dokument wynikowy. Cele można łączyć w łańcuch (zbadać → zdecydować, zdecydować → zweryfikować), a debata ma skalę szybką, standardową lub pogłębioną.
- Zobowiązania prowadzącego. Prowadzący nigdy nie głosuje; słowa człowieka są przepisywane dosłownie; briefy trafiają do panelu jednym kanałem; każdy panel zapisuje stanowisko na dysku i odpowiada jednym wierszem; żaden panel nie podejmuje działań zewnętrznych.
- Formaty. Research według perspektyw, klasyczne rundy, pakiet szkicu, przesłuchanie krzyżowe teza po tezie, najpierw red team, potem obrońcy, najpierw steelman, potem ocena, ślepe wyzwanie ze świeżym kontekstem, panel replikacyjny i rozbieżne propozycje. Decyzja zawsze kończy się wymuszonym zbiorem werdyktów.
- Polecenie
herdr-peers debate.tallyliczy rankingowe karty do głosowania i werdykty dla każdego punktu (Borda, Copeland, pojedynki parami, zwycięzca i przegrany Condorceta);claimsscala rejestry twierdzeń z torów w statusy takie jak ustalone, sporne lub obalone, które są kworum, a nie weryfikacją;anonkopiuje stanowiska pod anonimowymi nazwami, a mapowanie trzyma w prywatnym kluczu;filingswypisuje stanowiska złożone, brakujące i zbyt krótkie, by ponownie pytać tylko brakujące panele. - Obsadzanie panelu.
panelproponuje skład panelu i niczego nie uruchamia. Miejsca rozdzielane są po kolei między dostawców modeli, a w obrębie dostawcy pierwsze jest miejsce z największym limitem, wybierane spośród bezczynnych paneli oraz, gdy agentkit (ak) jest zainstalowany, spośród kont proponowanych przezak pick. Bezakzaleca coding-agents-kit (opcjonalnie,v1.0.1lub nowszy). - Szablony. Szesnaście szablonów w
templates/debate/, od notatki człowieka i briefów researchu, testu obciążeniowego i rund po pliki kart i twierdzeń, pakiet przekazania prowadzącego oraz zapisy decyzji, stanu wiedzy, testu obciążeniowego i replikacji. - Doręczenie do zablokowanego peera.
replyinotifyponawiają doręczenie do peera zatrzymanego na pytaniu przez maksymalnie--wait-blockedsekund; nadal jest to dokładnie jedna odpowiedź.
Wydanie jest wyłącznie addytywne: protokół 1 oraz wszystkie polecenia, flagi, kody wyjścia i kontrakty JSON pozostają bez zmian.
Uwagi
Opcjonalny i nigdy niewymagany. Repozytorium bez opcjonalnych addonów jest w pełni zgodne i żaden przepływ nie zależy od tego addonu. Pełny cykl między dwoma panelami i maszynami jest pokryty testami na symulowanym Herdr; zaplanuj pierwsze uruchomienie pod nadzorem.