Cursor Project Rules (.cursor/rules/*.mdc): dónde se encuentra y cómo lo leen las herramientas

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.

Dónde se encuentra

• .cursor/rules/**/*.mdc; se permiten subcarpetas. Se ignoran los archivos .md normales de .cursor/rules.
• AGENTS.md en la raíz y en carpetas anidadas.
• Reglas de usuario, configuradas en los ajustes de Cursor.
• Reglas de equipo, configuradas en el panel del equipo.

Formato

Markdown con YAML frontmatter; la extensión .mdc es obligatoria. alwaysApply: true incluye siempre la regla; los globs con alwaysApply: false la aplican cuando hay un archivo coincidente en el contexto; si solo hay una descripción, el Agent decide. Si no se especifica ninguno de estos campos, la regla solo se aplica cuando la mencionas con @.

Claves del frontmatter: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

Precedencia y combinación

Reglas de equipo, luego reglas de proyecto y, por último, reglas de usuario. Se combinan todas las reglas aplicables y, en caso de conflicto, prevalece la fuente anterior; las reglas de equipo obligatorias no se pueden desactivar. Los archivos AGENTS.md anidados se combinan con los de sus directorios superiores y prevalece el archivo más específico.

Herramientas que lo leen

Consejos

• Separa varios patrones glob con comas en el campo globs.
• Mantén cada regla por debajo de 500 líneas y referencia los archivos con @filename en lugar de pegar su contenido.
• Las reglas no afectan a Cursor Tab y User Rules no se aplican a Inline Edit.
• El archivo heredado .cursorrules ya no aparece en la documentación de Cursor; muévelo a .cursor/rules/.

Otros archivos de instrucciones