CLAUDE.md vs AGENTS.md : quelle différence, et faut-il les deux ?
Ouvrez un repo qui utilise des agents IA aujourd'hui et vous tomberez probablement
sur l'un de ces deux fichiers à la racine : CLAUDE.md ou AGENTS.md.
Parfois les deux. La question revient souvent : est-ce redondant ?
CLAUDE.md — le format de Claude Code
CLAUDE.md est le fichier de contexte lu automatiquement par
Claude Code (le CLI d'Anthropic) à chaque session : conventions de
code, commandes de build/test, architecture du repo, règles spécifiques à l'équipe.
C'est un fichier Markdown libre — pas de schéma imposé — que Claude Code charge et
traite comme une instruction système prioritaire.
AGENTS.md — le format ouvert, multi-outils
AGENTS.md vise la même idée mais en format ouvert,
adopté par plusieurs outils (Cursor, Aider, et d'autres agents de code) qui ne sont
pas liés à un seul fournisseur. L'objectif : un seul fichier de contexte lisible par
n'importe quel agent qui respecte la convention, sans dépendre d'un outil précis.
Pourquoi pas un seul fichier pour les deux ?
En théorie, un contenu quasi identique suffirait aux deux. En pratique, deux raisons poussent à les garder distincts :
- Priorité de lecture — certains outils lisent un fichier avant l'autre, ou ignorent celui qu'ils ne reconnaissent pas ; dupliquer garantit que chaque agent trouve son format attendu sans devoir deviner.
- Dérive silencieuse — si un seul des deux fichiers est mis à jour après un changement d'architecture, l'agent qui lit l'autre travaille sur une version obsolète du projet sans que personne ne s'en aperçoive avant un bug ou une review ratée.
Le vrai problème n'est donc pas "lequel choisir", mais comment garder les deux synchronisés au fil des commits — sans que ce soit une tâche manuelle de plus que l'équipe oublie de faire.
C'est exactement ce que fait mindset-ctx
mindset-ctx génère CLAUDE.md et AGENTS.md à partir de la
même analyse du repo, et les régénère à chaque push structurant — pas de copier-coller
manuel entre les deux, pas de fichier qui prend du retard sur l'autre.
npm install -g mindset-ctx ctx generate .
Un seul run, deux fichiers de contexte à jour, quel que soit l'agent branché dessus. Open source, sur GitHub : github.com/Redcreator1/Mindset-Red