AGENTS.md : comment écrire le fichier de règles que la plupart des agents de codage lisent maintenant

Si vous avez acheté OpenAI Codex, OpenCode ou une demi-douzaine d'agents de codage plus récents, vous avez rencontréAGENTS.md: un simple fichier Markdown à la racine de votre dépôt qui indique à l'agent comment fonctionne votre projet. Pas de frontmatter, pas de schéma, pas de syntaxe spéciale – c'est exactement pourquoi la plupart d'entre eux sont mauvais. Quand quelque chose est valide, rien ne vous oblige à écrire les parties que l'agent utilise réellement.

Cet article explique comment le fichier est résolu, une structure en quatre sections qui résiste dans la pratique et les erreurs d'écriture spécifiques qui poussent les agents à ignorer discrètement vos règles.

Qui lit AGENTS.md (et qui ne le fait pas)

AGENTS.mda commencé comme fichier d'instructions pour OpenAI Codex et est devenu ce qui se rapproche le plus d'un outil d'agent d'une norme partagée - OpenCode le lit de manière native, et une liste croissante d'éditeurs et d'agents le lisent directement ou l'acceptent comme source de règles. Le schéma converge car le problème de contenu est identique partout : l'agent a besoin de savoir ce qu'est ce projet, comment effectuer ses contrôles et à quoi il ne doit pas toucher.

Deux notes pratiques avant d’assumer la portabilité :

• Claude Code ne lit pasAGENTS.md— ça litCLAUDE.md. La structure porte presque 1:1, mais le nom de fichier compte. Si vous conservez les deux, faites de l'une la source de vérité et faites-y référence à partir de l'autre au lieu de conserver deux copies divergentes.
• Le format natif du curseur est différent (.cursor/rules/*.mdcavec ...
  [Courte citation de 8% de l'article original]