Ce să scrieți în CLAUDE.md

Dacă îi explicați mereu lui Claude Code aceleași reguli ale proiectului, notați-le în CLAUDE.md. Este un fișier text obișnuit, în format Markdown. Claude Code îl citește la începutul sesiunii și preia convențiile stabilite de dumneavoastră împreună cu restul contextului.

Pentru început, ajung câteva rânduri verificate: unde să lucreze, cum să verifice rezultatul și ce trebuie păstrat la modificări.

Exemplu de CLAUDE.md

Să luăm o pagină simplă cu carduri. Marcajul, stilurile și JavaScript sunt în același fișier index.html, iar pagina poate fi deschisă direct în browser. Pentru un astfel de proiect, fișierul cu instrucțiuni poate arăta așa:

# CLAUDE.md

## Proiect
- Pagina, stilurile și JavaScript sunt în `index.html`.

## Verificare
- Deschideți `index.html` într-un browser.
- Verificați pagina pe un ecran lat și unul îngust.

## Reguli
- Păstrați culorile actuale și stilul cardurilor.
- Nu ștergeți blocurile existente fără confirmare.
- La final, enumerați modificările și verificările.

Aici sunt trei categorii: structura proiectului, verificarea rezultatului și convențiile stabilite. Acum, când cereți "adăugați încă un card", nu mai trebuie să enumerați toate regulile. Totuși, pagina o puteți verifica și pe cont propriu: instrucțiunea nu îi oferă agentului acces la browser dacă nu are un astfel de instrument.

Acesta este un exemplu pentru un singur fișier, nu un șablon universal. Proiectul dumneavoastră poate avea directoare separate și comenzi proprii de pornire. Notați-le pe cele reale; dacă nu există teste, nu inventați o comandă doar ca să completați lista.

Ce merită să notați

Întrebarea de bază: vă va trebui această notă și la sarcinile următoare? Sunt utile comenzile verificate, căile importante și convențiile pe care agentul nu le poate deduce sigur din cod. Mai ales cele pe care a trebuit deja să le repetați.

Formulați regula astfel încât să fie clar ce acțiune așteptați de la agent:

• "verifică tot" → "după modificarea cardurilor, verifică pagina pe un ecran lat și unul îngust";
• "nu te atinge de lucrurile importante" → "nu șterge blocurile existente fără confirmare: conținutul lor a fost deja aprobat".

În primul caz este numită verificarea, iar în al doilea, limita și motivul ei. E mai util decât o listă lungă de dorințe precum "lucrează cu grijă".

README.md îi explică unei persoane ce proiect are în față și cum să înceapă. CLAUDE.md adună instrucțiunile pentru agent. Nu e nevoie să repetați tot README-ul. Iar o ipoteză precum "se pare că legenda se deplasează din cauza lățimii cardului" poate rămâne într-o notă pentru sarcina curentă, de exemplu în PROJECT_NOTE.md. E un fișier obișnuit, cu numele ales de dumneavoastră; când reluați sarcina, cereți-i agentului să-l citească.

Nu notați o presupunere ca pe un fapt confirmat și nu păstrați aici parole sau chei de acces. De regulă, fișierul CLAUDE.md comun se adaugă în Git, astfel încât colegii să primească aceleași instrucțiuni odată cu proiectul.

Cum să creați și să verificați fișierul

Începeți cu regulile pe care le cunoașteți deja. Nu așteptați să se adune o listă lungă de greșeli și nici nu descrieți dinainte toate situațiile posibile.

1. Verificați dacă proiectul are deja un fișier CLAUDE.md. Dacă da, citiți-l și completați-l. Pentru un fișier nou, alegeți rădăcina proiectului; este acceptată și locația .claude/CLAUDE.md, dar nu e nevoie să creați ambele copii.
2. Scrieți câteva rânduri manual sau introduceți /init într-o sesiune Claude Code deschisă în directorul proiectului. Comanda va analiza proiectul și va pregăti o schiță; pentru un fișier existent, va propune îmbunătățiri.
3. Citiți rezultatul. Comparați comenzile și căile cu proiectul și eliminați presupunerile. De exemplu, dacă agentul a inclus o comandă de testare care nu există la dumneavoastră, ștergeți-o. Adăugați personal limitările pe care doar dumneavoastră le cunoașteți.
4. Salvați fișierul și deschideți o sesiune nouă în directorul proiectului. Introduceți /context: în secțiunea Memory files ar trebui să apară calea către CLAUDE.md.

Apoi încercați o modificare mică: de exemplu, cereți adăugarea unui card și verificați dacă s-au păstrat culorile și dacă a apărut un raport al verificărilor. Dacă fișierul nu apare în listă, verificați mai întâi numele și directorul din care ați pornit sesiunea. Dacă apare, dar rezultatul nu respectă regula, verificați formularea și eventualele contradicții.

Unde să notați restul

Pentru primul proiect, un singur CLAUDE.md este suficient. Când apar indicații personale sau multe reguli comune, schema vă ajută să alegeți locul potrivit pentru fiecare notă:

O regulă comună poate viza un singur director și totuși să fie utilă întregii echipe. .claude/rules/ vă ajută să împărțiți instrucțiunile pe teme; limitarea lor la anumite căi se configurează separat. Pentru doar câteva reguli, nu complicați structura.

CLAUDE.local.md este potrivit pentru indicații personale în acest proiect, de exemplu preferința pentru răspunsuri scurte. Adăugați-l în .gitignore ca să nu ajungă în commit. Agentul citește totuși fișierul local, așa că nu puneți nici secrete acolo.

Memoria automată (auto memory) este un set separat de note pe care Claude le salvează în timpul lucrului, dacă mecanismul este activat. Nu lăsați o regulă importantă doar la latitudinea agentului: cereți-i explicit să o adauge în CLAUDE.md. O ipoteză temporară despre un bug rămâne în nota sarcinii.

Dacă proiectul are deja un fișier AGENTS.md, nu-i copiați conținutul într-un al doilea fișier. În CLAUDE.md puteți include fișierul vecin cu linia @AGENTS.md. E deosebit de util când adăugați CLAUDE.local.md: fișierul personal poate influența citirea directă a AGENTS.md. Alte variante sunt descrise în documentație.

Când să actualizați regulile

Actualizați fișierul odată cu proiectul. Ați mutat stilurile din index.html într-un fișier separat? Modificați rândul despre structură. Ați schimbat metoda de verificare? Înlocuiți instrucțiunea veche. Nu adăugați o regulă nouă peste una veche care o contrazice.

Puteți delega agentului o corecție pe care o tot repetați: "Adaugă în CLAUDE.md că înainte să ștergi un bloc existent trebuie să-mi ceri confirmarea". Apoi citiți modificarea: trebuie să redea convenția stabilită, fără restricții suplimentare inventate de agent. De multe ori ajunge un singur rând.

Dacă o regulă nu este respectată, căutați mai întâi cauza în loc să o repetați încă de trei ori. Eliminați notele învechite și păstrați doar ce ajută la următoarea sarcină.