Tobi Lütke asegura que la dependencia de Claude Code de archivos propios como CLAUDE.md provoca inconsistencias cuando los desarrolladores utilizan distintos agentes de programación. El conflicto pone sobre la mesa una disputa más amplia por la interoperabilidad y los estándares de la nueva generación de herramientas de IA.
El director ejecutivo de Shopify, Tobi Lütke, amenazó con prohibir el uso de Claude Code dentro de la compañía si Anthropic no modifica la forma en que su agente de programación procesa las instrucciones de los repositorios de software. La advertencia no está relacionada con el rendimiento del modelo ni con la calidad del código que produce. El conflicto gira alrededor de los archivos donde una empresa indica a sus agentes de inteligencia artificial cómo deben trabajar.
El 25 de agosto, Lütke escribió en X que estaba pensando en prohibir Claude Code en Shopify hasta que Anthropic permita que la herramienta lea de manera nativa archivos como AGENTS.md y .agents/skills. Actualmente Claude Code utiliza principalmente CLAUDE.md, su propio archivo para almacenar instrucciones persistentes dentro de un pr
I’m thinking about banning Claude code at Shopify until they change their mind and read AGENTS.md and .agents/skills etc.
— tobi lutke (@tobi) August 25, 2026
Insisting on only reading CLAUDE.md sometimes leads to split brain problems when different team members use different tools. Just unnecessary.
oyecto.
El riesgo de que distintos agentes trabajen con reglas diferentes
Archivos como AGENTS.md funcionan como un manual operativo para los agentes de IA. Ahí pueden almacenarse convenciones de programación, instrucciones de compilación, reglas de seguridad, requisitos de pruebas, arquitectura del proyecto o restricciones sobre qué partes del código pueden modificarse.
Cuando un agente entra a trabajar en un repositorio, lee esas instrucciones antes de comenzar. Pero si diferentes herramientas reconocen distintos archivos, dos desarrolladores que trabajan sobre la misma base de código pueden terminar utilizando agentes que reciben contextos diferentes.
Lütke describió el problema como una situación de split brain, o cerebro dividido: una parte del equipo opera bajo determinadas reglas mientras otra utiliza un agente que no recibió exactamente las mismas instrucciones. La situación es especialmente complicada en Shopify, donde miles de desarrolladores trabajan dentro de grandes monorepositorios que contienen múltiples proyectos y niveles de directorios. Según Lütke, los archivos de instrucciones se aplican de manera jerárquica a través de la estructura del repositorio.
Shopify ya construyó automatización para resolver el problema
La compañía no está técnicamente bloqueada por la incompatibilidad. Shopify utiliza automatizaciones para mantener sincronizados los distintos archivos y evitar que algunos agentes trabajen sin las instrucciones correspondientes. También existen soluciones relativamente simples para Claude Code, como hacer que CLAUDE.md importe el contenido de AGENTS.md o utilizar enlaces simbólicos entre ambos archivos. Sin embargo, para Lütke, obligar a las empresas a construir y mantener esa capa adicional de compatibilidad representa un costo de complejidad que los desarrolladores no deberían tener que pagar.
AGENTS.md intenta convertirse en un estándar neutral
La disputa refleja una batalla más amplia sobre los estándares que utilizarán los agentes de programación. AGENTS.md nació en 2025 como una solución desarrollada inicialmente para Codex de OpenAI, con el objetivo de proporcionar a los agentes una ubicación predecible donde encontrar instrucciones específicas de un proyecto.
OpenAI abrió posteriormente el formato y en diciembre de 2025 lo aportó a la Agentic AI Foundation, creada bajo la Linux Foundation. Según OpenAI y la Linux Foundation, el formato ya había sido adoptado entonces por decenas de miles de proyectos de código abierto y herramientas de programación asistida por IA.
Anthropic responde que prepara cambios
Anthropic es una de las compañías que cofundaron la Agentic AI Foundation junto con OpenAI, Block y otras empresas tecnológicas. Dentro de esa fundación conviven proyectos como AGENTS.md, el Model Context Protocol de Anthropic y Goose de Block. Eso hace especialmente llamativo que Claude Code continúe utilizando su propia convención CLAUDE.md como mecanismo nativo de instrucciones, aunque existen mecanismos para importar archivos AGENTS.md.
Después del mensaje de Lütke, integrantes del equipo de Anthropic señalaron públicamente que la compañía trabaja para hacer Claude Code más configurable y permitir con mayor facilidad el uso de AGENTS.md y modificaciones del system prompt. Anthropic sostiene que las distintas familias de modelos no son completamente intercambiables y que la forma en que reciben instrucciones puede afectar significativamente su rendimiento. Desde esa perspectiva, mantener estructuras específicas para Claude permite optimizar el comportamiento de sus modelos.
«Hola Tobi, ¡gracias por los comentarios! Estamos trabajando en hacer que Claude Code sea más personalizable, lo que incluirá poder usar fácilmente Agents.MD o realizar otras modificaciones al prompt del sistema. Compartiré más aquí cuando esté listo para implementarse.
Nuestra razonamiento para esto fue que no creemos que las familias de modelos sean intercambiables y el prompt del sistema puede tener un gran impacto en el rendimiento.
Escribí aquí: https://x.com/trq212/status/2080710971228918066 sobre cómo los modelos de Claude prefieren que se formateen sus habilidades, prompt del sistema, Claude.MD, etc. En Claude Code tenemos diferentes prompts del sistema por modelo.
Dicho esto, sé que esto requiere mucho mantenimiento y no vale la pena para todos. Comentarios recibidos y te mantendré al tanto. A corto plazo, siempre puedes mencionar a @Agents.MD desde tu Claude.MD», respondió Thariq Shihipar, ingeniero de Anthropic.
De la competencia entre modelos a la competencia entre estándares
La discusión revela un problema que probablemente aparecerá con mayor frecuencia conforme los agentes de IA se integren a los entornos de desarrollo corporativos. Mientras un desarrollador utiliza una sola herramienta, mantener un archivo específico para ella resulta relativamente sencillo.
Pero las grandes organizaciones ya empiezan a utilizar simultáneamente Codex, Claude Code, Cursor, Copilot y otros agentes. En ese escenario, la interoperabilidad deja de ser una cuestión de comodidad.
El conflicto entre Shopify y Anthropic, por tanto, no es simplemente una discusión sobre un archivo llamado AGENTS.md. Es una señal temprana de una disputa mucho más importante: si los agentes de IA que trabajarán dentro de las empresas operarán sobre estándares comunes o si cada proveedor intentará construir su propio ecosistema de instrucciones, habilidades y herramientas.
