Greutatea Tăcută a Memoriei AI: Cum CLAUDE.md Îți Mănâncă Repository-ul
Când Documentația Devine un Havuz de Instrucțiuni Uitate
Gândește-te la asta: începi un proiect nou cu un fișier CLAUDE.md curat. Câteva sfaturi utile. Câteva note de context. Un avertisment despre acel caz limită ciudat din flow-ul de autentificare. Câteva luni mai târziu, deschizi fișierul și descoperi un roman masiv de instrucțiuni contradictorii, mementouri depășite și appendice disperate pe care nimeni nu le mai înțelege cu adevărat.
Nu e doar experiența ta. Este un fenomen universal.
Cercetările care au analizat 247.694 de cicluri de viață ale instrucțiunilor în 1.867 de repository-uri dezvăluie un tipar îngrijorător: prompt-urile agențiale nu doar cresc — cresc fără limită, mai mult decât triplecând pe parcursul existenței lor (+226%). În medie, aceste fișiere câștigă +4.9 instrucțiuni nete la fiecare commit. Fișierul nu se micșorează niciodată. Doar se extinde.
Dar iată ce face fenomenul cu adevărat fascinant: cu cât o instrucțiune e mai veche, cu atât este mai puțin probabil să fie ștearsă. Datele arată un hazard logaritmic de -0.032 per commit, ceea ce înseamnă că instrucțiunile devin din ce în ce mai nemuritoare cu cât stau mai mult acolo. Nu e că nimeni nu vrea să facă curățenie — e că nimeni nu știe dacă poate elimina ceva în siguranță.
Problema O(2^|D|)
De ce se întâmplă asta? Cercetătorii o numesc „memorie catastrofală" — inversul celebrei probleme de „uitare catastrofală" din machine learning. Dar nu ai nevoie de un PhD ca să înțelegi de ce se întâmplă.
Gândește-te la calculul costurilor: adăugarea unei instrucțiuni noi este ieftină. Vezi o problemă, scrii o soluție, mergi mai departe. Costul imediat este scăzut, iar beneficiul perceput este clar.
Dar eliminarea unei instrucțiuni? Asta e o bestie complet diferită. Trebuie să înțelegi fiecare loc unde acea instrucțiune ar putea conta. Trebuie să raisonezi despre interacțiunile cu toate celelalte instrucțiuni. Trebuie să verifici că eliminarea ei nu va strica ceva subtil și important. Cercetătorii au calculat acest cost cognitiv ca fiind O(2^|D|) într-un prompt cu |D| instrucțiuni — adică crește exponențial cu numărul de instrucțiuni existente.
Așa că dezvoltatorii fac ceea ce fac oamenii raționali: renunță să mai încerce. Instrucțiuni noi sunt adăugate. Cele vechi rămân. Fișierul crește.
Comentariile: Eroul Necunoscut
Aici devine cu adevărat interesant. Soluția nu constă în tehnici de prompting mai bune sau modele mai inteligente. Este ceva ce dezvoltatorii folosesc de la începuturile programării: comentariile.
Cercetătorii au avut o abordare interesantă — au inversat IFEval, un benchmark standard, pentru a crea „lumi verificabile" unde prompt-urile optimale sunt de fapt cunoscute. Când au adăugat comentarii care codifică raționamentul latent în prompt-uri, creșterea excesivă a instrucțiunilor a scăzut de la +211.3% la doar +1.4%.
Asta înseamnă o reducere de 99.3%.
Dar adevărata lovitură? Aceste comentarii nu doar că au controlat creșterea — au îmbunătățit performanța reală de urmărire a instrucțiunilor cu până la 23.1% în task-uri din lumea reală. Comentariile nu sunt doar dezordine organizatorică. Sunt structuri portante care ajută asistenții AI să rașoneze corect despre context.
De Ce Contează Acum
Trăim printr-o schimbare fundamentală în ce înseamnă „codul". Cercetătorii pun o întrebare provocatoare: „Dacă engleza este noul cod, de ce nu avem încă comentarii?"
Este o întrebare legitimă. Pentru decenii, dezvoltatorii au înțeles că codul fără comentarii este datorie tehnică. Comentariile explică „de ce", nu doar „ce". Capturează intenția, cazurile limită și cunoștințele instituționale care nu pot fi deduse din sintaxă.
Însă în grabă noastră de a externa tot mai mult asistenților de codare AI, am tratat instrucțiunile în limbaj natural ca și cum ar fi diferite. Scriem imperativ — fă asta, nu face asta, nu uita să verifici X — fără să explicăm raționamentul nostru.
Rezultatul este ceea ce vedem în acele fișiere CLAUDE.md care se umflă: instrucțiuni pe care nimeni nu le înțelege pe deplin, care pot intra în conflict și care cresc fără niciun mecanism de raționalizare.
Drumul Înainte
Dacă întreții un fișier CLAUDE.md sau un prompt agențial similar, iată ce sugerează cercetarea:
Comentează-ți instrucțiunile, nu doar codul. Explică de ce există o regulă. Documentează cazurile limită. Capturează raționamentul din spatele deciziilor.
Acceptă raționalizarea periodică. Nu doar adăuga — rescrie. Cercetarea notează explicit că rescrierile complete sunt unul dintre puținele lucruri care opresc creșterea.
Tratează instrucțiunile AI ca pe o documentație de onboarding. Ai da unui dezvoltator nou un fișier de 400 de linii cu reguli nediferențiate? Asistentul tău AI merită aceeași claritate.
Traiectoria pe care suntem nu este sustenabilă. Fiecare proiect nou începe cu bune intenții și se termină cu un haos de întreținut. Dar soluția ar putea fi mai simplă decât credeam: scrie pentru omul (sau AI-ul) care va citi instrucțiunile tale peste șase luni, nu doar pentru cel care îți răspunde azi.
Comentariile nu sunt dezordine. Sunt arhitectura înțelegerii.