Descripción
AGENTS.md es un formato simple y abierto para guiar a los agentes de codificación, utilizado por más de 60k proyectos de código abierto. Piénsalo como un README para agentes. Los archivos README.md tradicionales están diseñados para colaboradores humanos, ofreciendo inicios rápidos, descripciones del proyecto y pautas de contribución. AGENTS.md complementa esto al proporcionar el contexto adicional, a veces detallado, que los agentes de codificación requieren, como pasos de construcción, pruebas y convenciones que pueden desordenar un README o no son relevantes para los colaboradores humanos.
La separación de AGENTS.md de README.md cumple múltiples propósitos. Proporciona a los agentes un lugar claro y predecible para las instrucciones, mantiene los README concisos y enfocados en los colaboradores humanos, y ofrece una guía precisa y centrada en los agentes que complementa el README y la documentación existentes. En lugar de introducir otro archivo propietario, AGENTS.md adopta un nombre y un formato que puede ser utilizado por cualquiera. Si estás construyendo o utilizando agentes de codificación y encuentras útil este formato, se te anima a adoptarlo.
Un archivo AGENTS.md es compatible con muchos agentes, lo que lo convierte en una herramienta versátil para los desarrolladores. Las definiciones de agentes que creas pueden funcionar sin problemas con un ecosistema en crecimiento de agentes y herramientas de codificación de IA, incluyendo openai/codex, apache/airflow, temporalio/sdk-java y PlutoLang/Pluto. Para utilizar AGENTS.md de manera efectiva, debes agregar el archivo a tu proyecto y cubrir lo que importa incluyendo secciones que ayuden a un agente a trabajar de manera efectiva. Las opciones populares para estas secciones incluyen visión general del proyecto, comandos de construcción y prueba, pautas de estilo de código, instrucciones de prueba y consideraciones de seguridad.
AGENTS.md surgió de esfuerzos colaborativos en el ecosistema de desarrollo de software de IA, incluyendo contribuciones de OpenAI Codex, Amp, Jules de Google, Cursor y Factory. El formato ahora es administrado por la Fundación Agentic AI bajo la Fundación Linux, con el compromiso de mantenerlo y evolucionarlo como un formato abierto que beneficie a toda la comunidad de desarrolladores, independientemente del agente de codificación en uso.
Características principales de AGENTS.md
Formato Abierto
Compatible con múltiples agentes
Contexto detallado para agentes de codificación
Soporta archivos AGENTS.md anidados
Guía para instrucciones específicas del proyecto
Desarrollo impulsado por la comunidad
Administrado por la Fundación Agentic AI
Facilita la colaboración entre proyectos
¿Cómo usar AGENTS.md?
Agregar AGENTS.md: Incluye el archivo AGENTS.md en tu proyecto.
Cubrir lo que importa: Agrega secciones que ayuden a un agente a trabajar de manera efectiva con tu proyecto.
Agregar instrucciones adicionales: Proporciona orientación adicional según sea necesario.
Usar archivos anidados: Para grandes monorepos, implementa archivos AGENTS.md anidados para subproyectos.
Casos de uso de AGENTS.md
- Documentación del Proyecto
- Colaboración en Código Abierto
- Configuración de Agentes
- Instrucciones de Prueba
- Pasos de Construcción
