AGENTS.md

AGENTS.md es un formato de archivo estandarizado que actúa como un README específicamente para agentes de IA de programación. En lugar de amontonar las instrucciones del agente en un README enfocado en humanos (lo que puede volverse caótico), colocas un archivo Markdown sencillo llamado AGENTS.md en la raíz de tu proyecto. En él, describes cómo configurar el entorno de desarrollo, ejecutar pruebas, seguir el estilo de código y estructurar las pull requests. La idea es que cualquier agente de IA de programación que llegue a tu proyecto —ya sea GitHub Copilot, Cursor, Codex o Devin— pueda leer instantáneamente ese archivo y entender cómo quieres que se hagan las cosas. Más de 60 000 proyectos de código abierto ya lo utilizan.

Lo que hace que AGENTS.md destaque es que está deliberadamente separado de tu README. Los README se escriben para colaboradores humanos: explican qué hace el proyecto y cómo empezar rápidamente. AGENTS.md contiene los detalles minuciosos que solo necesitan los agentes de programación, como gestores de paquetes exactos, comandos de compilación, reglas de linting y convenciones para los títulos de las PR. Es un archivo Markdown sencillo, por lo que no hay que aprender una sintaxis nueva, y debido a que ha sido adoptado por un ecosistema creciente de herramientas (más de 20 agentes listados en el sitio), un solo archivo funciona en muchos asistentes de IA diferentes. El formato es abierto y no está vinculado a ninguna empresa en particular, por lo que los proyectos pueden adoptarlo sin riesgo de dependencia.

Este formato es más útil para equipos de desarrollo que trabajan con agentes de IA de programación. Si mantienes un proyecto de código abierto y quieres que los agentes de IA sigan tus convenciones sin alucinar comandos erróneos, AGENTS.md te ofrece un canal directo para decírselo. También es práctico para desarrolladores independientes que usan múltiples asistentes de programación: escribes tus instrucciones una vez y funcionan en todas partes. El formato es intencionadamente ligero: sin dependencias, sin configuración, solo un archivo de texto en tu repositorio.