AGENTS.md
Guía abierta para agentesInstrucciones claras para agentes IA
Aspectos destacados
Qué puedes hacer con ella
- Guiar a un agente de IA en un proyecto de código abierto
- Dar instrucciones por subproyecto en un monorepo grande
- Estandarizar la entrada de agentes de terceros
Cómo usarla
- 1 Crea un AGENTS.md en la raíz del repositorio
- 2 Añade visión general, comandos de build y test, estilo y reglas de commits
- 3 Incluye notas extra: seguridad, despliegue o datasets grandes
- 4 En monorepos, un AGENTS.md por paquete; el agente lee el más cercano
Para quién es
Ventajas
- Gratuito y de formato abierto
- Funciona con la mayoría de agentes de codificación
- Reduce malentendidos sobre build, tests y estilo
Limitaciones
- Hay que redactar y mantener el archivo a mano
- No ejecuta nada: depende de que el agente lo respete
- Un archivo desactualizado puede confundir al agente
Qué es AGENTS.md
AGENTS.md es un formato abierto, simple y gratuito para dar instrucciones a los agentes de codificación de IA. La idea es colocar un archivo AGENTS.md en la raíz del repositorio y describir ahí cómo instalar dependencias, cómo ejecutar las pruebas, qué estilo de código seguir y qué reglas respetar en commits y pull requests. El proyecto nació de la colaboración de varias empresas del ecosistema, entre ellas OpenAI y Google, y hoy está alojado por la Agentic AI Foundation bajo la Linux Foundation. Más de 60.000 proyectos de código abierto ya lo usan, así que se ha convertido en una referencia del sector sin coste alguno.
Qué puedes hacer con él
- Documentar el entorno: listar comandos como pnpm install o los filtros de test para que el agente sepa montar y verificar el proyecto.
- Fijar el estilo de código: por ejemplo, TypeScript estricto, comillas simples y preferencia por programación funcional.
- Establecer reglas de commits y PRs, incluyendo qué comprobar con pnpm lint y pnpm test antes de enviar cambios.
- Organizar monorepos grandes con archivos anidados en cada paquete, que el agente lee según la carpeta que toca.
Para quién es
- Desarrolladores que trabajan con agentes de IA y quieren resultados más previsibles.
- Mantenedores de código abierto, que separan la documentación humana del README de las guías para agentes.
- Equipos que crean agentes de codificación y buscan un formato de entrada común.
- Empresas con varios repositorios que quieren uniformar cómo los agentes tratan cada proyecto.
Qué tener en cuenta
AGENTS.md no es una herramienta que se instala: es un archivo de texto que tú redactas y mantienes. Si no lo actualizas cuando cambia el proyecto, el agente seguirá instrucciones antiguas y fallará de formas confusas. Su eficacia depende de que el agente lo lea y lo respete, y cada herramienta implementa su propia lectura del formato. Tampoco sustituye a la documentación para personas ni a las pruebas automáticas: es una capa de contexto que reduce fricción. Aun así, como es gratuito y solo requiere un archivo de texto, el coste de probarlo es mínimo y la mejora suele notarse rápido.
Preguntas frecuentes
¿AGENTS.md es gratis?
Sí, es un formato abierto y gratuito, alojado por la Agentic AI Foundation bajo la Linux Foundation.
¿Funciona con cualquier agente?
Es compatible con muchos agentes, como Augment, Factory o Kilo, aunque cada herramienta decide cómo leerlo.
¿Sustituye al README?
No, lo complementa: el README queda para las personas y AGENTS.md recoge las instrucciones para los agentes.
Por qué es gratis
Lo que dice la página oficial： Gratis
Los límites gratuitos, la duración de la prueba y las funciones los decide el sitio oficial y pueden cambiar en cualquier momento.
Captura de pantalla
Captura archivada desde la página del listado, solo como referencia.
