Configuración de reglas en Cursor: reglas de proyecto, de usuario y Team Rules, frontmatter .mdc, globs y AGENTS.md

• Project Rules: archivos .mdc en .cursor/rules. Están bajo control de versiones y limitados al código base. Se admiten subcarpetas.
• User Rules: preferencias globales configuradas en los ajustes de reglas de Cursor. Aplican a todos los proyectos.
• Team Rules: se administran desde el panel de Cursor en los planes Team y Enterprise.
• AGENTS.md: instrucciones en markdown simple sin metadatos.

Las reglas de proyecto deben usar la extensión .mdc. El sistema de reglas ignora un archivo .md normal en .cursor/rules.

• Always Apply: alwaysApply: true. Se incluye en cada sesión de chat.
• Apply to Specific Files: alwaysApply: false más globs. Se adjunta cuando un archivo coincidente está en el contexto.
• Apply Intelligently: alwaysApply: false más description, sin globs. Agent la incorpora cuando es relevante.
• Apply Manually: sin description ni globs. Solo se usa cuando la mencionas con @.

Separa varios patrones glob con comas. Por ejemplo, src/**/*.tsx coincide con los archivos .tsx dentro de src/.

---
globs: src/components/**/*.tsx
alwaysApply: false
---

- Use named exports, not default exports
- Keep components under 200 lines
- Prefer composition over prop drilling

---
alwaysApply: true
---

- Read the relevant source files before proposing changes
- Never modify generated files in dist/ or build/

Una referencia @file dentro de una regla le indica a Agent dónde buscar. El archivo no se inserta en línea, así que pon en el cuerpo de la regla todo lo que siempre deba estar en el contexto.

• Disponibles en los planes Team y Enterprise. Los administradores las crean y gestionan en el panel de Cursor.
• Las Team Rules son texto libre y no usan la estructura de carpetas .cursor/rules.
• Cada regla puede ser obligatoria u opcional. Los usuarios pueden desactivar una Team Rule no obligatoria en Team Rules dentro de Customize. Una regla obligatoria no se puede desactivar ahí.
• Una regla con un patrón glob aplica solo cuando hay archivos coincidentes en el contexto. Una regla sin glob aplica a todas las conversaciones.
• Deja sin marcar la casilla de activación para guardar una regla como borrador que no aplica hasta que la actives.
• Las Team Rules activadas se incluyen en el contexto de Agent (Chat) en todos los repositorios y proyectos del equipo.

Cursor señala que la guía de IA no debería ser tu único control de seguridad, ni siquiera con reglas obligatorias.

Pon AGENTS.md en la raíz del proyecto. Los archivos AGENTS.md anidados en subdirectorios aplican cuando trabajas en ese directorio. Se combinan con los archivos superiores, y el archivo más específico gana.

• La precedencia es Team Rules, luego Project Rules, luego User Rules. Todas las reglas se combinan, y las fuentes anteriores ganan en caso de conflicto.
• Las User Rules aplican solo a Agent, no a Inline Edit.
• Las reglas no afectan a Cursor Tab.
• Mantén cada regla por debajo de 500 líneas y divide las grandes en reglas más pequeñas.