AGENTS.md resuelve un problema muy concreto: los agentes de código con IA necesitan contexto operativo — cómo instalar dependencias, iniciar el servidor de desarrollo, ejecutar pruebas y respetar las convenciones del proyecto —, pero meter todo eso en el README lo vuelve incómodo para los colaboradores humanos. AGENTS.md separa esa guía en su propio archivo, escrito en Markdown puro y sin esquema obligatorio, para que los agentes lo encuentren de forma fiable y el README siga siendo breve y legible.
Como es solo Markdown, no hay nada que instalar ni herramientas propietarias que adoptar. Añades un AGENTS.md en la raíz del repositorio, incluyes las secciones relevantes y los agentes compatibles lo leen automáticamente. En monorepos grandes puedes colocar archivos AGENTS.md adicionales dentro de los subpaquetes; los agentes leen el archivo más cercano del árbol de directorios, así que el más próximo prevalece y cada paquete puede ofrecer instrucciones a medida.
El formato surgió de la colaboración en el ecosistema de desarrollo con IA —incluidos OpenAI Codex, Amp, Jules de Google, Cursor y Factory— y ahora lo administra la Agentic AI Foundation bajo la Linux Foundation. Lo usan más de 60.000 proyectos de código abierto y lo admiten numerosos agentes como Codex, Jules, Aider, goose, opencode, Zed, Warp, VS Code, Devin, Amp, Cursor, RooCode, Gemini CLI, Kilo Code y GitHub Copilot.