Imagina que tienes miles de programadores trabajando sobre el mismo código gigante, y que la mitad de ellos usa una herramienta de IA que “sabe” las reglas de la casa, y la otra mitad usa otra que se las salta por completo. No porque quieran, sino porque el asistente no lee el archivo correcto. Así, más o menos, es el lío en el que se metió Anthropic con nada menos que Tobi Lütke, el CEO de Shopify.
El asunto empezó como un tuit y terminó siendo uno de los debates técnicos más comentados del gremio de developers. Y aunque suene a pelea de nicho entre programadores, en realidad dice bastante sobre hacia dónde va la estandarización del trabajo con agentes de IA.
Lütke publicó en X que estaba pensando en prohibir Claude Code dentro de Shopify hasta que Anthropic decidiera leer AGENTS.md y la carpeta .agents/skills. Ojo, no dijo que la herramienta fuera mala. Dijo, básicamente, que le estaba generando un dolor de cabeza operativo que no debería existir.
I’m thinking about banning Claude code at Shopify until they change their mind and read AGENTS.md and .agents/skills etc. Insisting on only reading CLAUDE.md sometimes leads to split brain problems when different team members use different tools. Just unnecessary. — tobi lutke (@tobi) August 25, 2026
I’m thinking about banning Claude code at Shopify until they change their mind and read AGENTS.md and .agents/skills etc.
Insisting on only reading CLAUDE.md sometimes leads to split brain problems when different team members use different tools. Just unnecessary.
— tobi lutke (@tobi) August 25, 2026
Shopify es una empresa con un monorepo (un solo repositorio gigante donde vive todo el código) que usan miles de desarrolladores, y no todos usan el mismo asistente de IA. Unos trabajan con Cursor, otros con GitHub Copilot, otros con Claude Code. El problema es que cada carpeta del repositorio puede tener instrucciones específicas sobre cómo programar ahí: qué comandos usar para compilar, qué reglas de estilo seguir, qué pruebas correr antes de subir cambios. Y esas instrucciones se guardan en archivos de texto que los agentes leen automáticamente.
En un hilo posterior, Lütke explicó que tanto AGENTS.md como CLAUDE.md se aplican de forma recursiva por todo el árbol de carpetas, y que con tantos equipos trabajando a la vez, es cuestión de tiempo que a alguna carpeta le falte uno de los dos archivos. Cuando eso pasa, según sus palabras, algunos desarrolladores terminan trabajando con agentes “a medias”, como si les faltara una parte del cerebro.
So many people telling me tricks for dealing with this- I know them all. But agents and claude files are recursively applied through the tree. With thousands of developed in a mono repo, it just does happen that one directory is missing one of the two files and this means that a… — tobi lutke (@tobi) August 25, 2026
So many people telling me tricks for dealing with this- I know them all. But agents and claude files are recursively applied through the tree. With thousands of developed in a mono repo, it just does happen that one directory is missing one of the two files and this means that a…
Shopify ya construyó automatizaciones para parchar el problema, pero para Lütke eso es justamente lo molesto, el pagar un “impuesto de complejidad” innecesario, como él mismo lo llamó, solo porque una herramienta se niega a leer un formato que ya usa medio ecosistema.
Para entender por qué esto genera tanto ruido, hay que remontarse un poco. En agosto de 2025, OpenAI presentó AGENTS.md como una especie de manual de instrucciones estándar para que cualquier agente de codificación supiera cómo comportarse dentro de un proyecto. La idea prendió rápido: para diciembre de ese año, la propia OpenAI reportaba que más de 60.000 proyectos de código abierto ya lo usaban, con soporte de herramientas como Codex, Cursor, Gemini CLI, GitHub Copilot, Jules y Visual Studio Code. Después, el formato pasó a manos de la Agentic AI Foundation, un organismo ligado a la Linux Foundation, para que su desarrollo no dependiera de una sola empresa.
Claude Code, en cambio, decidió seguir su propio camino con CLAUDE.md, un archivo que cumple prácticamente la misma función pero que solo entiende su propio agente. Anthropic sí ofrece un par de parches, se puede importar el contenido de AGENTS.md dentro de un CLAUDE.md, o usar enlaces simbólicos para que ambos archivos “compartan” la misma información. Funciona bien si tienes un proyecto pequeño. Si tienes el tamaño de Shopify, con cientos de carpetas y equipos distintos tocando cosas distintas, mantener esa sincronización a mano (o incluso con scripts) se vuelve un trabajo en sí mismo.
Y ese es justo el punto que más le molesta a Lütke, no es que la solución no exista, es que alguien tiene que estar pendiente de mantenerla funcionando todo el tiempo, para algo que herramientas rivales resuelven leyendo un solo archivo estándar.
Lo curioso y lo que le dio más peso a la queja de Lütke, es que esto no es nuevo. Desarrolladores llevan casi un año pidiéndole a Anthropic que Claude Code lea AGENTS.md de forma nativa. Hay un pedido en GitHub que acumula miles de votos a favor, y otro más reciente, centrado específicamente en la lectura recursiva de AGENTS.md por carpetas, que Anthropic cerró marcándolo como “sin planes por ahora”.
Es decir, la empresa ya había dicho que no, con calma, meses antes de que el CEO de una de sus clientes corporativas más grandes amenazara públicamente con dejar de usar su producto insignia.
Después de casi un año de silencio sobre el tema, alguien del equipo de Claude Code (identificado en redes como Thariq) salió a responder públicamente el hilo de Lütke. Reconoció la queja, prometió que Claude Code será más “hackeable” y que el soporte para AGENTS.md llegará, además de sugerir mientras tanto el truco de referenciarlo desde un CLAUDE.md.
No todo el mundo quedó conforme. Varios desarrolladores señalaron en redes que el problema no es solo técnico, sino de actitud: una empresa que prefiere sostener su propio formato en lugar de sumarse a un estándar que ya usa buena parte del ecosistema, y que termina trasladando el costo de esa decisión a los equipos de ingeniería que tienen que lidiar con la incompatibilidad todos los días.
Porque el caso de Shopify es solo el ejemplo más visible de algo que le está pasando a cualquier empresa que use más de un asistente de IA para programar. Si tu equipo combina, por ejemplo, Cursor para editar código y Claude Code para tareas más largas, o Copilot junto con Codex en tus pipelines de integración continua, es muy probable que ya estés arrastrando el mismo problema sin haberle puesto nombre todavía: instrucciones duplicadas, desactualizadas, o directamente ignoradas por uno de los agentes.
Si te suena familiar, aquí van tres cosas concretas que puedes hacer mientras el sector se pone de acuerdo (o no):
Por ahora, no. Lütke habló de que lo está “pensando”, no de una decisión tomada, y la respuesta pública de Anthropic parece haber destensado un poco la situación. Pero el episodio deja claro que cuando una herramienta de IA se usa a la escala de una compañía como Shopify, hasta el detalle más técnico, como qué archivo lee un agente, puede convertirse en un problema de negocio. Y en un mercado donde cada vez hay más agentes de codificación compitiendo por el mismo lugar en el flujo de trabajo de los desarrolladores, no sumarse a un estándar común tiene un costo que, tarde o temprano, alguien termina pagando.
Imagen: GPT Images 2.0
Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *
Δ