Guías
Archivos de reglas e instrucciones en todos los agentes de programación con IA: .cursor/rules, CLAUDE.md, AGENTS.md, GEMINI.md, instrucciones de Copilot y más (2026)
¿Qué archivo de reglas o instrucciones lee cada agente de programación con IA, y funciona AGENTS.md en todos?
Cursor lee archivos .mdc en .cursor/rules además de AGENTS.md. Claude Code lee CLAUDE.md y recurre a AGENTS.md cuando no hay CLAUDE.md. Codex, Amp, Kiro y Junie leen AGENTS.md de forma nativa. Gemini CLI lee GEMINI.md y se puede apuntar a AGENTS.md con context.fileName. GitHub Copilot lee .github/copilot-instructions.md, .github/instructions/*.instructions.md y AGENTS.md. Cline lee .clinerules/ y también detecta .cursorrules, .windsurfrules y AGENTS.md. Un solo AGENTS.md en la raíz del repo cubre la mayoría de los agentes.
Esta página es una traducción de la guía en inglés. Los comandos, claves de configuración y el código no se modifican; si hay diferencias, prevalece la versión en inglés. Leer en inglés → · Otros idiomas: 简体中文 · 日本語 · 한국어 · Português (Brasil)
Entérate cuando cambie la configuración
Cuando cambie un ajuste, flag o regla de permisos de estas herramientas, te avisamos en un correo semanal (en inglés), verificado con la documentación oficial.
Respuesta rápida: el archivo que lee cada agente
- Cursor: las reglas de proyecto son archivos .mdc en .cursor/rules (un archivo .md normal ahí se ignora). Las User Rules están en Customize y luego Rules. Las Team Rules vienen del dashboard en los planes Team y Enterprise. AGENTS.md funciona en la raíz y en subcarpetas.
- Claude Code: ./CLAUDE.md o ./.claude/CLAUDE.md para el equipo, ~/.claude/CLAUDE.md para ti, ./CLAUDE.local.md para notas privadas del proyecto. Ejecuta /init para generar uno.
- OpenAI Codex: AGENTS.md en ~/.codex para tus hábitos globales, y luego un AGENTS.md (o AGENTS.override.md) por directorio desde la raíz del repo hasta donde trabajas.
- Gemini CLI: ~/.gemini/GEMINI.md a nivel global y GEMINI.md en tu proyecto. /memory show muestra lo que está cargado.
- GitHub Copilot: .github/copilot-instructions.md para todo el repo, .github/instructions/NAME.instructions.md con un glob applyTo para algunos archivos, y AGENTS.md en cualquier parte del repo.
- Cline: archivos markdown en .clinerules/ o .cline/rules/ del proyecto, y ~/Documents/Cline/Rules para reglas globales.
- Kiro: archivos steering en markdown en .kiro/steering/ (workspace) o ~/.kiro/steering/ (global), además de AGENTS.md.
- Junie: .junie/AGENTS.md, luego un AGENTS.md en la raíz y después el antiguo .junie/guidelines.md. Las guidelines globales van en ~/.junie/AGENTS.md.
- Amp: AGENTS.md en el directorio de trabajo y sus carpetas superiores, además de ~/.config/amp/AGENTS.md.
- goose: AGENTS.md y .goosehints, globalmente en ~/.config/goose/.goosehints o por proyecto.
- Zed: ~/.config/zed/AGENTS.md para ti, y luego el primer archivo del proyecto que encuentre de una lista que empieza por .rules, .cursorrules y .windsurfrules e incluye AGENTS.md y CLAUDE.md.
- Aider: no tiene un archivo especial. Escribe CONVENTIONS.md y cárgalo con aider --read CONVENTIONS.md o con read: en .aider.conf.yml.
¿Funciona AGENTS.md en todos?
Casi. Estos agentes leen AGENTS.md sin configuración extra: Cursor, Codex, GitHub Copilot, Cline, Kiro, Junie, Amp, goose y Zed. Claude Code lee AGENTS.md solo cuando el repo no tiene CLAUDE.md. Si mantienes ambos, añade @AGENTS.md dentro de CLAUDE.md para que Claude Code lo importe. Gemini CLI necesita context.fileName en settings.json.
CLAUDE.md que reutiliza AGENTS.md
@AGENTS.md ## Claude Code only - Use plan mode for changes that touch more than three files.
Gemini CLI: .gemini/settings.json
{
"context": {
"fileName": ["AGENTS.md", "GEMINI.md"]
}
}¿Y .cursorrules?
La documentación actual de reglas de Cursor describe los archivos .mdc de .cursor/rules, User Rules, Team Rules y AGENTS.md. No documenta un archivo .cursorrules en la raíz. Otras herramientas siguen leyendo ese nombre de archivo: Cline detecta .cursorrules automáticamente y Zed comprueba .cursorrules en segundo lugar en su lista de archivos de instrucciones del proyecto. En proyectos nuevos, pon las instrucciones compartidas en AGENTS.md y el alcance específico de Cursor en .cursor/rules.
Limitar una regla a algunos archivos
- Cursor: globs en el frontmatter del .mdc, con alwaysApply: false.
- Claude Code: un campo paths en un archivo markdown dentro de .claude/rules/.
- GitHub Copilot: applyTo en el frontmatter de un archivo .instructions.md.
- Cline: una lista paths en el frontmatter YAML.
- Kiro: inclusion: fileMatch con un fileMatchPattern.
- Amp: globs en el front matter de un archivo que mencionas con @ desde AGENTS.md.
- Codex: pon un AGENTS.md o AGENTS.override.md en la subcarpeta que necesita reglas distintas.
.cursor/rules/components.mdc
--- globs: src/components/**/*.tsx alwaysApply: false --- - Use named exports, not default exports
.github/instructions/python.instructions.md
--- applyTo: "**/*.py" --- Use type hints on every public function.
Guía completa de reglas para cada agente
- Configuración de reglas de Cursor: frontmatter .mdc, Team Rules y AGENTS.md
- CLAUDE.md de Claude Code: ubicaciones, imports y AGENTS.md
- AGENTS.md de Codex: archivos globales, de proyecto y override
- GEMINI.md de Gemini CLI: ubicaciones, imports y /memory
- Instrucciones personalizadas de GitHub Copilot
- Cline Rules: reglas de workspace, globales y condicionales
- Archivos steering de Kiro y modos de inclusión
- Guidelines de Junie y AGENTS.md
- AGENTS.md de Amp y guías con alcance por glob
- .goosehints de goose y AGENTS.md
- Archivos de instrucciones, MCP y permisos de herramientas en Zed
- CONVENTIONS.md y .aider.conf.yml de Aider
- Plantillas de reglas de Cursor para copiar y pegar
- Referencia y generador de AGENTS.md
Fuentes
Documentación oficial (en inglés) con la que se verificó esta guía. Versión en inglés revisada el: 2026-10-18
Más guías en español
- Permitir todos los comandos en cualquier agente de programación con IA: Cursor, Claude Code, Codex, Gemini CLI, Copilot CLI y 7 más (2026)
- Ubicación de los archivos de configuración en todos los agentes de programación con IA: Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Qwen Code, Amp y Factory Droid (2026)
- Añadir un MCP server a cualquier agente de programación con IA: Claude Code, Cursor, Codex, Gemini CLI, VS Code y 8 más (2026)
- Hooks en todos los agentes de programación con IA: Claude Code, Cursor, Gemini CLI, GitHub Copilot, Kiro y Factory Droid (2026)
- Agent Skills (SKILL.md) en todos los agentes de programación con IA: Claude Code, Codex, Cline, Amp y OpenHands (2026)
- Permisos de Claude Code: reglas allow, ask y deny, sintaxis de reglas y herramientas permitidas
- Cómo permitir que Claude Code ejecute todos los comandos: modos de permisos, reglas allow y omitir permisos
- Cómo permitir que Cursor ejecute todos los comandos: Run Everything, allowlist y sandbox
- Configuración de reglas en Cursor: reglas de proyecto, de usuario y Team Rules, frontmatter .mdc, globs y AGENTS.md
- Agregar servidores MCP a Claude Code (claude mcp add, .mcp.json, scopes)
- Subagentes y agentes personalizados comparados: Claude Code vs Codex vs Cursor vs Gemini CLI vs GitHub Copilot (2026)