Doctrina Adâncimii Subagenților și Izolării Memoriei

Wednesday poate crea subagenți prin trei căi distincte: plugin-ul Cowork, tool-ul nativ Agent și scriptul hermes_dispatch.py. Fiecare dintre aceștia poate, la rândul lui, să creeze alți subagenți. Fără reguli clare, sistemul riscă să devină un arbore necontrolat de procese paralele.

Ce face

Doctrina stabilește două contracte obligatorii. Primul este limita de adâncime: de la cererea operatorului (nivel 0) se permite maximum două niveluri de subagenți. Wednesday (nivel 1) poate apela un subagent direct (nivel 2), dar acesta nu mai poate crea un nivel 3. Al doilea contract este izolarea memoriei: doar Wednesday scrie în fișierele canonice (MEMORY.md, runtime_state.json, scratchpad.md, lessons sau doctrine). Subagenții returnează rezultate către Wednesday, care decide ce devine memorie permanentă.

Când îmi folosește

Când lucrezi la sarcini complexe care necesită delegare (cercetare paralelă, analiză de cod pe mai multe fișiere, validare de ipoteze), doctrina previne trei probleme practice: bucle infinite de apeluri, consum inutil de tokeni prin moștenirea întregului context și contaminarea memoriei cu date intermediare sau confidențiale. Este utilă mai ales în sesiuni lungi unde mai multe fire de execuție rulează simultan.

Cum îl invoc / declanșez

Doctrina este activă implicit la fiecare spawn de subagent. Wednesday transmite automat parametrul subagent_depth în promptul de sistem sau în contractul de task. Nu există o comandă separată de apelat; verifică doctrina pentru detalii exacte în All guides.

Exemplu practic

Operatorul cere o analiză pe cinci surse diferite. Wednesday creează un subagent de nivel 2 cu sarcina „rezumă sursa X”. Subagentul de nivel 2 nu poate crea alți subagenți. El scrie rezultatul într-un fișier temporar din _infra/temp/, apoi returnează rezumatul către Wednesday. Wednesday decide dacă rezumatul intră în MEMORY.md sau rămâne doar în sesiunea curentă.

Output / unde aterizează

Toate constatările subagenților se întorc la Wednesday sub formă de răspuns structurat. Wednesday actualizează memoria canonică (dacă este cazul) și publică event-uri de telemetrie prin publish_event. Subagenții pot citi memoria canonică, dar nu o modifică.

Limite / gotchas

Depășirea nivelului 2 este interzisă implicit. Dacă un subagent de nivel 2 are nevoie de nivel 3 (de exemplu pentru cercetare paralelă), trebuie să anunțe intenția și să limiteze fan-out-ul la maximum cinci frunze. Contextul transmis este întotdeauna limitat la sarcina curentă; istoricul complet al conversației sau valori de tip credential nu se propagă automat. Orice încercare de scriere directă în memoria canonică din partea unui subagent este ignorată de sistem.