Por qué Shopify podría prohibir Claude Code por AGENTS.md

La amenaza de Shopify de vetar Claude Code no es, en el fondo, una discusión sobre qué nombre debe tener un archivo Markdown. Es una disputa sobre estándares, interoperabilidad y costes operativos en equipos que utilizan varios agentes de programación sobre el mismo código.

El CEO de Shopify, Tobi Lütke, afirmó el 25 de agosto de 2026 que estaba considerando prohibir Claude Code en la empresa hasta que Anthropic aceptara leer AGENTS.md y .agents/skills. Su argumento es que la insistencia de Claude Code en utilizar su propia convención, CLAUDE.md, puede provocar un «cerebro dividido» cuando distintos ingenieros emplean herramientas diferentes. 415

Qué es AGENTS.md y por qué importa

AGENTS.md es un archivo de texto en formato Markdown que acompaña al repositorio y contiene instrucciones específicas del proyecto: cómo compilar y probar el código, qué convenciones seguir, qué directorios no modificar y cuáles son las reglas de contribución. Al vivir junto al código y estar bajo control de versiones, esas indicaciones pueden viajar con el repositorio en lugar de quedar ligadas a una herramienta concreta. 2931

El formato surgió en el entorno del ecosistema Codex de OpenAI, dentro de una colaboración más amplia con empresas como Google, Sourcegraph, Factory y Cursor. El 9 de diciembre de 2025, OpenAI y Anthropic donaron AGENTS.md a la Agentic AI Foundation, una iniciativa respaldada por la Linux Foundation para impulsar una gestión neutral de infraestructura abierta e interoperable para agentes. 192829

No se trata de un estándar técnico obligatorio. Sin embargo, la Linux Foundation afirma que AGENTS.md ya había sido adoptado por más de 60.000 proyectos de código abierto y marcos de agentes, incluidos Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules y VS Code. 31

Esa adopción lo convierte en una capa práctica de portabilidad: una organización puede mantener una fuente común de instrucciones y hacer que varias herramientas la consulten.

El conflicto con Claude Code

La documentación de Claude Code sitúa el contexto del proyecto en archivos como CLAUDE.md, .claude/rules, las skills del proyecto, hooks y determinados ajustes. El sistema puede descubrir esos archivos en el directorio actual y en sus directorios superiores, creando su propia cadena recursiva de instrucciones. 2

Para un desarrollador que trabaja solo, mantener una convención adicional puede ser una molestia menor. En un monorepo grande, donde distintos equipos usan Claude Code junto con Codex, Cursor, Gemini CLI o GitHub Copilot, el impacto es mucho mayor.

Si una herramienta lee AGENTS.md y Claude Code busca únicamente CLAUDE.md, el mismo directorio puede presentar a cada agente comandos de prueba, convenciones de programación o límites de modificación diferentes. Un agente puede saber que una carpeta está fuera de alcance mientras otro no recibe esa indicación.

El resultado no es simplemente documentación duplicada. Puede traducirse en cambios inconsistentes, revisiones más difíciles y expectativas distintas entre los equipos: el «cerebro dividido» al que se refirió Lütke. 47

El impuesto de mantener dos sistemas

Las alternativas para una empresa que usa varios agentes son poco atractivas:

• mantener AGENTS.md y CLAUDE.md en la raíz del repositorio;
• repetir ambos archivos en los subdirectorios pertinentes;
• sincronizar las instrucciones cada vez que cambia el código; y
• crear comprobaciones automáticas para detectar divergencias.

Un cambio que se actualiza en un archivo pero no en el otro puede hacer que un agente utilice un comando de pruebas obsoleto o ignore una nueva restricción de seguridad. En una base de código extensa, esa carga acumulada se convierte en un «impuesto de configuración»: más archivos, más automatización y más puntos potenciales de fallo.

Una petición pública en el repositorio de Claude Code describió precisamente esta fricción. Según el issue, cuando un desarrollador clona un proyecto que ya contiene AGENTS.md, Claude Code puede ignorar ese contexto y obligarlo a crear un CLAUDE.md con instrucciones duplicadas. 12

Qué soluciones ofrece Anthropic

La solución documentada consiste en conectar el formato compartido con la configuración propia de Claude Code. Una opción es importar AGENTS.md desde CLAUDE.md; otra posibilidad mencionada en la discusión es utilizar un enlace simbólico u otro puente de configuración. 69

Estas alternativas pueden resolver el problema inmediato, pero no equivalen a una compatibilidad nativa. Añaden una capa de configuración específica para cada repositorio y dejan en manos de la empresa decisiones sobre el orden de las instrucciones, su prioridad, el alcance por directorios y la forma de mantenerlas actualizadas.

Los enlaces simbólicos también pueden comportarse de forma distinta según el sistema operativo, la configuración de Git, el editor, los contenedores o las políticas de seguridad corporativas. En otras palabras, el trabajo de integración no desaparece: cambia de lugar y pasa a recaer en el equipo de ingeniería.

Thariq, de Anthropic, respondió públicamente que la compañía está trabajando para hacer Claude Code más configurable, incluida la posibilidad de facilitar el uso de AGENTS.md o la modificación de otros ajustes del prompt del sistema. 15 El material disponible no establece una razón técnica o comercial definitiva por la que Claude Code no haya añadido reconocimiento nativo, por lo que cualquier explicación sobre la motivación de Anthropic debe considerarse especulativa.

La aparente contradicción de los estándares abiertos

El enfrentamiento resulta llamativo porque Anthropic participa en el ecosistema de la Agentic AI Foundation, donde AGENTS.md está bajo una gobernanza asociada a la Linux Foundation, mientras que las convenciones documentadas de Claude Code siguen centradas en archivos propios de Anthropic. 22829

Eso no demuestra que Anthropic se oponga a los estándares abiertos. Un proveedor puede respaldar una base común y, al mismo tiempo, conservar extensiones propietarias para funciones específicas de sus modelos o productos. Pero para un comprador empresarial la diferencia es menos importante si las instrucciones esenciales del proyecto deben reescribirse o conectarse manualmente antes de que otra herramienta pueda utilizarlas.

Qué puede cambiar en el mercado de herramientas de IA

Más presión contra el bloqueo de proveedor

Las instrucciones de un repositorio pueden contener prácticas del equipo, límites de seguridad, flujos de trabajo y conocimiento operativo. Si todo funciona mejor en el formato de un proveedor, cambiar de herramienta o utilizar varias a la vez resulta más caro. Un formato común reduce ese coste de salida y da a los responsables de ingeniería más margen en sus decisiones de compra.

Un modelo de dos capas

El desenlace más práctico quizá no sea que un único formato sustituya a todas las convenciones propietarias. Un archivo común como AGENTS.md podría contener las instrucciones portátiles del proyecto, mientras que CLAUDE.md y otros archivos específicos aportarían extensiones opcionales.

Así, los proveedores conservarían espacio para diferenciar sus productos sin convertir el contexto básico del repositorio en información que deba adaptarse para cada agente.

Los grandes clientes como árbitros de interoperabilidad

La reacción de Lütke muestra cómo una petición aparentemente pequeña puede convertirse en un requisito de despliegue. Si empresas grandes como Shopify empiezan a exigir compatibilidad entre herramientas para aprobar su uso interno, los proveedores tendrán que tratar la interoperabilidad como parte de la preparación empresarial, no como una mejora secundaria para la comunidad.

En resumen

Shopify no amenaza con vetar Claude Code porque CLAUDE.md sea necesariamente peor que AGENTS.md. La queja es que una convención propia se vuelve costosa cuando miles de ingenieros utilizan varios agentes sobre la misma base de código.

La adopción de AGENTS.md por más de 60.000 proyectos, su gobernanza bajo la Agentic AI Foundation y su presencia en herramientas importantes lo convierten en una capa compartida creíble. 2931 Las importaciones y los enlaces simbólicos permiten trabajar alrededor de la incompatibilidad, pero trasladan la carga a cada organización.

La pregunta de fondo es más amplia que Shopify y Anthropic: ¿se convertirán los agentes de programación en infraestructura interoperable, o en plataformas cerradas cuyo conocimiento de cada proyecto debe adaptarse herramienta por herramienta?