Generado artificialmenteAGENTS.md: el archivo que el agente lee antes del código
README se queda para las personas. Al lado hay desde agosto de 2025 un segundo archivo, y desde el 9 de diciembre de 2025 pertenece a la Agentic AI Foundation.
AGENTS.md es un archivo Markdown corriente en la raíz de un repositorio. Ahí se indica cómo se construye, se prueba y se toca este proyecto. OpenAI la publicó en agosto de 2025 con Codex. El 9 de diciembre de 2025 estaba según OpenAI y la Linux Foundation en más de 60.000 proyectos open source, y OpenAI la ha entregado a la Agentic AI Foundation dado.
Sin campos obligatorios. El siguiente agente lee el texto que tú dejas.
Una README explica a las personas el arranque, el propósito, cómo colaborar. AGENTS.md es el complemento para el caso de que el siguiente colaborador no sea una persona: build, tests, convenciones, que atiborrarían una README. La página agents.md dice que eligieron el nombre y el formato a propósito de forma que cualquier herramienta pueda tomarla. No hay campos obligatorios. Los encabezados son libres. El agente parsea el texto.
Lo que meten los equipos, la página lo repite como la lista habitual: resumen, build y tests, estilo, seguridad, además reglas de commit, trampas, datos grandes, deploy. Todo lo que le dirías a una nueva colega el primer día. Si listas comandos de test, el agente intenta ejecutarlos y corregir errores antes de dar la tarea por terminada. Un cambio posterior del archivo está previsto. Documentación viva, no un contrato con número de versión.
Codex necesitaba un lugar fijo. Las otras herramientas tenían el mismo hueco.
OpenAI describe el comienzo el 9 de diciembre de 2025 como un hueco práctico en Codex. El agente necesitaba un sitio previsible para lo específico del proyecto: convenciones, build, tests, para trabajar en una codebase ajena sin adivinar de nuevo cada vez. El archivo debía quedar junto a README.md. Lo que empezó como solución interna se quedó en el ecosistema.
La página agents.md nombra la ronda de la que salió el formato: OpenAI Codex, Amp, Jules de Google, Cursor y Factory. La Linux Foundation data la publicación en agosto de 2025 y lista como adoptantes Amp, Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules y VS Code. La misma lista está en OpenAI, con la cifra: más de 60.000 proyectos open source desde la publicación hasta el 9 de diciembre de 2025.
Nick Cooper entrega un archivo, no un protocolo.
Nick Cooper, Member of the Technical Staff en OpenAI, figura en el comunicado de prensa de la Linux Foundation por la entrega. Su frase: hacen falta protocolos comunes impulsados por la comunidad para un ecosistema de agentes sano, por eso OpenAI ha abierto Codex CLI, el Agents SDK y ahora AGENTS.md. El archivo es la tercera contribución fundacional de la Agentic AI Foundation, junto a MCP de Anthropic y goose de Block. No es un protocolo. MCP es un cable a herramientas. A2A es un cable entre agentes. AGENTS.md es una regla de lectura para un repositorio.
El fondo las mantiene para que ninguna empresa individual conserve la dirección mientras crece la adopción. La página agents.md dice la misma frase en presente: Steward es la Agentic AI Foundation bajo la Linux Foundation. El mantenimiento y el desarrollo posterior quedan prometidos como formato abierto, independientemente de qué agente de coding uses.
El archivo más cercano vence al de más arriba. Tu frase en el chat vence a ambos.
En un repo grande no hay un solo archivo, sino uno por paquete. El agente lee el AGENTS.md más cercano en el camino desde el archivo que toca hasta la raíz. El más cercano gana. Una frase explícita tuya en el chat gana contra ambos. La página nombra como ejemplo el entonces repositorio principal de OpenAI: 88 de esos archivos, en el momento del texto. Un AGENT.md antiguo se lleva por renombrado y symlink, para que las herramientas anteriores no corran en vacío.
Fig. 01 · Tres niveles, una regla. Amarillo es el archivo que cuenta para un cambio en src. Una frase en el chat está por encima y aquí no está dibujada.
En McGrinsey hay un archivo así en la raíz de la carpeta del proyecto. El mismo tipo de texto: lo que el siguiente agente debe saber antes de empezar. La diferencia con la fundación no es de forma. La diferencia es quién mantiene la dirección cuando miles de repos usan la misma convención. Para eso está el fondo, no para el contenido de tu archivo.
Archivo, fecha, cifra.
| Afirmación | Cesta | Fuente |
|---|---|---|
| AGENTS.md es Markdown sin campos obligatorios. README sigue siendo para humanos. El archivo más cercano gana, el chat gana contra el archivo. | Hecho | agents.md, FAQ y explicación. |
| Surgido de Codex, Amp, Jules, Cursor y Factory. Publicación agosto 2025. | Hecho | agents.md (la ronda). Linux Foundation y OpenAI (el mes). |
| Más de 60.000 proyectos de código abierto hasta el 9 de diciembre de 2025. Herramientas: Amp, Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules, VS Code. | Hecho, estado de la entrega | OpenAI y Linux Foundation, 9 de diciembre de 2025. |
| OpenAI entrega el archivo a la AAIF. Nick Cooper firma la cita. | Hecho | Comunicado de prensa de la Linux Foundation, 9 de diciembre de 2025. |
| 88 archivos AGENTS.md en el repositorio principal de OpenAI. | Hecho, en el momento de la página | agents.md, en el momento de su texto. |
| Steward es la Agentic AI Foundation bajo la Linux Foundation. | Hecho | agents.md, sección About. |
- agents.mdForma, FAQ, las cinco herramientas mencionadas en el origen, 88 archivos, el Steward.https://agents.md/
- OpenAI, la cofundación9 de diciembre de 2025. Codex como motivo, agosto de 2025-60.000 proyectos.https://openai.com/index/agentic-ai-foundation/
- Linux Foundation9 de diciembre de 2025. Nick Cooper, la misma cifra, la misma lista de herramientas.https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation
- Las piezas vecinasA2A como lenguaje entre agentes. MCP y el techo de la Foundation.https://mcgrinsey.com/magazin/a2a-protocol/
Corte: 30 de septiembre de 2026.
