--- title: "Générateur d’AGENTS.md avec des règles pour cinq agents de code · DotsAgent" description: "Remplissez un formulaire pour obtenir un fichier AGENTS.md, la même règle limitée à un chemin pour Cursor, Copilot, Claude Code, Cline et Devin, ainsi que des fichiers relais pour Gemini CLI et Aider." url: https://dotsagent.io/fr/instructions --- Instruct · outil # Générateur d’AGENTS.md Remplissez un formulaire pour obtenir un fichier AGENTS.md avec vos commandes, conventions et limites strictes. Vous obtenez aussi une règle limitée à un chemin, déclinée pour Cursor, GitHub Copilot, Claude Code, Cline et Devin Desktop, ainsi que des fichiers relais pour les outils qui ne prennent pas en charge AGENTS.md par défaut. [Où chaque outil cherche ses fichiers d’instructions →](https://dotsagent.io/fr/instructions/files) `AGENTS.md` ``` # Application web Acme Une application web destinée aux clients, avec une zone d’administration et une petite API REST. ## Respectez la stack Next.js, React, TypeScript, pnpm ## Utilisez ces commandes - Installez: `pnpm install` - Lancez en local: `pnpm dev` - Testez: `pnpm test` - Vérifiez le lint et les types: `pnpm lint && pnpm tsc --noEmit` - Générez le build: `pnpm build` ## Respectez le style de code - Respecte le formatage imposé par le linter et ne modifie pas les fichiers qui n’ont pas besoin de l’être. - Privilégie les petites fonctions aux entrées et sorties claires ; limite les effets de bord aux frontières du système. - Demande avant d’ajouter une dépendance. - Commente les raisons qui motivent le code peu évident, pas le rôle de chaque ligne. ## Tests - Ajoute ou mets à jour un test pour chaque comportement que tu modifies. - Exécute la commande de test et corrige les échecs avant d’indiquer que tu as terminé. - Ne supprime pas et ne désactive pas un test en échec pour que la suite passe. ## Commits et pull requests - Rédige les sujets de commit à l’impératif et en moins de 72 caractères. - Limite chaque pull request à une seule modification et indique dans sa description comment tu l’as testée. - Exécute le linter et les tests avant chaque commit. ## Ne jamais - Ne committe jamais de secrets, de clés API ou de fichiers .env. - Ne modifie jamais manuellement les fichiers générés dans src/generated/ ; régénère-les plutôt. - N’exécute jamais de commande destructive sur la base de données de production. - Ne force jamais un push sur main et ne réécris jamais l’historique partagé. ``` ### La même règle pour cinq outils Une règle en cinq formats ; enregistre chaque fichier au chemin indiqué au-dessus. `.cursor/rules/scoped.mdc` ``` --- description: Conventions pour les fichiers correspondant à ce glob globs: app/**/*.tsx alwaysApply: false --- Suis les conventions déjà utilisées dans les fichiers voisins de ce dossier. Chaque fonction exportée doit avoir une docstring et un test dans le fichier de test correspondant. ``` `.github/instructions/scoped.instructions.md` ``` --- applyTo: "app/**/*.tsx" --- Suis les conventions déjà utilisées dans les fichiers voisins de ce dossier. Chaque fonction exportée doit avoir une docstring et un test dans le fichier de test correspondant. ``` `.claude/rules/scoped.md` ``` --- paths: - "app/**/*.tsx" --- Suis les conventions déjà utilisées dans les fichiers voisins de ce dossier. Chaque fonction exportée doit avoir une docstring et un test dans le fichier de test correspondant. ``` `.clinerules/scoped.md` ``` --- paths: - "app/**/*.tsx" --- Suis les conventions déjà utilisées dans les fichiers voisins de ce dossier. Chaque fonction exportée doit avoir une docstring et un test dans le fichier de test correspondant. ``` `.devin/rules/scoped.md` ``` --- trigger: glob globs: app/**/*.tsx --- Suis les conventions déjà utilisées dans les fichiers voisins de ce dossier. Chaque fonction exportée doit avoir une docstring et un test dans le fichier de test correspondant. ``` ## Comment rédiger un fichier d’instructions efficace ### Placez les commandes exactes près du début Indiquez dès le début du fichier les vraies commandes d’installation, de test et de lint, avec leurs options. Précisez la stack et les versions, et ajoutez un court exemple de code lorsque le texte serait trop vague. Blog GitHub, analyse de plus de 2 500 fichiers AGENTS.md ### Formulez explicitement les interdictions Indiquez clairement ce que l’agent ne doit pas faire, par exemple toucher aux secrets, au code vendored ou à la production. « Ne commitez jamais de secrets » était la contrainte utile la plus fréquente dans les fichiers examinés par GitHub. Blog GitHub, analyse de plus de 2 500 fichiers AGENTS.md ### Rendez chaque instruction vérifiable « Exécutez npm test avant de committer » est vérifiable ; « testez vos modifications » ne l’est pas. Supprimez les contradictions : lorsque deux lignes se contredisent, le modèle peut suivre l’une ou l’autre. Documentation sur la mémoire de Claude Code ### Soyez concis et séparez les règles par chemin Anthropic recommande de rester sous 200 lignes par fichier et Cursor sous 500 lignes par règle. Déplacez les consignes propres à une zone dans une règle limitée à son chemin, pour qu’elle ne soit chargée que lorsque ces fichiers sont concernés. Les imports rendent un fichier plus propre, mais ne réduisent pas le coût du contexte. Documentation sur la mémoire de Claude Code ; documentation Cursor Rules ### Évitez ce que l’agent sait déjà Dans une étude portant sur quatre agents de programmation, les fichiers de contexte n’ont pas amélioré de façon fiable la réussite des tâches et ont augmenté le coût d’inférence de plus de 20 %. Les fichiers rédigés par un LLM ont légèrement dégradé les résultats, et les présentations des dépôts n’ont rien apporté. Limitez donc le fichier aux exigences peu évidentes, comme les outils à utiliser. ETH Zurich SRI Lab, arXiv 2602.11988 ### Ajoutez des règles lorsque les erreurs se répètent Commencez avec peu de règles et ajoutez-en une lorsque vous constatez que l’agent répète la même erreur. Indiquez un fichier existant comme modèle au lieu de coller un guide de style complet. Documentation Cursor Rules ; blog GitHub ## Questions sur AGENTS.md ### Claude Code lit-il AGENTS.md ? Oui, depuis la v2.1.277. Par défaut, il ne lit AGENTS.md ou .claude/AGENTS.md que si le répertoire de travail et ses répertoires parents ne contiennent ni CLAUDE.md, ni .claude/CLAUDE.md, ni CLAUDE.local.md. Le paramètre claude-md-and-agents-md charge les deux fichiers. Vous pouvez aussi utiliser @AGENTS.md dans un fichier CLAUDE.md, quelle que soit la version. ### AGENTS.md doit-il contenir un frontmatter ou des titres précis ? Non. AGENTS.md est un fichier Markdown sans champs obligatoires ; vous pouvez choisir les titres que vous voulez. Le site agents.md suggère des sections comme une présentation du projet, les commandes de build et de test, le style de code, les tests, les consignes de sécurité et les règles relatives aux pull requests. ### Comment utiliser AGENTS.md dans un monorepo ? Placez un fichier AGENTS.md à la racine, puis un autre dans chaque package qui nécessite ses propres règles. Les agents lisent le fichier le plus proche du code modifié ; en cas de conflit, c’est ce fichier qui prévaut. Le dépôt principal d’OpenAI en comptait 88 lorsque agents.md a documenté ce point. ### Comment faire lire AGENTS.md par Gemini CLI ? Par défaut, Gemini CLI utilise toujours GEMINI.md. Ajoutez AGENTS.md à context.fileName dans .gemini/settings.json, par exemple ["AGENTS.md", "GEMINI.md"]. Exécutez /memory show pour vérifier ce qui a été chargé. ### Quels agents de programmation prennent en charge AGENTS.md ? Nous avons vérifié la documentation d’OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Devin Desktop, Cline et OpenClaw, qui lisent tous le fichier nativement. Gemini CLI et Aider nécessitent une ligne de configuration. Le site agents.md répertorie 23 outils compatibles au total, dont Zed, Warp, goose, opencode, Jules et JetBrains Junie. ### Qui maintient le format AGENTS.md ? OpenAI a contribué AGENTS.md à l’Agentic AI Foundation, un fonds placé sous l’égide de Linux Foundation, annoncé le 2025-12-09 en même temps que MCP et goose. Selon le site agents.md, plus de 60k projets open source l’utilisent. Référence indépendante pour les personnes qui créent des agents IA. Sans affiliation avec les fournisseurs cités. © 2026 DotsAgent · Données vérifiées le 1 octobre 2026