Archivos de instrucciones para agentes
Antes de empezar a trabajar, cada agente de programación carga un archivo del proyecto con instrucciones permanentes. Aquí se indica dónde busca cada herramienta, qué metadatos front matter entiende y cómo se combinan las copias globales, del proyecto y anidadas. Información contrastada con la documentación de los proveedores el 2026-10-01.
Qué archivo lee cada herramienta
| Herramienta | Lee | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | Nativo |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | Nativo |
| Cursor | .cursor/rules/*.mdcAGENTS.md | Nativo |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | Nativo |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | Mediante configuración |
| Devin Desktop (antes Windsurf) | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | Nativo |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | Nativo |
| Aider | .aider.conf.yml | Mediante configuración |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | Nativo |
Usa un único AGENTS.md como fuente de verdad y haz que las demás herramientas lo consulten. Siete de las nueve herramientas anteriores lo leen directamente; Gemini CLI y Aider necesitan una línea de configuración, y un CLAUDE.md que solo contenga @AGENTS.md mantiene al día las versiones anteriores de Claude Code. Usa el formato de reglas propio de cada herramienta solo para las reglas específicas de rutas que AGENTS.md no pueda expresar.
Todos los archivos de instrucciones
AGENTS.mdAGENTS.md
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.
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md es el archivo de memoria que Claude Code carga al iniciarse desde el directorio de inicio, el proyecto y cada directorio superior. Las reglas con ámbito de ruta de .claude/rules/ añaden indicaciones que solo se cargan al leer archivos que coinciden.
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md es el archivo de contexto que Gemini CLI envía con cada prompt. También puede leer AGENTS.md o cualquier otro nombre que configures en context.fileName.
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
Las reglas de proyecto de Cursor son archivos .mdc en .cursor/rules/ cuyo frontmatter determina cuándo se aplica cada regla. Cursor también lee AGENTS.md, además de las reglas de usuario y las reglas de equipo configuradas fuera del repositorio.
.github/copilot-instructions.mdGitHub Copilot custom instructions
GitHub Copilot lee un archivo para todo el repositorio, .github/copilot-instructions.md, además de archivos .instructions.md específicos para determinadas rutas. También tiene en cuenta AGENTS.md o un único archivo CLAUDE.md o GEMINI.md en la raíz.
.devin/rules/*.mdDevin Desktop (Windsurf) rules
Devin Desktop, el nuevo nombre de Windsurf desde 2026-06-02, lee archivos de reglas de .devin/rules/ y sigue admitiendo .windsurf/rules/ y el archivo heredado .windsurfrules. El activador de cada regla determina si está siempre activa, se aplica según un patrón glob, la selecciona el modelo o se invoca manualmente.
.clinerules/Cline Rules (.clinerules/)
Cline Rules son archivos Markdown en .clinerules/ que Cline combina con las reglas globales y con AGENTS.md. El frontmatter opcional paths limita una regla a los archivos coincidentes.
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
OpenClaw construye el contexto de cada agente a partir de archivos Markdown de inicialización en su espacio de trabajo, encabezados por un AGENTS.md obligatorio. Los archivos se insertan en el prompt del sistema en el primer turno de cada sesión nueva.