AGENTS.md

OpenAI lanzó AGENTS.md en agosto de 2025 y, el 9 de diciembre de 2025, lo cedió a la Agentic AI Foundation, un fondo dirigido por la Linux Foundation cofundado con Anthropic y Block. Para entonces, más de 60.000 proyectos de código abierto habían adoptado el formato, junto con frameworks de agentes como Cursor, Devin, GitHub Copilot, Gemini CLI y VS Code. Lo que se está gobernando es un archivo Markdown con instrucciones específicas del proyecto: convenciones de código, pasos de compilación, requisitos de pruebas.

Jude Gao, en Vercel, midió lo que ese archivo aporta. Las API de Next.js 16 ausentes de los datos de entrenamiento del modelo producían código incorrecto en el 47% de los casos. Los skills que empaquetaban ese mismo conocimiento no llegaban a invocarse en el 56% de las ejecuciones de evaluación, dejando la tasa de éxito en el valor base del 53%, y solo alcanzaban el 79% cuando las instrucciones forzaban el disparo. Un AGENTS.md estático inyectado en el system prompt en cada turno obtuvo un 100% en build, lint y tests. Vercel comprimió después 40 KB de documentación en un índice de 8 KB delimitado por barras verticales sin perder esa puntuación, porque el contexto pasivo consume ventana en cada interacción.

Addy Osmani plantea el archivo como un problema de racionamiento. Según el principio del trinquete, cada línea debe remontarse a un fallo concreto del pasado; el límite de HumanLayer está por debajo de las 60 líneas, más una lista de verificación de piloto que una guía de estilo.

Bill Staples, de GitLab, distingue el archivo Markdown del registro gobernable. El contexto, la identidad, la política, la procedencia y la memoria organizacional deben persistir a través de modelos y agentes, lo que para él apunta hacia un plano de control más que hacia un archivo en el repositorio.