sync SVN r18041

docs/orchestrare-subagenti.md

@@ -4,44 +4,8 @@ Regula (valabila in toate proiectele ROA/VFP): un singur subagent care duce o mi
 (iteratii de teste, investigatii, mai multe sarcini inlantuite) acumuleaza context urias —
 calitate degradata, cost mare. Nu se lucreaza asa.
 
-## REGULA ZERO: predarea contextului e OBLIGATORIE, nu optionala
-
-Se aplica **identic sesiunii principale si oricarui subagent**. Nu e o recomandare de eficienta,
-e o conditie de corectitudine: un context supraincarcat pierde tacut decizii deja luate si reia
-investigatii deja platite.
-
-**Declansatoare — la oricare dintre ele, predarea porneste imediat:**
-
-1. contextul propriu a trecut de **~50% din fereastra** (orchestrator) sau de **~200-250k tokens**
-   (subagent);
-2. harness-ul anunta compactare automata (`PreCompact`) — **prea tarziu ca sa mai amani, dar nu
-   prea tarziu ca sa scrii fisierul**; scrie handoff-ul inainte sa raspunzi orice altceva;
-3. utilizatorul semnaleaza ca s-a atins limita;
-4. s-a terminat un bloc de lucru — indiferent cat context a mai ramas.
-
-**Procedura, in ordine, fara exceptii:**
-
-1. **Opreste lucrul.** Nu incepe o sarcina noua, nu porni o rulare noua. Daca esti in mijlocul unei
-   editari, du-o pana la o stare **consistenta pe disc** (text si binare sincronizate) si atat.
-2. **Scrie handoff-ul pe disc** (`docs\handoff_<subiect>.md`). Nu in mesaj, nu in raport — **pe
-   disc**. Un mesaj catre orchestrator se pierde; fisierul nu.
-3. **Confirma in doua randuri** ce ai lasat in urma si daca ceva e intr-o stare periculoasa
-   (fisier editat fara write-back, tranzactie deschisa, proces ramas viu, date de test consumate).
-4. **Opreste-te.** Blocul urmator il ia un agent proaspat. "Mai am putin" nu e motiv de amanare —
-   exact acolo se pierd lucrurile.
-
-**Obligatia e a fiecaruia, nu doar a orchestratorului.** Un subagent care simte ca se apropie de
-prag **anunta singur** si cere predarea; nu asteapta sa fie oprit. Un orchestrator care se apropie
-de prag isi scrie propriul handoff si preda orchestrarea unei sesiuni noi — regula nu are portita
-pentru "eu doar coordonez".
-
-**Ce intra obligatoriu in handoff**: inventarul livrabilelor cu `fisier:linie`; ce e terminat si ce
-nu; **daca write-back-ul e facut** pentru fiecare fisier atins; comanda exacta de rulare a testelor
-si unde scriu logurile; ce s-a stabilit deja (ca sa nu se reia); ce e interzis; starea datelor de
-test consumate; capcanele de mediu platite. Fara analize noi — doar stare.
-
-Doua lectii platite scump, amandoua din aceeasi cauza — un agent tinut peste prag (`s5-nivel2`
-533k, `s2d-modifica-gestiuni` 434k). Predarea e aproape gratuita: raportul e oricum deja scris.
+Predarea contextului la prag (REGULA ZERO, declansatoare, procedura, ce intra in handoff) e
+regula globala din `~/.claude/CLAUDE.md`, se aplica identic sesiunii principale si subagentilor.
 
 ## Cum se lucreaza
 
@@ -69,6 +33,27 @@ Doua lectii platite scump, amandoua din aceeasi cauza — un agent tinut peste p
   Sonnet; ORCHESTRATORUL subagentilor (cel care imparte, monitorizeaza, deblocheaza,
   decide) -> Opus (sau sesiunea principala). Commit doar dupa review-ul diff-ului de
   catre om (vezi reguli_lucru.md).
+- Un agent tinut peste prag costa scump: doua cazuri platite, aceeasi cauza (`s5-nivel2` 533k,
+  `s2d-modifica-gestiuni` 434k tokens) — predarea la timp e aproape gratuita, raportul e oricum
+  deja scris.
+
+## Verificarea a ce se intoarce
+
+Pentru executie delegarea merge, pentru concluzii nu:
+
+- **citeste contractul functiei apelate, nu-l presupune.** Un raport care descrie corect
+  structura codului poate gresi sensul: ex. `goExecutor.oExecute` intoarce succes/insucces
+  (`CT_SUCCES`/`CT_INSUCCES`), NU numarul de randuri — o garda `If lnSucces > 0` citita ca
+  "are randuri" a produs un bug inexistent, raportat ca blocant. Deschide functia.
+- **fix ingust, nu supra-constructie.** Cand premisa se corecteaza, corectia se restrange:
+  mecanismele noi introduse "ca sa fie sigur" diverg de la codul-sablon si blocheaza
+  refolosirea lui in alta parte.
+- **"zero cazuri in date" nu dovedeste nimic** pe scheme cu date de test; raspunsul vine din
+  cod. Si invers: o potrivire de cifre pe 1-2 documente nu e o regula.
+- **cere raportul sa separe "testat" de "analizat static"**, si ce n-a putut fi acoperit. Un
+  agent care nu e intrebat explicit va prezenta amandoua la fel.
+- **spune-i ca poate infirma briefingul.** Altfel implementeaza corectia ceruta chiar cand a
+  descoperit ca nu e nevoie de ea.
 
 ## Semne ca ai gresit impartirea
 
@@ -97,8 +82,8 @@ diagnostic, fixuri aplicate direct in loc de delegate.
   care intoarce da/nu, nu continutul din care ai deduce singur.
 - **Nu aplica fixuri direct** decat sub ~5 linii si doar daca ai deja contextul in sesiune.
 - **Prag si pe orchestrator**: la ~50% din fereastra, scrie handoff-ul si reia orchestrarea
-  dintr-o sesiune noua. Handoff-ul e deja pe disc - exact pentru asta exista. Vezi **Regula zero**
-  de la inceputul fisierului: obligatia e aceeasi ca pentru subagenti, fara portita pentru
+  dintr-o sesiune noua. Handoff-ul e deja pe disc - exact pentru asta exista. Vezi REGULA ZERO din
+  `~/.claude/CLAUDE.md`: obligatia e aceeasi ca pentru subagenti, fara portita pentru
   "eu doar coordonez".
 
 ## Model de lucru: backlog de story-uri mici, context mic per story