AGENTS.md - Un formato simple y abierto para guiar a los agentes de codificación.

AGENTS.md es un formato simple y abierto diseñado para guiar a los agentes de codificación, utilizado por más de 20,000 proyectos de código abierto. Sirve como un espacio dedicado para proporcionar contexto e instrucciones que ayudan a los agentes de codificación de IA a trabajar eficazmente en proyectos. Este formato complementa los archivos README.md tradicionales al centrarse en las necesidades específicas de los agentes de codificación.

1. Comandos de Configuración

   • Instalar dependencias: pnpm install
   • Iniciar el servidor de desarrollo: pnpm dev
   • Ejecutar pruebas: pnpm test

2. Directrices de Estilo de Código

   • Modo estricto de TypeScript
   • Comillas simples, sin punto y coma
   • Preferencia por patrones de programación funcional

3. Compatibilidad con Agentes

   AGENTS.md funciona sin problemas con varios agentes de codificación de IA, incluyendo:

   Nombre del Agente	Descripción
   Codex	Herramienta CLI de propósito general para agentes de codificación de IA.
   Amp	Agente de codificación de IA de Google.
   Jules	Otro agente de codificación de IA de Google.
   Cursor	Herramienta de codificación de IA para mejorar la productividad.
   Factory	Herramienta para construir y gestionar agentes de codificación.
   Roo	Asistente de codificación de IA para diversas tareas de programación.
   CodeAider	Herramienta de IA para asistencia y generación de código.
   Gemini CLI	Herramienta CLI de Google para tareas de codificación.
   Kilo Code	Agente de codificación de IA para un desarrollo optimizado.
   OpenCode	Agente de codificación de código abierto para proyectos colaborativos.
   Phoenix	Herramienta de IA para mejorar la eficiencia en la codificación.
   Zed	Asistente de codificación de IA para varios lenguajes de programación.

4. Archivos AGENTS.md Anidados

   Para grandes monorepos, se pueden utilizar archivos AGENTS.md anidados dentro de subproyectos, permitiendo instrucciones personalizadas para cada paquete.

1. Crea un archivo AGENTS.md en la raíz de tu repositorio.
2. Incluye secciones que ayuden a los agentes a trabajar de manera efectiva, como visión general del proyecto, comandos de construcción e instrucciones de prueba.
3. Agrega cualquier instrucción adicional relevante para nuevos colaboradores, como mensajes de confirmación y consideraciones de seguridad.
4. Para proyectos grandes, utiliza archivos AGENTS.md anidados para subproyectos específicos para proporcionar orientación localizada.

¿Hay campos requeridos en AGENTS.md?

No, AGENTS.md es flexible y se puede estructurar utilizando cualquier encabezado según sea necesario. El agente analizará el texto proporcionado.

¿Qué sucede si las instrucciones entran en conflicto?

El archivo AGENTS.md más cercano al archivo editado tiene prioridad, mientras que los mensajes explícitos del usuario anularán cualquier instrucción en conflicto.

¿El agente ejecutará comandos de prueba automáticamente?

Sí, si los comandos de prueba están listados en AGENTS.md, el agente intentará ejecutarlos y corregir cualquier fallo.

¿Se puede actualizar AGENTS.md más tarde?

Absolutamente, AGENTS.md debe ser tratado como documentación viva que puede ser modificada según sea necesario.

Los datos de precios aún no están disponibles; por favor visita el sitio web oficial para más información.

1. AGENTS.md proporciona efectivamente un formato estructurado para los agentes de codificación, mejorando su capacidad para entender los requisitos del proyecto y ejecutar tareas de manera eficiente.
2. La separación de los archivos README.md ayuda a mantener la claridad para los colaboradores humanos mientras ofrece orientación detallada para los agentes de IA.
3. Sin embargo, la adopción de AGENTS.md puede requerir un cambio cultural dentro de los equipos que están acostumbrados a prácticas de documentación tradicionales.
4. En general, AGENTS.md es una herramienta valiosa para los desarrolladores que buscan optimizar sus flujos de trabajo con agentes de codificación de IA, pero su éxito depende del uso y las actualizaciones consistentes.