AGENTS.MD
Definiție
AGENTS.md e echivalentul lui CLAUDE.md la OpenAI, cu o deosebire importantă: nu e formatul unui singur furnizor, ci un standard deschis, aflat sub umbrela Agentic AI Foundation din Linux Foundation, adoptat de peste douăzeci și cinci de unelte de programare asistată. Conține același lucru, adică regulile permanente ale unui proiect pe care agentul le citește înainte să lucreze, dar are avantajul portabilității: același fișier e înțeles de Codex, de mediile de dezvoltare cu agent și, cu o setare, de uneltele Google.
Regula de descoperire diferă de cea a lui Claude, deși efectul e similar: se pornește de la un fișier personal, apoi se parcurg folderele de la rădăcina proiectului spre folderul curent, iar cel mai apropiat are ultimul cuvânt. Există și o limită tehnică de dimensiune, în jur de treizeci și doi de kiloocteți, care în practică nu se atinge dacă scrii instrucțiuni și nu documentație. Adoptarea largă e argumentul principal pentru care merită cunoscut chiar dacă nu folosești Codex: proiectele publice îl conțin deja, iar cine lucrează cu mai multe asistente evită astfel să întrețină trei fișiere care se contrazic.
Pentru un cabinet care începe să folosească mai multe instrumente AI, valoarea practică e exact aici: un singur fișier de reguli, ținut lângă proiect, pe care îl citesc toate uneltele. Alternativa, adică un fișier per furnizor, produce în timp derivă: regula corectată într-unul rămâne veche în celelalte, iar rezultatele diferă fără explicație. Recomandarea uzuală e să ții AGENTS.md ca sursă de adevăr și să faci celelalte unelte să trimită la el, în loc să duplici conținutul.
Exemple practice
- Un singur fișier de reguli, citit și de agentul OpenAI, și de mediile de dezvoltare cu agent, în loc de trei fișiere care se despart în timp.
- Proiect public descărcat de pe internet: fișierul AGENTS.md din el spune cum se rulează, cum se testează și ce convenții se respectă. E prima lectură utilă înainte de a cere modificări.
- Semn de derivă: aceeași cerere dă rezultate diferite în două unelte. Cauza uzuală e că fiecare citește alt fișier de reguli, iar cele două s-au despărțit.
Întrebări frecvente
Care e diferența față de CLAUDE.md?
Conținutul e același ca natură. Diferența e proprietatea: CLAUDE.md e formatul Anthropic, iar AGENTS.md e un standard deschis, citit de multe unelte. Claude Code nu îl citește automat, dar poate fi făcut să îl includă.
Trebuie să am amândouă fișierele?
Nu. Recomandarea practică e un singur fișier ca sursă de adevăr, cu celelalte unelte configurate să trimită la el. Două fișiere întreținute în paralel devin, inevitabil, două seturi de reguli diferite.
Cum se numește la ceilalți furnizori?
Anthropic folosește CLAUDE.md pentru Claude Code. Google folosește GEMINI.md pentru Gemini CLI, cu posibilitatea de a citi și AGENTS.md. Uneltele care nu au format propriu au adoptat direct AGENTS.md.