# Qu’est-ce qu’AGENTS.md ?

URL: https://agentvera.dev/fr/glossary/agents-md/

AGENTS.md est un fichier Markdown ouvert et simple, placé dans un dépôt, qui explique aux agents de code IA comment travailler sur le projet : comment le compiler et le tester, quelles conventions suivre et quoi éviter. Voyez-le comme un README pour agents, lu par de nombreux outils différents.

**Quels agents le lisent.** Le format est décrit sur agents.md, qui recense plus de 20 outils compatibles. La prise en charge varie dans le détail : consultez aussi la documentation de votre agent.

- Codex, Cursor, l’agent de code de GitHub Copilot, opencode, Amp, Aider, goose, Zed, Warp, Junie et Jules le lisent, entre autres.
- Gemini CLI lit GEMINI.md par défaut ; ajoutez AGENTS.md au réglage context.fileName de settings.json et il le lira aussi.
- Claude Code lit CLAUDE.md et, depuis la version 2.1.277, lit AGENTS.md quand le dépôt n’a pas de CLAUDE.md. Vous pouvez aussi l’importer dans CLAUDE.md avec @AGENTS.md.

**AGENTS.md, CLAUDE.md et GEMINI.md.** CLAUDE.md et GEMINI.md sont les fichiers propres à Claude Code et à Gemini CLI ; AGENTS.md est le fichier commun. Les trois contiennent le même type d’informations. Une organisation courante garde les règles communes dans AGENTS.md et fait pointer les fichiers de chaque outil vers lui, en n’ajoutant que ce qui est spécifique, pour que les consignes ne divergent pas. Si les deux existent, Claude Code ne lit par défaut que CLAUDE.md : importez-y AGENTS.md ou modifiez le réglage Project instructions.

**Que mettre dedans.** Notez ce qu’un nouveau collègue devrait savoir le premier jour et ce que vous répéteriez sinon dans chaque prompt. Restez bref : les agents le chargent dans leur contexte au début d’une session.

- Les commandes d’installation, de build et de test, exactement telles qu’on les lance.
- Le style de code et les conventions que le linter ne vérifie pas.
- L’organisation du projet : où se trouve quoi et quels dossiers sont générés.
- Les règles pour les commits et les pull requests.
- Ce qu’il ne faut jamais faire, comme modifier des fichiers générés ou committer des secrets.

**Un court exemple.** Un AGENTS.md minimal pour un projet TypeScript pourrait ressembler à ceci. Dans un monorepo, chaque paquet peut avoir son propre AGENTS.md, et les agents utilisent le plus proche du fichier qu’ils modifient.

- ## Commandes : pnpm install ; lancer pnpm test avant chaque commit et pnpm lint après avoir déplacé des fichiers.
- ## Style : TypeScript en mode strict, guillemets simples, pas de points-virgules.
- ## Organisation : code de l’app dans src/ ; le client d’API dans src/gen/ est généré, ne jamais le modifier à la main.
- ## Pull requests : titre au format « [paquet] Résumé court » ; lint et tests doivent passer.

**La place d’AgentVera.** AgentVera lance la CLI propre à chaque agent dans le dossier du projet, si bien qu’AGENTS.md et les fichiers de chaque outil s’appliquent comme d’habitude ; le champ rôle et instructions d’un agent ajoute des consignes permanentes par-dessus, et les CLI sans option pour des instructions supplémentaires (Cursor, Gemini CLI et Amp, par exemple) s’appuient sur l’AGENTS.md ou les fichiers de règles du projet.

- **AGENTS.md est-il une norme formelle ?** C’est un format ouvert sans champ obligatoire ni schéma : du Markdown simple avec les titres qui vous servent. Son site est agents.md.
- **Faut-il à la fois CLAUDE.md et AGENTS.md ?** Pas forcément. Les versions récentes de Claude Code lisent AGENTS.md quand il n’y a pas de CLAUDE.md. Pour des règles propres à Claude, gardez un CLAUDE.md court qui importe AGENTS.md avec @AGENTS.md.
- **Où placer le fichier ?** À la racine du dépôt. Les gros dépôts peuvent en ajouter dans des sous-dossiers ; le fichier le plus proche du code modifié l’emporte, et une instruction directe dans le chat passe avant tout.
- **Quelle longueur viser ?** Aussi court que possible tout en restant utile. Il occupe du contexte à chaque session, et une règle noyée dans un long fichier échappe plus facilement à un agent.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/