AGENTS.md & CLAUDE.md : Le nouveau README pour les agents de codage IA

Si vous avez récemment utilisé un assistant de codage IA, vous avez probablement remarqué quelque chose : ils veulent tous un fichier Markdown.

GitHub Copilot lit .github/copilot-instructions.md. Cursor lit .cursor/rules/. Claude Code lit CLAUDE.md. Windsurf lit .windsurf/rules. Jules de Google lit JULES.md. Et le standard universel ? AGENTS.md — désormais utilisé par plus de 60 000 dépôts open source et géré par l’Agentic AI Foundation de la Linux Foundation.

Markdown est passé d’un format de documentation à un système d’exploitation pour les agents de codage IA.

Qu’est-ce qu’AGENTS.md ?

AGENTS.md est un simple fichier Markdown en format ouvert qui réside dans votre dépôt et agit comme un dossier de briefing pour les agents de codage IA. Considérez-le comme le pendant de README.md :

• README.md est pour les humains : démarrages rapides, descriptions de projet, badges
• AGENTS.md est pour les agents IA : étapes de build, commandes de test, conventions de codage, décisions architecturales

L’agent lit le fichier le plus proche dans l’arborescence, donc le plus proche a la priorité. Chaque sous-projet peut embarquer ses propres instructions.

Qu’est-ce que CLAUDE.md ?

CLAUDE.md est spécifiquement conçu pour Claude Code d’Anthropic. Il est lu automatiquement au début de chaque session et contient les instructions spécifiques au projet que vous devriez autrement répéter dans chaque prompt.

Un bon CLAUDE.md comprend généralement :

• Contexte du projet : Une ligne qui oriente Claude sur ce que fait le projet
• Style de code : Vos préférences de formatage, conventions de nommage, patterns à suivre
• Commandes : Comment lancer les tests, construire, linter et déployer
• Notes d’architecture : Décisions clés que Claude doit respecter

L’approche recommandée : mettez les instructions partagées dans AGENTS.md (pour que tous les outils IA en bénéficient), puis ajoutez les fonctionnalités spécifiques à Claude dans CLAUDE.md.

Le paysage complet des fichiers d’instructions IA

Voici tous les principaux outils de codage IA et leurs conventions Markdown :

Outil	Fichier	Format
GitHub Copilot	.github/copilot-instructions.md	Markdown
Cursor	.cursor/rules/*.md	Markdown
Claude Code	CLAUDE.md	Markdown
Windsurf	.windsurf/rules	Markdown
Google Jules	JULES.md	Markdown
Universel	AGENTS.md	Markdown

Vous voyez le pattern ? C’est tout du Markdown. Sans exception.

Pourquoi Markdown a gagné

Markdown est le format parfait pour les fichiers d’instructions d’agents parce que :

1. Les LLMs le comprennent nativement — c’est le format le plus courant dans leurs données d’entraînement
2. Il est lisible par les humains — les développeurs peuvent facilement réviser et modifier les instructions
3. Il est versionnable — vit dans git aux côtés de votre code
4. Il est léger — pas de surcharge d’analyse, pas d’outillage spécial nécessaire
5. Il est universel — fonctionne avec tous les outils IA, éditeurs et plateformes

Comme l’a dit Visual Studio Magazine : dans l’IA agentique, tout tourne autour de Markdown.

Bonnes pratiques pour rédiger des instructions d’agents

D’après l’analyse de milliers de dépôts :

Commencez minimal. N’ajoutez des règles que lorsque vous remarquez que l’agent répète la même erreur. Des instructions trop détaillées peuvent semer plus de confusion qu’elles n’en résolvent.

Soyez précis sur les commandes. Ne dites pas « lance les tests » — dites pnpm test ou pytest -x tests/.

Documentez votre architecture. Si votre projet utilise un pattern spécifique (comme le passage de messages entre un content script et un service worker), expliquez-le. L’agent ne peut pas déduire les décisions architecturales du code seul.

Incluez ce qu’il ne faut PAS faire. Les instructions négatives sont étonnamment efficaces : « Ne jamais modifier le schéma de base de données directement » ou « Ne pas utiliser de class components, toujours utiliser des hooks. »

La place de Save dans cet écosystème

Si vous créez des fichiers d’instructions pour agents, vous enregistrez probablement aussi du matériel de référence depuis le web : pages de documentation, réponses Stack Overflow, README GitHub, références API.

Save convertit n’importe laquelle de ces sources web en Markdown propre en un clic — parfait pour construire le contexte dont vos agents IA ont besoin. Enregistrez une page de documentation, collez le Markdown dans votre AGENTS.md ou vos docs de référence, et votre assistant de codage IA dispose instantanément du contexte dont il a besoin.

Le workflow :

1. Trouvez de la documentation ou des exemples de code utiles sur le web
2. Cliquez sur Save pour convertir en Markdown
3. Référencez ou intégrez dans vos fichiers d’instructions d’agents
4. Votre assistant de codage IA s’améliore à chaque sauvegarde

Le futur : Markdown comme surface de contrôle de l’IA

Microsoft et GitHub traitent désormais Markdown comme une surface de contrôle stable et auditable pour le comportement de l’IA. Ce n’est plus seulement de la documentation — c’est l’interface entre l’intention humaine et l’exécution par l’IA.

Nous voyons les fichiers Markdown remplir trois rôles distincts :

1. Documentation : Explique un système aux humains
2. Instruction : Contraint et oriente le comportement de l’IA
3. Skill : Regroupe instructions et ressources pour que les agents puissent reproduire des workflows

Cette tendance ne fait qu’accélérer. À mesure que les assistants de codage IA deviennent plus capables, les fichiers Markdown qui les guident deviennent plus importants.

---

Save convertit n’importe quelle page web en Markdown propre en un clic. Parfait pour construire des bibliothèques de référence, capturer de la documentation et créer du contexte pour vos workflows de codage IA. Essayez Save gratuitement.