Sari la conținut
RO
Ia legătura

Cum păstrezi controlul asupra unei baze de cod în care scriu agenții

Când modelele scriu cea mai mare parte a unei baze de cod, controlul se pierde pe două căi: redenumiri necerute și registre fără nume. Regulile scrise care le opresc pe amândouă.

De Bogdan Vladoiu, 2026-11-02

Baza de cod a ComputeShack e scrisă de peste un an în cea mai mare parte de modele de limbaj, sub un singur maintainer. Din ea se construiesc serviciile pe care rulează aplicațiile, aplicațiile, un joc și uneltele care le fac. Iată ce a fost nevoie ca să rămână sub control și cele două greșeli din cauza cărora aproape că s-a pierdut.

Niciuna dintre greșeli nu ține de faptul că modelele greșesc. Amândouă țin de faptul că modelele vor să ajute.

Prima cale prin care se pierde controlul: redenumirile

Un model care citește o funcție numită settle va decide, cu o anumită probabilitate, că numele nu e clar și o va redenumi applyServerIds. Nu se strică nimic. Testele trec. Diff-ul e corect. Iar maintainerul a pierdut un cuvânt.

Numele sunt felul în care un maintainer găsește lucrurile. Un nume ales acum un an, stângaci sau nu, e legat în memorie, în căutare, în felul în care autorul vorbește despre cod. Un nume mai bun nu reface asta; înlocuiește un cuvânt cunoscut cu unul necunoscut. Înmulțește asta cu fiecare redenumire binevoitoare din fiecare sesiune și maintainerul ajunge să citească baza de cod a unui străin care se întâmplă să facă ce făcea a lui.

Regula care a oprit asta e directă. Nicio redenumire fără un blocaj: o eroare reală de compilare sau o coliziune care creează ambiguitate. Nu o preferință, nu „așa se citește mai bine”. Când o redenumire chiar e necesară, modelul se oprește și declară blocajul, ca maintainerul să aleagă noul nume. Un refactor pe care maintainerul îl predă e input final, niciodată o ciornă de îmbunătățit.

Redenumirile necerute au fost cel mai mare motiv pentru care controlul asupra proiectului a alunecat. Regula e prima din fișierul pe care îl citește fiecare sesiune.

A doua cale: registrele

A doua greșeală e mai greu de văzut, pentru că nu arată niciodată a greșeală.

Un model are nevoie să țină câteva instanțe ale unui lucru. Scrie un map. Sau o listă. Sau un lookup lazy, sau un mic cache. Fiecare e o propoziție de cod, corectă local, și fiecare e un loc nou în care trăiesc instanțe ale acelui lucru. Trei sesiuni mai târziu sunt patru, nu sunt de acord asupra a ce există, iar proprietarul componentei, companion object-ul care trebuia să-i țină instanțele, nu știe de niciunul.

Modelele fac asta des, iar rezultatul rareori se numește registru. E un pool, un cache, un lookup. Efectul e același: baza de cod se scindează, iar controlul pleacă odată cu ea.

Regula de aici e o regulă de plasare, cu trei cazuri.

  1. Companion-ul componentei are deja o colecție sau un pool utilizabil. Folosește-l.
  2. Nu are, iar nevoia e o simplă listă, un map sau un câmp. Adaugă-l în companion. E plasare, nu un concept nou, și nu cere permisiune.
  3. Nu are, companion-ul e saturat, iar acoperirea nevoii ar însemna un tip nou cu nume. Oprește-te, declară lipsa și două-trei opțiuni și nu schimba nimic cât timp întrebi.

Doar al treilea caz oprește lucrul. Să înțepenești la al doilea e în sine un eșec. „Temporar” nu e o scutire.

Codul din aval oferă doar perspective: o funcție de keying de ordin superior, un cache al propriilor rezultate, propriul context privat. Nu alocă și nu colectează niciodată în numele unei componente. A cere codului din aval să preia orice aspect al unei componente este definiția literală a datoriei tehnice.

De ce reguli scrise și de ce acestea

Ambele reguli au aceeași formă. Fiecare numește un comportament rezonabil local și distructiv global, trage linia astfel încât un reviewer să o poată verifica dintr-o privire și îi spune modelului exact ce să facă la linie: să se oprească și să întrebe.

Forma aceasta contează mai mult decât conținutul. Un model urmează fiabil „nicio redenumire fără o eroare de compilare”. Nu urmează „folosește-ți judecata la redenumiri”, pentru că judecata lui e exact ce a produs redenumirea.

Regulile stau într-un singur fișier la rădăcina repository-ului, încărcat în fiecare sesiune, iar fișierul acela are prioritate față de orice alt document din repository. Unde un alt document îl contrazice sau s-a degradat, fișierul câștigă, iar modelului i se spune să semnaleze conflictul în loc să acționeze după celălalt document. Deciziile se scriu o singură dată, într-un singur loc; repetarea unei decizii în mai multe fișiere e ea însăși interzisă, pentru că două copii ajung să difere.

Alte reguli care și-au câștigat locul

Încă câteva, fiecare scrisă după ce ceva a mers prost.

  • Comentariile sunt oprite până la noi ordine. Modelele narează: ce s-a făcut, de ce editarea e corectă, ce s-a mutat. Nimic din asta nu supraviețuiește următoarei editări și totul îngroapă puținele comentarii care contează. Când un comentariu e permis, el e o constrângere de eșec silențios, o ancoră către o specificație sau un marcaj temporar cu condiția pentru eliminarea lui.
  • Nu se adaugă nimic care crește churn-ul fără un beneficiu evident. Fără helperi speculativi, fără schelărie, fără straturi defensive, fără teste pe care nu le-a cerut nimeni. Înainte să adaugi ceva, întreabă ce se strică fără el. Dacă nimic, nu-l adăuga.
  • Valoarea implicită a unei joncțiuni are o polaritate. O valoare implicită care deschide conținut revine la ce are codul și scrie o dată în log. O valoare implicită care decide accesul refuză și scrie în log. Aceeași formă, valoare implicită opusă, niciodată copiată de la una la cealaltă.
  • Modelul nu face niciun commit. Editează, raportează ce s-a schimbat și lasă arborele murdar. Maintainerul inspectează și face commit, iar cea mai mare parte o comprimă prin squash.

Ce nu este asta

Nu e un argument că modelele ar trebui să scrie mai puțin. Casa n-ar exista la dimensiunea asta cu o singură persoană care tastează. E un argument că persoana trebuie să rămână cea care cunoaște codul și că asta e o proprietate a regulilor, nu a modelului.

Unui colaborator uman i s-ar spune aceleași lucruri, cu aceleași motive. Diferența e că un om își amintește că i s-a spus. Unui model trebuie să i se spună în fiecare sesiune, în scris, într-un loc pe care nu-l poate rata.

ComputeShack

Soluții mici și bune.

[email protected]

Politica de confidențialitate · © 2026 ComputeShack