Contexte et besoin

Les équipes DevOps qui utilisent plusieurs agents de codage (Claude, Codex, Cursor, etc.) se retrouvent souvent avec plusieurs fichiers d’instructions – CLAUDE.md pour Claude Code et AGENTS.md pour les autres outils. Cette duplication entraîne une dérive de configuration, des symlinks temporaires et un risque de rupture lorsqu’un agent ne trouve plus la commande attendue. Anthropic a publié le 18 septembre 2026 la version 2.1.277 de Claude Code afin de réduire ce « instruction file sprawl ».

Mécanisme de fallback AGENTS.md

Dans la nouvelle version, Claude Code recherche d’abord un fichier CLAUDE.md dans le répertoire courant ou dans les répertoires parents. En l’absence de ce fichier, il charge automatiquement AGENTS.md. Si les deux fichiers existent, CLAUDE.md l’emporte et AGENTS.md est ignoré, sauf si la configuration indique le contraire. Le comportement est récapitulé dans la documentation officielle :

# /config – Project instructions
# Valeurs possibles :
#   claude-md-or-agents-md (défaut) – charge CLAUDE.md ou AGENTS.md
#   claude-md-and-agents-md – charge les deux, CLAUDE.md d’abord
#   claude-md – ignore AGENTS.md
#   managed-only – ne charge que le CLAUDE.md géré par l’organisation

Dans les monorepos, chaque sous‑dossier peut contenir son propre AGENTS.md. Le fichier le plus proche du fichier ouvert prend la priorité, ce qui respecte la convention de placer un AGENTS.md par package.

Paramètres de configuration et limites

Plusieurs contraintes limitent l’adoption immédiate :

CLAUDE.local.md est considéré comme un CLAUDE.md et masque donc le AGENTS.md. La solution consiste à activer le mode claude-md-and-agents-md.

Le support de AGENTS.md n’est pas disponible sur les plateformes Bedrock, Vertex ou Foundry, ni dans les sessions où les feature flags d’Anthropic ne sont pas récupérés (par ex. télémetrie désactivée). La toute première session après une installation ou une mise à jour ne lit pas non plus le fichier.

Les fichiers AGENTS.local.md, AGENTS.override.md ou tout contenu sous .agents/ sont explicitement ignorés, obligeant les équipes à conserver leurs compétences dans le fichier standard ou à recourir à une importation depuis CLAUDE.md.

Enfin, un AGENTS.md chargé via le paramètre ne figure pas dans /memory ni dans les hooks InstructionsLoaded. Ces hooks ne s’activent que lorsqu’un AGENTS.md est importé ou symlinké depuis CLAUDE.md, ce qui peut impacter les outils de gouvernance qui s’appuient sur ces événements.

Implications pour la gouvernance des agents

Le AGENTS.md devient le premier artefact de gouvernance pour le comportement des agents autonomes : il décrit les commandes autorisées, les interdictions et les flux de construction. Selon Mitch Ashley (The Futurum Group), la convergence vers un seul format d’instructions réduit la dérive et simplifie les revues de code, à condition d’attribuer la responsabilité de ce fichier à l’ingénierie plateforme.

Les équipes doivent donc :

1. Auditer les dépôts pour identifier les fichiers d’instructions existants.
2. Choisir AGENTS.md comme source de vérité lorsqu’aucun CLAUDE.md n’est requis.
3. Vérifier l’absence de CLAUDE.local.md qui pourrait masquer le fichier partagé.
4. Tester le chargement sur les environnements CI/CD et cloud réellement utilisés.

Plus de 60 000 projets open‑source utilisent déjà le format AGENTS.md, et plus de 30 outils le déclarent compatible, ce qui indique une adoption suffisante pour justifier la standardisation au sein des pipelines d’entreprise.