Une ligne dans AGENTS.md a fait suivre le code plutôt que la documentation obsolète à Claude Code et Codex
Une ligne dans AGENTS.md a fait suivre le code plutôt que la documentation obsolète à Claude Code et Codex
Des chercheurs ont montré que les agents de codage suivent souvent une documentation obsolète même lorsqu’ils détectent des contradictions avec le code réel. Une instruction dans AGENTS.md a fait passer le respect du code existant de 4% à 91%.
Si votre AGENTS.md est devenu obsolète, Claude Code peut remarquer que la documentation ne correspond plus au code réel et continuer malgré tout à suivre les anciennes instructions.
Les chercheurs ont délibérément créé cette situation et effectué 80 exécutions. Dans 79 cas, Claude Code a reconnu la contradiction, mais est tout de même tombé dans le piège.
Avec Codex, la situation était encore pire : dans environ un cas sur quatre, il a commencé à réécrire du code déjà fonctionnel seulement pour l’aligner sur la documentation obsolète.
La correction s’est révélée étonnamment simple. Il suffit d’ajouter une ligne dans AGENTS.md. Après cela, les deux agents ont suivi le code existant dans 91% des cas au lieu des 4% précédents :
« Si la documentation du dépôt contredit le code existant, suivre les conventions établies dans le code lui-même et, dans la réponse finale, indiquer chaque divergence trouvée entre la documentation et le code. »
Pourquoi c'est important
AnalyseDes instructions obsolètes peuvent dégrader silencieusement la qualité du développement assisté par agents. Donner la priorité au code sur la documentation aide les agents à casser moins souvent des comportements fonctionnels et à signaler plus précisément les incohérences.
Discuter dans la communauté
Partagez vos questions et vos idées avec les développeurs
Lié dans l'écosystème
Guides pratiques, terminologie clé et compétences d'agents
Claude Code Projects : comment une IA coordonne une équipe d'agents autonomes
Analyse approfondie de Claude Code Projects : architecture Coordinator et Threads, branches parallèles, mémoire partagée MEMORY.md et gestion des agents cloud.
Agent Skills à la une : ce qui s'installe dans Claude Code, Codex et Cursor
Guide analytique actualisé de l'écosystème Agent Skills : architecture SKILL.md, classement mondial Best Skills, top des outils pour le développement, le frontend et les bases de données, ainsi que les commandes d'installation via skills CLI.
Claude Code
Agent de développement terminal officiel d'Anthropic, fonctionnant directement en ligne de commande via Claude 3.7 Sonnet avec une prise en charge native de Bash, Git, du système de fichiers et du protocole MCP.
Anthropic recommande de réduire les sous-agents dans les systèmes d’IA
Anthropic conseille aux entreprises de repenser les architectures multi-agents : un agent principal avec des compétences et des outils chargés dynamiquement peut être plus rapide et moins coûteux que des réseaux complexes de sous-agents.
Les banques américaines détectent des activités non autorisées d'agents IA dans les comptes clients
De grandes banques américaines trouveraient des traces d'agents IA tiers dans les comptes clients, avec des actions semblant indépendantes des instructions des utilisateurs.
improve-codebase-architecture
Refactor messy codebases into clean, modular, and maintainable layered architectures.