---
title: "AGENTS.md: rutas y formato · DotsAgent"
description: "Dónde se encuentra AGENTS.md, su formato y su frontmatter, cómo se combinan las copias globales y anidadas, y qué herramientas lo leen. Verificado el 2026-10-01."
url: https://dotsagent.io/es/instructions/files/agents-md
---

AGENTS.md

# AGENTS.md: dónde se encuentra y cómo lo leen las herramientas

AGENTS.md es un archivo Markdown sin formato que contiene instrucciones para el proyecto y que la mayoría de los agentes de programación leen sin configuración adicional. OpenAI lo cedió a Agentic AI Foundation, bajo la Linux Foundation, y lo usan más de 60k proyectos de código abierto.

## Dónde se encuentra

- AGENTS.md en la raíz del repositorio, para todo el proyecto.
- Archivos AGENTS.md anidados en subdirectorios o paquetes; los agentes usan el más cercano en el árbol.
- OpenAI Codex: un archivo global ~/.codex/AGENTS.override.md o, si está vacío o no existe, ~/.codex/AGENTS.md.
- Cline: un archivo global ~/.agents/AGENTS.md.
- Claude Code también admite .claude/AGENTS.md.

## Formato

Markdown sin formato, sin frontmatter ni campos obligatorios; se pueden usar encabezados de cualquier tipo. El formato no establece un límite de tamaño, pero OpenAI Codex deja de leer al llegar a project_doc_max_bytes, que es de 32 KiB de forma predeterminada.

`AGENTS.md`

```
# Acme web app

Customer-facing web app with an admin area and a REST API.

## Commands

- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`

## Code style

- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.

## Never

- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
```

## Precedencia y combinación

Prevalece el archivo AGENTS.md más cercano al archivo que se está editando, y las instrucciones explícitas del chat prevalecen sobre cualquier archivo. OpenAI Codex concatena un archivo por directorio, desde la raíz del proyecto hasta el directorio de trabajo; por eso, los archivos más cercanos aparecen al final y tienen prioridad. Claude Code omite AGENTS.md de forma predeterminada cuando hay un CLAUDE.md.

## Herramientas que lo leen

| Herramienta | Compatibilidad |
| --- | --- |
| [OpenAI Codex](https://developers.openai.com/codex/guides/agents-md) | Integrado de forma nativa. Lee un archivo global y, después, como máximo un archivo por directorio desde la raíz hasta el directorio de trabajo, con un límite de 32 KiB de forma predeterminada. |
| [Claude Code](https://code.claude.com/docs/en/memory) | Integrado de forma nativa desde v2.1.277, pero solo si no existe CLAUDE.md ni CLAUDE.local.md, salvo que se configure como claude-md-and-agents-md. |
| [Cursor](https://cursor.com/docs/context/rules) | Integrado de forma nativa, en la raíz y en directorios anidados; los archivos anidados se combinan con los de los directorios superiores y prevalece el más específico. |
| [GitHub Copilot (cloud agent, code review, VS Code)](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions) | Integrado de forma nativa en cualquier parte del repositorio; prevalece el archivo más cercano. |
| [Devin Desktop (formerly Windsurf)](https://docs.windsurf.com/windsurf/cascade/memories) | Integrado de forma nativa. El archivo de la raíz siempre está activo; los archivos de subdirectorios se aplican a su propio directorio. |
| [Cline](https://docs.cline.bot/features/cline-rules) | Integrado de forma nativa, además de admitir un archivo global ~/.agents/AGENTS.md; se puede activar o desactivar en el panel Rules. |
| [Gemini CLI](https://geminicli.com/docs/cli/gemini-md/) | Opcional: añade AGENTS.md a context.fileName en .gemini/settings.json. |
| [Aider](https://agents.md/) | Opcional: añade read: AGENTS.md a .aider.conf.yml. |
| [OpenClaw](https://docs.openclaw.ai/concepts/agent) | Integrado de forma nativa como archivo obligatorio de instrucciones de funcionamiento en el espacio de trabajo del agente. |
| [Listed on agents.md (not individually re-verified)](https://github.com/agentsmd/agents.md/blob/main/components/CompatibilitySection.tsx) | Una de las 23 herramientas de la lista de agents.md, entre ellas Amp, Jules, Zed, Warp, goose, opencode y JetBrains Junie; no las verificamos una por una. |

## Consejos

- ¿Vas a cambiar el nombre de un AGENT.md antiguo? agents.md sugiere ejecutar mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md para que ambos nombres sigan funcionando.
- Indica los comandos de test y lint: los agentes intentan ejecutar las comprobaciones que encuentran y corregir los fallos antes de terminar.
- En un monorepo, añade un AGENTS.md breve por paquete en vez de alargar el archivo de la raíz.
- En OpenAI Codex, AGENTS.override.md tiene prioridad sobre AGENTS.md en el mismo directorio.

Genera un AGENTS.md y los archivos de reglas correspondientes para cinco herramientas desde un único formulario. [Abrir el generador de AGENTS.md →](https://dotsagent.io/es/instructions)

## Otros archivos de instrucciones

[CLAUDE.md](https://dotsagent.io/es/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/es/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/es/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/es/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/es/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/es/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/es/instructions/files/openclaw-workspace)

## Fuentes

1. [agents.md](https://agents.md/)/
2. [github.com](https://github.com/agentsmd/agents.md)/agentsmd/agents.md
3. [linuxfoundation.org](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation)/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foun
4. [openai.com](https://openai.com/index/agentic-ai-foundation/)/index/agentic-ai-foundation/
5. [developers.openai.com](https://developers.openai.com/codex/guides/agents-md)/codex/guides/agents-md

Referencia independiente para quienes crean agentes de IA. No estamos afiliados a ninguno de los proveedores mencionados aquí.

© 2026 DotsAgent · Datos verificados el 1 de octubre de 2026