AGENTS.md

OpenAI a lancé AGENTS.md en août 2025 et, le 9 décembre 2025, l'a confié à l'Agentic AI Foundation, un fonds dirigé par la Linux Foundation et cofondé avec Anthropic et Block. À cette date, plus de 60 000 projets open source avaient adopté ce format, de même que des frameworks d'agents dont Cursor, Devin, GitHub Copilot, Gemini CLI et VS Code. Ce qui est ainsi mis sous gouvernance est un fichier Markdown portant des instructions propres à un projet : conventions de code, étapes de build, exigences de tests.

Jude Gao, chez Vercel, a mesuré ce que ce fichier apporte. Les API de Next.js 16 absentes des données d'entraînement des modèles produisaient du code incorrect dans 47% des cas. Les skills qui empaquetaient la même connaissance restaient non invoquées dans 56% des évaluations, ramenant le taux de réussite au niveau de référence de 53%, et n'atteignaient 79% que lorsque les instructions forçaient le déclenchement. Un AGENTS.md statique, injecté dans le system prompt à chaque tour, obtenait 100% sur le build, le lint et les tests. Vercel a ensuite compressé 40 Ko de documentation en un index de 8 Ko à séparateurs verticaux sans perdre ce score, parce qu'un contexte passif consomme de la fenêtre à chaque interaction.

Addy Osmani présente ce fichier comme un problème de rationnement. Selon le "ratchet principle" (principe du cliquet), chaque ligne doit se rattacher à un échec passé concret ; chez HumanLayer, le plafond est fixé sous 60 lignes, une checklist de pilote plutôt qu'un guide de style.

Bill Staples, de GitLab, distingue le fichier Markdown du registre gouvernable. Contexte, identité, politique, provenance et mémoire organisationnelle doivent persister à travers les modèles et les agents, ce qui, pour lui, appelle un control plane plutôt qu'un fichier dans le dépôt.