CLAUDE.md: nu e README, e instrucțiunea pentru AI-ul tău

Ați observat cum mulți dezvoltatori tratează fișierul CLAUDE.md? Ca pe un README oarecare — listează stack-ul, câteva preferințe și speră la un miracol. În realitate, acest fișier nu e o documentație, ci o directivă directă pentru asistentul AI. Imaginați-vă că ați angajat un intern care poate citi tot codul, dar habar n-are de obiceiurile voastre. CLAUDE.md e instrucțiunea lui pentru prima zi.

Ce pun de obicei în el? "Folosim React, Next.js, PostgreSQL". Și atât. Apoi se miră de ce AI-ul propune soluții care îți provoacă spasme oculare. Abordarea corectă e să scrieți în stilul: "Niciodată nu folosi any, testele le scrii cu Vitest, iar componentele doar funcționale". Da, seamănă mai mult cu un ghid de stil, dar exact așa înțelege AI-ul că nu vă place abstracția inutilă.

Cum să-l folosești cu adevărat

• Reguli în loc de fapte: nu "stack: X", ci "întotdeauna fă Y".
• Exemple de durere: "Dacă vezi un query la DB într-un ciclu — oprește-te și rescrie cu JOIN".
• Ton: scrieți ca pentru un coleg deștept, dar fără experiență. Fără jargon, dar cu limite clare.

Și da, CLAUDE.md nu înlocuiește code review-ul, dar reduce numărul de corecturi în pull request-uri. Iar dacă AI-ul vostru tot propune biciclete reinventate — poate ar fi bine să verificați dacă ați uitat să adăugați regula "nu reinventa roata"?

Comentariul echipei METABYTE: Și dezvoltatorii noștri au scris inițial CLAUDE.md ca pe un README, până când și-au dat seama că AI-ul nu e Google Docs, ci mai degrabă un intern care are nevoie de o listă clară de "da/nu". Acum avem un astfel de fișier în fiecare proiect — și bug-urile le găsim mai repede decât apucăm să spunem "uite, iar any".