.jpg)
En l'ecosistema actual del desenvolupament de programari, on els assistents de codificació basats en intel·ligència artificial s'han convertit en eines indispensables, sorgeix un repte recurrent: la dispersió d'instruccions. Cada plataforma —Copilot, Cursor, Cline, Devin Desktop, entre d'altres— exigeix el seu propi fitxer de configuració, generant una duplicació de regles que ràpidament deriva en inconsistències. Aquest fenomen, conegut com a instruction drift, és precisament el problema que resol AGENTS.md, un estàndard obert que permet definir les regles d'un projecte una sola vegada i que la majoria de les IA de codi el llegeixin de forma automàtica.
AGENTS.md és un fitxer de text pla en format Markdown ubicat a l'arrel del repositori. Sense sintaxi especial, sense frontmatter YAML, sense esquemes per aprendre. Va ser publicat per OpenAI a l'agost de 2025 i cedit a la Linux Foundation per a la seva governança com a estàndard obert. A mitjans de 2026 ja s'havia adoptat en més de 60.000 repositoris de codi obert. Mentre que un README explica el projecte als humans, AGENTS.md l'explica als agents intel·ligents.
Allò que pocs guies mencionen és que no totes les eines l'implementen de la mateixa manera. La majoria —Copilot, Cursor, Devin Desktop, Aider, Kilo Code, Gemini CLI, Codex CLI i més de 30— el llegeixen nativament des de l'arrel del projecte. L'excepció honesta és Cline: el seu format natiu és .clinerules/ i no detecta automàticament l'AGENTS.md del projecte arrel; sí que llegeix un fitxer global, però no l'específic del repositori. Conèixer aquestes diferències és clau abans d'assumir que un únic fitxer cobreix totes les eines.
Redactar un AGENTS.md eficaç requereix estructura i concisió. Les seccions imprescindibles inclouen: Comandes (instal·lar, executar, testejar, compilar), Convencions (regles específiques com "només exportacions amb nom, mai per defecte"), Restriccions dures (usar la paraula "mai" per donar pes), i afegits avançats com un Pressupost de Context (indicar a l'agent com buscar abans d'obrir fitxers complets) i un Mapa d'Enrutament Ràpid que associï tasques amb fitxers concrets, eliminant així al·lucinacions de rutes. També pot incloure una Definició de Fet amb les comandes que s'han d'executar abans de donar per acabada una tasca.
Un estudi realitzat al febrer de 2026 per l'ETH Zúric (138 tasques reals de GitHub) va revelar que els fitxers de context escrits a mà ofereixen una millora modesta del 4 % en l'èxit de les tasques, mentre que els generats automàticament tendeixen a empitjorar els resultats. La conclusió és clara: cal escriure el fitxer manualment, mantenir-lo per sota de 200 línies i centrar-se en informació que l'agent no pugui descobrir per si mateix llegint el codi.
Una de les capacitats menys conegudes és l'ús de fitxers niats: l'AGENTS.md més proper al fitxer que s'està editant té prioritat, permetent sobreescriure regles globals per a submòduls o paquets legacy. OpenAI, per exemple, inclou 88 fitxers AGENTS.md distribuïts al seu repositori Codex. A més, és important tractar aquest fitxer com a públic: no incloure secrets ni tokens reals, només indicar on viuen.
En Q2BSTUDIO som experts en desenvolupament d'aplicacions a mida i programari a mida, i sabem que la integració de múltiples eines d'intel·ligència artificial requereix una gestió coherent de les instruccions. Per això oferim serveis de consultoria en IA per a empreses, ajudant a adoptar estàndards com AGENTS.md perquè els seus equips de desenvolupament treballin amb agents IA de forma eficient. A més, combinem aquestes capacitats amb serveis cloud AWS i Azure per desplegar projectes robustos, i amb serveis d'intel·ligència de negoci basats en Power BI per convertir dades en decisions. La ciberseguretat també és part fonamental de les nostres solucions, garantint que cada fitxer i cada pipeline estigui protegit.
AGENTS.md no és només un fitxer més: és la clau perquè els agents d'IA treballin en harmonia dins d'un projecte, eliminant la deriva d'instruccions i alliberant els desenvolupadors de tasques repetitives. En Q2BSTUDIO t'ajudem a implementar-lo correctament i a treure el màxim profit de la intel·ligència artificial a la teva organització.
