Reglas e instrucciones Oficial

AGENTS.md

Formato Markdown abierto con instrucciones de proyecto para agentes de código como Codex y Cursor.

Autor
AGENTS.md (Agentic AI Foundation, Linux Foundation)
Funciona con
Cursor, Gemini CLI, OpenAI Codex, Windsurf
Documentado
Oct 2, 2026

Qué es AGENTS.md

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

Cómo se integra AGENTS.md: qué agentes lo ejecutan y qué añadeSE EJECUTA ENTu agenteOpenAI CodexCursorGemini CLIWindsurf4 hosts documentadosRULES · OFICIALAGENTS.mdInstrucciones del proyecto que el…5 pasos de instalaciónsin permisos adicionales indicadosLO QUE AÑADEQué haceDa a los agentes un lugar predeci…Mantiene el detalle orientado a a…Admite archivos AGENTS.md anidado…Funciona con muchos agentes con u…agente → extensión → nueva capacidad · desde el repositorio o la documentación oficial
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

  1. Crea un archivo AGENTS.md en la raíz del repo
  2. Añade secciones como descripción del proyecto, comandos de compilación y pruebas, estilo de código, pruebas e instrucciones de PR
  3. En monorepos, añade otro AGENTS.md dentro de cada paquete
  4. Para migrar: mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md
  5. 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

Herramientas que extiende

OpenAI Codex

Web · Desktop · Mobile

Aún no hay reseñas de usuarios

Agente de programación de OpenAI para la CLI, extensión de IDE, app de escritorio, web e iOS, incluido en los planes de ChatGPT o facturado por API.

El plan gratis termina en: Desktop app only listed, Usage limits apply

Listed Aún sin reseñar

Verificado developers.openai.com (abre el sitio web de OpenAI Codex en una pestaña nueva)

Gratis · de pago desde $8/mo EE. UU. · revisado Sep 29

Aún no hay reseñas de usuarios

IDE de programación con IA, antes Windsurf y ahora Devin Desktop: gestiona agentes de programación locales y en la nube dentro de un IDE completo.

El plan gratis termina en: Light quota for agent usage, resets daily and weekly, Limited model availability

Listed Aún sin reseñar

Verificado windsurf.com (abre el sitio web de Devin Desktop (formerly Windsurf) en una pestaña nueva)

Preguntas frecuentes

¿Hay campos obligatorios en AGENTS.md?

No. Es Markdown estándar; usa los encabezados que quieras. fuente

¿Qué pasa cuando hay conflicto entre archivos AGENTS.md?

Gana el AGENTS.md más cercano al archivo editado, y los prompts explícitos del usuario en el chat prevalecen sobre todo. fuente

¿Cómo hago que Gemini CLI lea AGENTS.md?

Establece context.fileName como AGENTS.md en .gemini/settings.json. fuente

¿Qué agentes admiten AGENTS.md?

El sitio lista Codex, Jules, Factory, Aider, goose, opencode, Zed, Warp, VS Code, Devin, Junie, Amp, Cursor, RooCode, Gemini CLI, Kilo Code, Copilot coding agent, Windsurf y otros. fuente

Guías relacionadas

Fuentes y lagunas

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).

Más extensiones para ver