Qu'est-ce qu'AGENTS.md ? | Glossaire GEO

AGENTS.md est un fichier Markdown placé à la racine d'un dépôt ou d'un site web qui indique aux agents IA comment travailler sur le projet — étapes de build, commandes de test, style de code et règles à respecter. Souvent décrit comme « un README pour les agents », il est devenu le fichier d'instructions standard de fait, lu automatiquement par OpenAI Codex et d'autres grands agents de codage au début d'une tâche.

Pourquoi c'est important

Les agents IA de codage sont puissants, mais ignorent tout du savoir tacite d'un projet. Quelle commande lance les tests, quels répertoires sont à proscrire — tout cela devait être réexpliqué dans chaque prompt. AGENTS.md fixe ce contexte dans un seul fichier que les agents consultent automatiquement. Il a été conçu de façon collaborative par OpenAI Codex, Amp, Jules (Google), Cursor et Factory, et est pris en charge nativement par plus de 20 outils, dont GitHub Copilot, Gemini CLI, Devin et Zed. En 2026, il est utilisé par plus de 60 000 projets open source, et en décembre 2025, il a été donné — aux côtés du MCP d'Anthropic — à l'Agentic AI Foundation, sous l'égide de la Linux Foundation, pour une gouvernance neutre.

Structure et rédaction

AGENTS.md est du Markdown brut, sans champs obligatoires. Au lieu d'un schéma fixe, il porte des instructions en langage naturel qu'un agent peut lire et suivre. Sections recommandées :

Présentation du projet : un ou deux paragraphes sur ce que fait le codebase
Commandes de build et de test : installation des dépendances, serveur de développement, exécuteur de tests
Style de code : nommage, formatage, conventions du framework
Sécurité et limites : fichiers à ne pas toucher, gestion des secrets
Règles de commit et de PR : format des messages, processus de revue

Les grands monorepos imbriquent un AGENTS.md par paquet ; les agents appliquent le fichier le plus proche de l'endroit où ils travaillent.

En quoi il diffère de llms.txt

Si llms.txt est la brochure qui indique à l'IA quel contenu existe, AGENTS.md est le manuel d'exploitation qui explique comment travailler ici. Il est né dans les dépôts de code, mais un schéma plus récent le place à la racine du site web (/agents.md) pour guider les agents de navigation à travers un site. Avec llms.txt et le balisage Schema.org, il relève de la catégorie des « signaux lisibles par les agents » — et contrairement à robots.txt, qui régit l'autorisation du crawling IA, il couvre ce qu'un agent autorisé doit faire et comment.

Implications pour le GEO

À mesure que le centre de gravité du GEO s'étend du « contenu que l'IA cite » aux « sites que l'IA peut exploiter », les fichiers qui fournissent aux agents des instructions explicites deviennent une nouvelle couche d'optimisation. Si vous gérez des outils pour développeurs ou une documentation d'API, moins les agents ont besoin de tâtonner grâce à AGENTS.md, plus votre produit a de chances d'être adopté au sein des workflows d'agents. Gardez à l'esprit que ce fichier est une recommandation, et non une contrainte — un contenu bien structuré reste le socle.

Sources :

Comment inblog vous aide

Si vous gérez un blog produit ou une documentation sur inblog, rappelez-vous la répartition des rôles entre les signaux. Pendant que les fichiers de type llms.txt prennent en charge la découverte du contenu et qu'AGENTS.md gère les instructions de travail, le corps du blog lui-même doit rester facile à citer et à résumer pour les agents. Le balisage épuré et la structure de titres claire d'inblog amplifient la valeur de ces signaux lisibles par les agents.