Cursor rules: archivos .mdc, modos de aplicación y AGENTS.md en 2026

Cómo funciona

• Escribe /create-rule en el chat del Agent y describe la regla, o abre Customize > Rules > Add Rule.
• La regla se guarda en .cursor/rules/<name>.mdc; define description, globs y alwaysApply en el frontmatter.
• Existen cuatro modos de aplicación: Always, Intelligently (según la descripción), Specific Files (según globs) y Manual (con @-mention).
• Haz commit de la carpeta .cursor/rules para que todo el equipo comparta las mismas reglas.
• Para una configuración más simple, coloca un AGENTS.md en la raíz del repositorio; los AGENTS.md anidados sirven a los paquetes de un monorepo y prevalece el más cercano.

Cómo se ve un archivo de reglas

Una regla .mdc tiene frontmatter (description, globs, alwaysApply) e instrucciones en texto simple. AGENTS.md no tiene frontmatter y lo leen varios agentes, no solo Cursor.

Archivo: .cursor/rules/<name>.mdc (project) · AGENTS.md (repo root)

---
description: Cómo escribimos componentes de React en este repositorio
globs: ["src/**/*.tsx"]
alwaysApply: false
---

- Usa componentes de función y hooks; no uses componentes de clase.
- Coloca las pruebas junto al componente como <Component>.test.tsx.
- Nunca importes desde `../../..`; usa el alias `@/`.

---
globs: src/components/**/*.tsx
alwaysApply: false
---
- Use named exports, not default exports

{
  "context": {
    "fileName": "AGENTS.md"
  }
}

La lista (2)

Preguntas frecuentes