AI Tool Atlas
Règles et instructions Officiel

AGENTS.md

Format Markdown ouvert d'instructions projet pour agents de code, lu par Codex, Cursor, Gemini CLI, etc.

Auteur
AGENTS.md (Agentic AI Foundation, Linux Foundation)
Compatible avec
Cursor, Gemini CLI, OpenAI Codex, Windsurf
Documenté
Oct 2, 2026
Documentation officielle ↗

Ce qu'est AGENTS.md

AGENTS.md est un simple fichier Markdown placé dans un dépôt pour fournir aux agents de code les étapes de build, les tests et les conventions. Il n'a aucun champ obligatoire. Les agents lisent le fichier le plus proche dans l'arborescence, ce qui permet d'avoir des fichiers imbriqués pour les sous-projets d'un monorepo. Le site indique qu'il est piloté par l'Agentic AI Foundation, sous l'égide de la Linux Foundation.

Ce qu'il fait

Comment AGENTS.md s'intègre : quels agents l'exécutent et ce qu'il ajouteS'EXÉCUTE DANSVotre agentOpenAI CodexCursorGemini CLIWindsurf4 hôtes documentésRULES · OFFICIELAGENTS.mdInstructions de projet lues par l…5 étapes d'installationaucune autorisation supplémentair…CE QU'IL AJOUTECe qu'il faitOffre aux agents un emplacement p…Garde les détails destinés aux ag…Prend en charge des fichiers AGEN…Fonctionne avec de nombreux agent…agent → extension → nouvelle capacité · depuis le dépôt ou la documentation officielle
Où AGENTS.md s'exécute et ce qu'il ajoute, d'après sa documentation
  • Offre aux agents un emplacement prévisible pour les instructions de setup, de test et de style de code
  • Garde les détails destinés aux agents hors du README pour humains
  • Prend en charge des fichiers AGENTS.md imbriqués ; le plus proche du fichier édité l'emporte
  • Fonctionne avec de nombreux agents grâce à un seul fichier au lieu de formats par outil

Quand l'utiliser

Bonne adéquation

  • Vous utilisez plus d'un agent de code sur le même repo
  • Un monorepo a besoin d'instructions d'agent par package
  • Vous voulez que les agents exécutent vos commandes de test listées avant de terminer

Pas pour

  • Une politique appliquée par la machine : c'est un texte d'orientation, et les prompts explicites de l'utilisateur dans le chat le priment

Comment installer AGENTS.md

Il vous faut : Un agent qui lit AGENTS.md

  1. Créez un fichier AGENTS.md à la racine du dépôt
  2. Ajoutez des sections comme la présentation du projet, les commandes de build et de test, le style de code, les tests et les consignes de PR
  3. Pour les monorepos, ajoutez un autre AGENTS.md dans chaque package
  4. Pour migrer : mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md
  5. Gemini CLI : définissez context.fileName sur AGENTS.md dans .gemini/settings.json ; Aider : ajoutez read: AGENTS.md à .aider.conf.yml
Exemple de configuration (tiré de la documentation officielle)
{
  "context": {
    "fileName": "AGENTS.md"
  }
}

Limites

  • Aucun champ obligatoire ni schéma ; le comportement dépend de chaque agent
  • Les conflits sont résolus par le fichier le plus proche, les prompts du chat priment sur tout

Outils qu'il étend

Programmation Offre gratuite

OpenAI Codex

Web · Desktop · Mobile

Pas encore d'avis d'utilisateurs

Agent de code d'OpenAI pour la CLI, l'extension IDE, l'application de bureau, le web et iOS, inclus dans les offres ChatGPT ou facturé via l'API.

La gratuité s'arrête à : Desktop app only listed, Usage limits apply

Listed Pas encore évalué

Vérifié developers.openai.com (ouvre le site de OpenAI Codex dans un nouvel onglet)

Gratuit · payant dès $8/mo US · vérifié Sep 29

CompareAdded OpenAI Codex Détails environ OpenAI Codex
Programmation Offre gratuite
Pas encore d'avis d'utilisateurs

IDE de codage par IA, anciennement Windsurf, devenu Devin Desktop : gérez des agents de codage locaux et cloud dans un IDE complet.

La gratuité s'arrête à : Light quota for agent usage, resets daily and weekly, Limited model availability

Listed Pas encore évalué

Vérifié windsurf.com (ouvre le site de Devin Desktop (formerly Windsurf) dans un nouvel onglet)

Gratuit · payant dès $20/mo US · vérifié Sep 29

CompareAdded Devin Desktop (formerly Windsurf) Détails environ Devin Desktop (formerly Windsurf)

Questions fréquentes

Y a-t-il des champs obligatoires dans AGENTS.md ?

Non. C'est du Markdown standard ; utilisez les titres que vous voulez. source

Que se passe-t-il quand des fichiers AGENTS.md entrent en conflit ?

L'AGENTS.md le plus proche du fichier édité l'emporte, et les prompts explicites de l'utilisateur dans le chat priment sur tout. source

Comment faire lire AGENTS.md par Gemini CLI ?

Définissez context.fileName sur AGENTS.md dans .gemini/settings.json. source

Quels agents prennent en charge AGENTS.md ?

Le site cite Codex, Jules, Factory, Aider, goose, opencode, Zed, Warp, VS Code, Devin, Junie, Amp, Cursor, RooCode, Gemini CLI, Kilo Code, Copilot coding agent, Windsurf et d'autres. source

Guides associés

Sources et lacunes

Non précisé par les mainteneurs : L'URL du repo et la licence n'ont pas été récupérées depuis la page ; repo_url est le repo GitHub de l'organisation du projet, non vérifié; Les règles de découverte d'AGENTS.md propres à Codex n'ont pas été lues; Dépôt source public (source fermée ou non vérifiée).

Autres extensions à découvrir