Fichiers d’instructions des agents
Chaque agent de code charge un fichier de projet contenant des instructions permanentes avant de commencer à travailler. Voici où chaque outil cherche ces fichiers, quelles métadonnées frontmatter il comprend et comment les versions globales, de projet et imbriquées se combinent, d’après la documentation des éditeurs vérifiée le 2026-10-01.
Quel outil lit quel fichier
| Outil | Lit | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | Natif |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | Natif |
| Cursor | .cursor/rules/*.mdcAGENTS.md | Natif |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | Natif |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | Via la configuration |
| Devin Desktop (anciennement Windsurf) | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | Natif |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | Natif |
| Aider | .aider.conf.yml | Via la configuration |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | Natif |
Utilisez un seul AGENTS.md comme source de vérité et faites pointer les autres outils vers celui-ci. Sept des neuf outils ci-dessus le lisent directement ; Gemini CLI et Aider nécessitent une ligne de configuration, et un fichier CLAUDE.md contenant uniquement @AGENTS.md permet de garder les anciennes versions de Claude Code à jour. N’utilisez le format de règles propre à chaque outil que pour les règles limitées à certains chemins qu’AGENTS.md ne peut pas exprimer.
Tous les fichiers d’instructions
AGENTS.mdAGENTS.md
AGENTS.md est un fichier Markdown en texte brut qui contient les instructions du projet et que la plupart des agents de programmation lisent sans configuration supplémentaire. OpenAI en a fait don à l’Agentic AI Foundation, sous l’égide de la Linux Foundation, et plus de 60k projets open source l’utilisent.
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md est le fichier mémoire que Claude Code charge au démarrage depuis votre répertoire personnel, le projet et chaque répertoire parent. Les règles associées à des chemins dans .claude/rules/ fournissent des consignes supplémentaires, chargées uniquement lors de la lecture de fichiers correspondants.
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md est le fichier de contexte que Gemini CLI envoie avec chaque prompt. Il peut également lire AGENTS.md ou tout autre nom défini dans context.fileName.
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
Les Project Rules de Cursor sont des fichiers .mdc dans .cursor/rules/ ; leur frontmatter détermine quand chaque règle est ajoutée au contexte. Cursor lit également AGENTS.md, ainsi que les User Rules et Team Rules définies en dehors du dépôt.
.github/copilot-instructions.mdGitHub Copilot custom instructions
GitHub Copilot lit un fichier pour tout le dépôt, .github/copilot-instructions.md, ainsi que des fichiers .instructions.md spécifiques à certains chemins. Il prend également en compte AGENTS.md, ou un seul fichier CLAUDE.md ou GEMINI.md à la racine.
.devin/rules/*.mdDevin Desktop (Windsurf) rules
Devin Desktop, le nouveau nom de Windsurf depuis le 2026-06-02, lit les fichiers de règles dans .devin/rules/ et accepte toujours .windsurf/rules/ ainsi que l'ancien fichier .windsurfrules. Le déclencheur de chaque règle détermine si elle est toujours active, sélectionnée par glob, choisie par le modèle ou appelée manuellement.
.clinerules/Cline Rules (.clinerules/)
Les règles Cline sont des fichiers Markdown dans .clinerules/ que Cline combine avec les règles globales et AGENTS.md. Le champ facultatif paths du frontmatter limite une règle aux fichiers correspondants.
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
OpenClaw construit le contexte de chaque agent à partir de fichiers Markdown d’initialisation dans son espace de travail, en commençant par un fichier AGENTS.md obligatoire. Ces fichiers sont injectés dans le prompt système au premier tour de chaque nouvelle session.