El máximo responsable de Shopify, Tobi Lütke, ha advertido que podría prohibir el uso de Claude Code, el asistente de codificación de Anthropic, dentro de su empresa. La razón no reside en la calidad de la herramienta, sino en discrepancias sobre cómo se interpretan los archivos de instrucciones para agentes de inteligencia artificial en los repositorios de código.
Según Lütke, la falta de soporte para ciertos archivos clave genera una complejidad innecesaria y pone en riesgo la coherencia del trabajo de los miles de desarrolladores que colaboran en el enorme monorepositorio de la compañía.
El conflicto: archivos de instrucciones que no coinciden
El núcleo del problema está en la forma en que distintas herramientas de IA procesan los archivos de configuración y directrices dentro de los repositorios.
En la red social X, Lütke señaló que está evaluando vetar a Claude Code hasta que Anthropic modifique su producto para que pueda leer archivos como AGENTS.md y .agents/skills, esenciales para mantener la coherencia en los procesos de desarrollo en Shopify.
La plataforma de comercio electrónico, con miles de desarrolladores en su plantilla, enfrenta el reto de garantizar que todos los agentes de IA involucrados interpreten las mismas reglas e instrucciones para cada parte del código.
Lütke explicó que cuando los agentes no leen los mismos archivos de instrucciones, existe el peligro de que distintos equipos trabajen bajo criterios diferentes, lo que puede ocasionar problemas de comunicación y calidad en el desarrollo del software.
El CEO detalló que los archivos de configuración se aplican de forma recursiva en el árbol del repositorio. Si falta uno de esos archivos en ciertos directorios, un grupo de desarrolladores queda expuesto a una configuración deficiente.
Esta situación podría generar lo que Lütke denominó una “lobotomía” en el funcionamiento de los agentes, al trabajar con información incompleta o desactualizada respecto al resto del equipo.
El directivo recalcó que la postura de Anthropic de que Claude Code solo lea el archivo CLAUDE.md, en lugar de adoptar el estándar AGENTS.md, provoca fricciones innecesarias entre los equipos. La variedad de herramientas de IA dentro de Shopify multiplica estos inconvenientes, ya que no existe una convención unificada para las instrucciones persistentes en los repositorios.
Automatización como parche y costos adicionales
Para reducir estas diferencias, Shopify ha implementado soluciones automatizadas que sincronizan las instrucciones y evitan errores derivados de la falta de compatibilidad entre archivos. Sin embargo, Lütke considera que esta adaptación supone un costo extra 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 logrado resolver el problema mediante scripts y sistemas automáticos que replican o enlazan los archivos necesarios en las distintas carpetas del proyecto. No obstante, el CEO insiste en que este proceso añade complejidad al flujo de trabajo de los ingenieros y representa un esfuerzo adicional que podría evitarse si herramientas como Claude Code leyeran de forma nativa los archivos AGENTS.md.
Lütke subrayó que la solución automatizada es solo un paliativo ante la falta de interoperabilidad entre los diferentes asistentes de codificación. El directivo opina que los ingenieros de su compañía no deberían destinar recursos a corregir deficiencias de integración que podrían resolverse desde el desarrollo original de las herramientas de IA.
Origen de los archivos AGENTS.md y CLAUDE.md
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, los equipos de ingeniería necesitan establecer reglas, comandos de compilación, requisitos de prueba y convenciones de codificación de manera centralizada y accesible para cualquier asistente de IA que interactúe con el repositorio.
OpenAI introdujo el archivo AGENTS.md en agosto de 2025 como respuesta a esta necesidad, con el objetivo de ofrecer una forma estandarizada para que los agentes de codificación reciban instrucciones específicas según el proyecto.
Pocos meses después, OpenAI informó que más de 60.000 proyectos de código abierto y marcos de agentes ya empleaban AGENTS.md, con soporte confirmado 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, una entidad vinculada a la Linux Foundation.
En contraste, Claude Code de Anthropic utiliza su propio archivo, CLAUDE.md, para almacenar las instrucciones pertinentes. Este archivo puede ubicarse en diferentes posiciones dentro de un repositorio y la herramienta lo consulta durante la ejecución.
No obstante, por defecto, Claude Code no reconoce ni procesa archivos AGENTS.md, lo que ha motivado que numerosos desarrolladores pidan a Anthropic que implemente esta funcionalidad.
Anthropic ha propuesto alternativas, como importar el contenido de AGENTS.md desde un archivo CLAUDE.md o usar enlaces simbólicos para conectar ambos. Pero en repositorios de gran tamaño y alta complejidad, como el de Shopify, estas soluciones requieren una gestión activa para mantener la sincronización de las instrucciones en todos los directorios relevantes.
Fuente: Infobae