Le directeur exécutif de Shopify, Tobi Lütke, a évoqué la possibilité d'interdire l'utilisation de l'assistant de codification Claude Code d'Anthropic au sein de l'entreprise. Cette mise en garde ne découle pas d'un problème relatif à la qualité de l'outil, mais des différences dans la manière dont les fichiers d'instructions pour agents de intelligence artificielle sont lus et interprétés dans les dépôts de code.
Lütke soutient que le manque de compatibilité avec certains fichiers clés génère une complexité inutile et pourrait affecter la cohérence du travail de milliers de développeurs collaborant dans le vaste monorepositoire de Shopify.
Problèmes de compatibilité entre Claude Code et les fichiers d'instructions
Le point central du conflit réside dans la manière dont les différentes outils d'intelligence artificielle traitent les fichiers de configuration et les directives au sein des dépôts de code.
Lütke a exprimé qu'il est en train de considérer le veto à Claude Code jusqu'à ce qu'Anthropic modifie l'outil pour qu'il puisse lire des fichiers tels que AGENTS.md et .agents/skills, qui sont essentiels pour maintenir la cohérence dans les processus de développement chez Shopify.
La plateforme de commerce électronique, avec des milliers de développeurs, fait face au défi d'assurer que tous les agents d'IA impliqués interprètent les mêmes règles et instructions pour chaque segment de code.
Selon Lütke, lorsque les agents ne lisent pas les mêmes fichiers d'instructions, il existe un risque que des équipes travaillent sous des critères différents, ce qui peut entraîner des problèmes de communication et de qualité dans le développement des logiciels.
Le CEO a expliqué que les fichiers de configuration s'appliquent de manière récursive dans l'arbre du dépôt et que, si l'un des fichiers manque dans certains répertoires, un sous-ensemble de développeurs est exposé à une configuration déficiente.
Cette situation peut provoquer ce que Lütke a qualifié de "lobotomie" dans le fonctionnement des agents, en travaillant avec des informations incomplètes ou obsolètes par rapport au reste de l'équipe.
Le responsable a souligné que l'insistance d'Anthropic à ce que Claude Code ne lise que le fichier CLAUDE.md, au lieu d'adopter le standard AGENTS.md, génère des frictions inutiles entre les équipes. La diversité des outils d'IA au sein de Shopify multiplie ce type de désagréments, car il n'existe pas de convention unifiée pour les instructions persistantes dans les dépôts.
Automatisation et coûts supplémentaires dus au manque de standardisation en IA
Pour atténuer ces différences, Shopify a mis en œuvre des solutions d'automatisation permettant de synchroniser les instructions et d'éviter les erreurs résultant du manque de compatibilité entre les fichiers. Cependant, Lütke estime que cette adaptation engendre un coût supplémentaire que l'entreprise ne devrait pas avoir à supporter s'il y avait une plus grande volonté de standardisation de la part des fournisseurs de outils d'IA.
La société a réussi à résoudre ce problème par le biais de scripts et de systèmes automatiques qui répliquent ou lient les fichiers nécessaires dans différents dossiers du projet. Néanmoins, le CEO insiste sur le fait que ce processus ajoute de la complexité au flux de travail des ingénieurs et représente un effort supplémentaire qui pourrait être évité si les outils, comme Claude Code, adoptaient la lecture native des fichiers AGENTS.md.
Lütke a souligné que la solution automatisée n'est qu'un palliatif face à un manque d'interopérabilité entre les différents assistants de codification. Le responsable pense que les ingénieurs de sa société ne devraient pas consacrer de ressources à corriger des déficiences d'intégration qui pourraient être résolues depuis le développement original des outils de IA.
Origine des fichiers AGENTS.md et CLAUDE.md dans le développement d'agents d'IA
La création des fichiers d'instructions tels que AGENTS.md et CLAUDE.md répond à la nécessité pour les agents d'IA de recevoir des indications claires et persistantes sur la manière d'opérer sur chaque base de code.
À mesure que les agents deviennent plus complexes et autonomes, il est requis que les équipes d'ingénierie puissent établir des règles, des commandes de compilation, des exigences de test et des conventions de codage de manière centralisée et accessible pour tout assistant d'IA qui interagit avec le dépôt.
OpenAI a introduit le fichier AGENTS.md en août 2025 en réponse à cette nécessité. L'objectif était d'offrir une méthode standardisée permettant aux agents de codification de recevoir des instructions spécifiques selon le projet sur lequel ils travaillent.
Quelques mois plus tard, OpenAI a déclaré que plus de 60 000 projets de code source et cadres d'agents utilisaient déjà AGENTS.md, avec un support confirmé dans des outils comme Codex, Cursor, Gemini CLI, GitHub Copilot, Jules et Visual Studio Code. Par la suite, le format a été pris en charge par la Agentic AI Foundation, une entité liée à la Linux Foundation.
En revanche, Claude Code d'Anthropic utilise son propre fichier, CLAUDE.md, pour stocker les instructions pertinentes. Ce fichier peut se trouver à différents emplacements à l'intérieur d'un dépôt et l'outil le consulte durant l'exécution.
Cependant, par défaut, Claude Code ne reconnait ni ne traite les fichiers AGENTS.md, ce qui a motivé la demande de plusieurs développeurs pour qu'Anthropic implémente cette fonctionnalité.
Anthropic a proposé des alternatives, comme importer le contenu d'AGENTS.md à partir d'un fichier CLAUDE.md ou utiliser des liens symboliques pour connecter les deux fichiers. Mais dans des dépôts de grande taille et de haute complexité, comme celui de Shopify, ces solutions nécessitent une gestion active pour maintenir la synchronisation des instructions dans tous les répertoires pertinents.