CLAUDE.MD
Definiție
CLAUDE.md e un fișier text obișnuit, așezat în folderul unui proiect, pe care Claude Code îl citește automat la începutul fiecărei sesiuni și îl tratează ca pe reguli permanente. Conține ce ar trebui să repeți altfel de fiecare dată: ce e proiectul, cum e organizat, ce comenzi se folosesc, ce nu se atinge niciodată, ce convenții de scriere se respectă. Confuzia frecventă e cu memoria asistentului: memoria reține fapte despre tine în general, iar acest fișier ține reguli despre un proiect anume și călătorește odată cu folderul.
Mecanica are două detalii care contează. Primul e stratificarea: se citește un fișier general, din folderul tău personal, apoi cel al proiectului, iar cel mai apropiat de folderul în care lucrezi are ultimul cuvânt. Asta permite reguli valabile peste tot și reguli valabile doar aici. Al doilea e lungimea: recomandarea uzuală e în jur de două sute de rânduri, fiindcă tot ce scrii acolo consumă context la fiecare sesiune, iar un fișier umflat produce exact degradarea descrisă la context rot. Regulile trebuie să fie scurte, verificabile și scrise ca instrucțiuni, nu ca descrieri.
Pentru cineva care își construiește unelte, fișierul ăsta e locul unde se depun deciziile care altfel se pierd: cum se numesc folderele, unde se salvează rezultatele, ce nu se publică niciodată, ce comandă se folosește pentru a rula. Valoarea reală se vede la a treia sesiune, când asistentul respectă din prima o regulă pe care ai stabilit-o săptămâna trecută, și la predarea proiectului către un coleg, care primește regulile odată cu folderul. Regula de conținut e aceeași ca la skill-uri: reguli de lucru, nu date de client, fiindcă fișierul se copiază odată cu proiectul.
Exemple practice
- Reguli scrise o dată: limba în care se scrie textul, unde se salvează rezultatele, ce fișiere nu se modifică niciodată, ce comandă rulează scriptul. Nu se mai repetă la fiecare sesiune.
- Stratificare utilă: preferințele tale generale stau în fișierul personal, iar particularitățile unui proiect în fișierul proiectului. La conflict câștigă proiectul.
- Semn că fișierul a crescut prea mult: asistentul începe să ignore reguli din mijlocul lui. Se rezolvă prin scurtare și prin mutarea procedurilor lungi în skill-uri separate.
Întrebări frecvente
Ce scriu în el și ce nu?
Scrii reguli scurte și verificabile: structura proiectului, convenții, comenzi, interdicții. Nu scrii explicații lungi, istoricul proiectului sau date de client. Fișierul se citește la fiecare sesiune, deci fiecare rând în plus costă.
De ce nu respectă asistentul o regulă din fișier?
Cel mai des fiindcă fișierul e prea lung sau regula e formulată ca observație, nu ca instrucțiune. „Preferăm rapoarte scurte” se ignoră mai ușor decât „raportul are maximum o pagină”.
Cum se numește la ceilalți furnizori?
Codex, agentul OpenAI, citește AGENTS.md, care e un standard deschis adoptat de peste douăzeci și cinci de unelte. Gemini CLI citește implicit GEMINI.md, dar poate fi configurat să citească AGENTS.md. Cine folosește mai multe instrumente ține de regulă un singur fișier ca sursă de adevăr și îl leagă din celelalte.