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

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