Source: https://arara.code.app.br/es/articulos/agents-md-reglas-para-agentes-de-ia
Language: es
Published: 2026-11-16T08:00:00-03:00

Guías y comparativas

# AGENTS.md: cómo guiar agentes de IA en el código

AGENTS.md es un estándar abierto en Markdown ubicado en la raíz del repositorio para dar instrucciones previsibles a los agentes de código. Funciona como un README para IA, unificando comandos de build, pruebas, estilo y límites en un solo archivo.

Arara Code

Publicado y con fuentes consultadas el 16 de noviembre de 2026.

Publicado por el proyecto Arara Code con base en la documentación oficial citada.

## Por qué nació el estándar AGENTS.md

Antes de AGENTS.md cada asistente exigía su propio archivo de configuración —como .cursorrules, CLAUDE.md o ajustes propios— generando duplicación y desincronización en equipos con varias herramientas.

Con el estándar abierto en agents.md, un único archivo describe cómo funciona el proyecto y es leído de forma nativa por OpenAI Codex, Claude Code, Gemini, GitHub Copilot y Cursor.

[AGENTS.md: especificación oficial del estándar abierto](https://agents.md/)

## Qué incluir dentro de AGENTS.md

Al no exigir un esquema rígido, usa secciones simples en Markdown: comandos de instalación y desarrollo, scripts obligatorios de typecheck y pruebas, convenciones de arquitectura y restricciones claras sobre lo que no debe tocarse.

En monorepos grandes también puedes añadir archivos AGENTS.md anidados en subcarpetas para dar reglas específicas por paquete sin saturar el contexto.

[GitHub: repositorio oficial agentsmd/agents.md](https://github.com/agentsmd/agents.md)

Relacionado

[MCP (Model Context Protocol): qué es y cómo usarloEntiende qué es MCP (Model Context Protocol), cómo funcionan servidores, herramientas y transportes, qué cuidar en seguridad y cómo usarlo en Arara Code.](https://arara.code.app.br/es/articulos/que-es-mcp)

## Menos alucinaciones y menor consumo de tokens

Indicar desde el inicio qué comandos validan la compilación y dónde están los módulos clave evita bucles de exploración costosos intentando adivinar scripts.

Esto reduce fallos de ejecución, mantiene la coherencia entre pull requests y hace más predecibles las entregas asistidas.

[AGENTS.md: especificación oficial del estándar abierto](https://agents.md/)

## AGENTS.md en Arara Code

Arara Code respeta el archivo AGENTS.md de tu workspace y aplica tus reglas de proyecto de forma uniforme tanto si usas Claude Code como Codex, Kiro o Antigravity.

Así todo el equipo conserva el mismo estándar de calidad aunque cada desarrollador elija su agente favorito dentro de la IDE.

[Arara Code: repositorio público del editor](https://github.com/arara-ide/arara-code)

## Fuentes y lecturas adicionales

- [AGENTS.md: especificación oficial del estándar abierto](https://agents.md/)
- [GitHub: repositorio oficial agentsmd/agents.md](https://github.com/agentsmd/agents.md)
- [Arara Code: repositorio público del editor](https://github.com/arara-ide/arara-code)

[Leer en Markdown](https://arara.code.app.br/es/articulos/agents-md-reglas-para-agentes-de-ia.md)

## Sigue explorando

### [Ingeniería de contexto en IA: cómo estructurar](https://arara.code.app.br/es/articulos/ingenieria-de-contexto-en-ia)

Aprende qué es la ingeniería de contexto en desarrollo con IA, por qué fallan las ventanas enormes y cómo organizar archivos con precisión.

[Leer la guía](https://arara.code.app.br/es/articulos/ingenieria-de-contexto-en-ia)

### [Desarrollo orientado a especificaciones (SDD)](https://arara.code.app.br/es/articulos/desarrollo-orientado-a-especificaciones)

Descubre cómo el desarrollo orientado a especificaciones sustituye prompts improvisados por contratos claros antes de generar código.

[Leer la guía](https://arara.code.app.br/es/articulos/desarrollo-orientado-a-especificaciones)

## Haz espacio para tu próxima idea.

Conoce Arara Code en tu propio proyecto. Empieza con el instalador y revisa los cambios que haga tu asistente.

Descargar Arara Code
