Shopify amenaza con vetar a Claude Code por no leer un estándar

El tuit que encendió el debate

El 25 de agosto de 2026, Tobi Lütke, CEO de Shopify, publicó en X que estaba «pensando en prohibir Claude Code dentro de Shopify» hasta que Anthropic decidiera leer los archivos AGENTS.md y la carpeta .agents/skills en lugar de insistir solo en su propio formato CLAUDE.md. Lo que empezó como un mensaje en redes se convirtió en uno de los debates técnicos más comentados del momento sobre desarrollo de software con IA.

El problema, según Lütke, no es que Claude Code funcione mal. Es un problema operativo: Shopify mantiene un monorepo con miles de desarrolladores que usan asistentes distintos —Cursor, GitHub Copilot, Claude Code, entre otros— y cada carpeta del repositorio contiene instrucciones específicas sobre cómo programar ahí (comandos de compilación, reglas de estilo, pruebas previas al commit). Esas instrucciones viven en archivos de texto que los agentes leen automáticamente.

Como AGENTS.md y CLAUDE.md se aplican de forma recursiva por todo el árbol de carpetas, basta con que una sola carpeta carezca de uno de los dos archivos para que algunos desarrolladores terminen trabajando con agentes «a medias». Shopify ya construyó automatizaciones para parchar la situación, pero Lütke lo describe como pagar un «impuesto de complejidad» innecesario, solo porque una herramienta se niega a leer un formato que ya adoptó medio ecosistema.

🤖 La IA no es solo para leer sobre ella

En la comunidad la aplicamos: automatización, agentes IA y herramientas reales para emprender, no solo para informarte.

👥 Aplicarla en la comunidad

AGENTS.md vs CLAUDE.md: el origen de la pelea

Para dimensionar el conflicto conviene remontarse un año. En agosto de 2025, OpenAI presentó AGENTS.md como un manual de instrucciones estándar para que cualquier agente de codificación supiera cómo comportarse dentro de un proyecto. La propuesta prendió rápido: según Marketing4eCommerce, para diciembre de ese año 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.

Pocos meses después, el formato pasó a manos de la Agentic AI Foundation (AAIF), un organismo ligado a la Linux Foundation creado en diciembre de 2025 como hogar neutral para la infraestructura abierta de agentes. La AAIF nació con tres proyectos inaugurales: el Model Context Protocol (MCP) —aportado por Anthropic—, el agente de codificación goose —de Block— y el propio AGENTS.md. Sus miembros Platinum fundadores incluyen a Amazon Web Services, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft y OpenAI, según el comunicado oficial de la fundación.

Claude Code, en cambio, siguió su propio camino con CLAUDE.md, un archivo que cumple prácticamente la misma función pero que solo entiende su propio agente. Anthropic ofrece dos parches: importar el contenido de AGENTS.md dentro de un CLAUDE.md, o usar enlaces simbólicos para que ambos archivos compartan la información. Funciona en proyectos pequeños; a la escala de Shopify, mantener esa sincronización a mano (o con scripts) se vuelve un trabajo en sí mismo.

La presión acumulada durante casi un año

Lo que le dio peso a la queja de Lütke es que no era nueva. Desarrolladores llevan meses pidiendo a Anthropic que Claude Code lea AGENTS.md de forma nativa. Hay un pedido en GitHub con miles de votos a favor y otro más reciente, centrado en la lectura recursiva 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 lo planteara en público.

La respuesta llegó justo cuando el tuit se volvió viral: alguien del equipo de Claude Code (identificado en redes como Thariq) reconoció la queja, prometió que el soporte para AGENTS.md llegará y que Claude Code será más «hackeable», mientras tanto sugirió el truco de referenciar AGENTS.md desde CLAUDE.md.

No todo el mundo quedó conforme. Varios desarrolladores señalaron que el problema no era solo técnico, sino de actitud: una empresa que prefiere sostener su propio formato en lugar de sumarse a un estándar gobernado de forma neutral, trasladando el costo a los equipos de ingeniería.

Por qué este caso le importa a cualquier startup

El episodio de Shopify es solo el ejemplo más visible de algo que le pasa a cualquier equipo que combine más de un asistente de IA para programar. Si tu startup usa Cursor para edición rápida y Claude Code para tareas largas, o Copilot en pipelines de CI junto con Codex, es probable que ya arrastres el mismo problema sin haberle puesto nombre: instrucciones duplicadas, desactualizadas o directamente ignoradas por uno de los agentes.

El fondo del asunto no es el archivo en sí, sino una pregunta estratégica: qué tan portable es tu flujo de trabajo de IA dentro de 18 meses. La AAIF ya trabaja en proyectos adicionales como agentgateway, un proxy open source que se ubica entre los agentes y los modelos para gestionar autenticación, rate limiting, observabilidad y enrutamiento —en esencia, un «pass» de cocina por donde pasa todo el tráfico de agentes antes de tocar herramientas o datos. Si tu stack depende de formatos propietarios, migrar de proveedor será más caro que el ahorro inicial.

Qué significa esto para tu startup

Tres acciones concretas que puedes aplicar esta semana, sin esperar a que el sector se ponga de acuerdo:

Elige un estándar y documéntalo desde el día uno. Si decides usar AGENTS.md, deja escrito en un lugar visible del repositorio dónde vive, quién lo actualiza y cada cuánto se revisa. El formato ya cuenta con soporte de las herramientas más usadas, así que evitas atarte a un único vendor.
Automatiza la sincronización antes de que aparezca el problema. Un script que replique o enlace los archivos de instrucciones entre carpetas evita justo el escenario que describió Lütke. Si por alguna razón debes mantener un archivo propietario paralelo, que esa duplicación la gestione código, no personas.
Audita el costo de cambiar de proveedor de IA cada seis meses. Apunta cuánto te costaría migrar hoy entre Cursor, Claude Code, Codex y Copilot. Si moverte implica reescribir configuraciones, documentaciones internas y automatizaciones, tienes un lock-in silencioso que ningún contrato te está cobrando todavía.