AGENTS.md es un archivo Markdown simple que se coloca en un repo para dar a los agentes de código pasos de compilación, pruebas y convenciones. No tiene campos obligatorios. Los agentes leen el archivo más cercano en el árbol de directorios, por lo que los archivos anidados sirven a subproyectos de un monorepo. El sitio indica que lo gestiona la Agentic AI Foundation, dentro de la Linux Foundation.
Qué hace
Dónde se ejecuta AGENTS.md y qué añade, según su documentación
Da a los agentes un lugar predecible para instrucciones de configuración, pruebas y estilo de código
Mantiene el detalle orientado a agentes fuera del README para humanos
Admite archivos AGENTS.md anidados; gana el más cercano al archivo editado
Funciona con muchos agentes con un solo archivo en lugar de formatos por herramienta
Cuándo usarla
Buen encaje
Usas más de un agente de código en el mismo repo
Un monorepo necesita instrucciones de agente por paquete
Quieres que los agentes ejecuten tus comandos de pruebas indicados antes de terminar
No apto para
Políticas aplicadas por máquina: es texto de orientación, y los prompts explícitos del usuario en el chat lo sustituyen
Cómo instalar AGENTS.md
Necesitas: Un agente que lea AGENTS.md
Crea un archivo AGENTS.md en la raíz del repo
Añade secciones como descripción del proyecto, comandos de compilación y pruebas, estilo de código, pruebas e instrucciones de PR
En monorepos, añade otro AGENTS.md dentro de cada paquete
Para migrar: mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md
Gemini CLI: establece context.fileName como AGENTS.md en .gemini/settings.json; Aider: añade read: AGENTS.md a .aider.conf.yml
Ejemplo de configuración (de la documentación oficial)
{
"context": {
"fileName": "AGENTS.md"
}
}
Limitaciones
Sin campos obligatorios ni esquema; el comportamiento depende de cada agente
Los conflictos se resuelven con el archivo más cercano; los prompts del chat prevalecen sobre todo
No indicado por los responsables: La URL del repo y la licencia no se obtuvieron de la página; repo_url es el repo de la organización del proyecto en GitHub, sin verificar; No se leyeron las reglas de descubrimiento de AGENTS.md específicas de Codex; Repositorio de código público (no se verificó si es de código cerrado).