Tobi Lütke, CEO de Shopify, ha expresado la posibilidad de prohibir el uso del asistente de codificación Claude Code de Anthropic dentro de su empresa. Esta advertencia no se relaciona con la calidad de la herramienta, sino con la divergencia en la interpretación de los archivos de instrucciones para agentes de inteligencia artificial en los repositorios de código.
El desafío de la compatibilidad en los repositorios de código
Lütke argumenta que la ausencia de compatibilidad con archivos clave incrementa la complejidad operativa y podría comprometer la coherencia del trabajo de los miles de desarrolladores que colaboran en el extenso monorepositorio de Shopify. El punto central de este conflicto reside en cómo las distintas herramientas de inteligencia artificial procesan los archivos de configuración y directrices dentro de los repositorios de código.
En la red social X, Lütke indicó que considera vetar a Claude Code hasta que Anthropic adapte la herramienta para que pueda leer archivos como AGENTS.md y .agents/skills. Estos archivos son fundamentales para mantener la uniformidad en los procesos de desarrollo de Shopify.
La plataforma de comercio electrónico, con una plantilla de miles de desarrolladores, se enfrenta al reto de asegurar que todos los agentes de IA involucrados interpreten las mismas reglas e instrucciones para cada segmento del código. Según Lütke, si los agentes no leen los mismos archivos de instrucciones, existe el riesgo de que los equipos operen bajo criterios dispares, lo que podría generar problemas de comunicación y afectar la calidad del software desarrollado.
El CEO explicó que los archivos de configuración se aplican de forma recursiva en el árbol del repositorio. Si uno de estos archivos falta en directorios específicos, una porción de los desarrolladores queda expuesta a una configuración deficiente. Esta situación podría llevar a lo que Lütke describe como una “lobotomía” en el funcionamiento de los agentes, al operar con información incompleta o desactualizada en comparación con el resto del equipo.
Lütke remarcó que la insistencia de Anthropic en que Claude Code lea únicamente el archivo CLAUDE.md, en lugar de adoptar el estándar AGENTS.md, genera fricciones innecesarias entre los equipos. La diversidad de herramientas de IA en Shopify amplifica este tipo de inconvenientes, ya que no existe una convención unificada para las instrucciones persistentes en los repositorios.
Costos adicionales y la necesidad de estandarización
Para mitigar estas diferencias, Shopify ha implementado soluciones de automatización que permiten sincronizar instrucciones y evitar errores derivados de la incompatibilidad entre archivos. No obstante, Lütke considera que esta adaptación implica un costo adicional que la empresa no debería asumir si existiera una mayor voluntad de estandarización por parte de los proveedores de herramientas de IA.
La compañía ha resuelto el problema mediante scripts y sistemas automáticos que replican o enlazan los archivos necesarios en las distintas carpetas del proyecto. Sin embargo, el CEO insiste en que este proceso añade complejidad al flujo de trabajo de los ingenieros y representa un esfuerzo extra que podría evitarse si herramientas como Claude Code adoptaran la lectura nativa de los archivos AGENTS.md.
Lütke enfatizó que la solución automatizada es un paliativo ante una deficiencia de interoperabilidad entre los asistentes de codificación. El directivo sostiene que los ingenieros de su compañía no deberían dedicar recursos a corregir problemas de integración que podrían solucionarse desde el desarrollo original de las herramientas de IA.
Evolución de los estándares de instrucciones para IA
La aparición de archivos de instrucciones como AGENTS.md y CLAUDE.md responde a la necesidad de que los agentes de IA reciban indicaciones claras y persistentes sobre cómo operar en cada base de código. A medida que los agentes se vuelven más complejos y autónomos, es crucial que los equipos de ingeniería puedan establecer reglas, comandos de compilación, requisitos de prueba y convenciones de codificación de forma centralizada y accesible para cualquier asistente de IA que interactúe con el repositorio.
OpenAI introdujo el archivo AGENTS.md en agosto de 2025 para ofrecer una forma estandarizada de que los agentes de codificación recibieran instrucciones específicas según el proyecto. Meses después, OpenAI reportó que más de 60.000 proyectos de código abierto y marcos de agentes ya utilizaban AGENTS.md, con soporte en herramientas como Codex, Cursor, Gemini CLI, GitHub Copilot, Jules y Visual Studio Code. Posteriormente, el formato pasó a ser gestionado por la Agentic AI Foundation, entidad vinculada a la Linux Foundation.
En contraste, Claude Code de Anthropic emplea su propio archivo, CLAUDE.md, para almacenar las instrucciones relevantes. Este archivo puede ubicarse en distintas partes de un repositorio y es consultado por la herramienta durante su ejecución. Sin embargo, por defecto, Claude Code no reconoce ni procesa archivos AGENTS.md, lo que ha generado la petición de diversos desarrolladores para que Anthropic implemente esta funcionalidad.
