Reglas

Las reglas proporcionan instrucciones persistentes a Agent para tu proyecto. Ayudan a Agent a seguir tu estilo de programación, patrones y flujos de trabajo sin que tengas que repetirlos en el chat.

¿Qué es una regla?

Una regla es un conjunto persistente de instrucciones que Agent sigue mientras trabaja en tu proyecto. Puedes aplicar reglas de forma global, por proyecto o a archivos específicos.

¿Cómo creo una regla del proyecto?

Las regla del proyecto se guardan en tu base de código y están bajo control de versiones. Todo el equipo se beneficia al incluirlas en git.

1. Abre la paleta de comandos:
   • Mac: Pulsa CmdCtrl + Shift + P
   • Windows/Linux: Pulsa Ctrl + Shift + P
2. Escribe "New Cursor Rule" y selecciónala.
3. Asigna un nombre a tu regla (p. ej., react-patterns).
4. Escribe tus instrucciones en markdown. Por ejemplo:
   - Usa TypeScript para todos los archivos nuevos- Prefiere componentes funcionales en React- Usa snake_case para las columnas de la base de datos

5. Elige cuándo se aplica la regla en el menú desplegable de tipo:
   • Aplicar siempre: se incluye en cada conversación
   • Aplicar de forma inteligente: el agente decide cuándo es relevante
   • Aplicar a archivos específicos: solo se aplica a archivos que coincidan con un patrón (p. ej., *.tsx)
   • Aplicar manualmente: solo se usa cuando la mencionas con @ en el chat
6. Guarda el archivo. Se guarda en .cursor/rules/ dentro de tu proyecto.

¿Cómo configuro las reglas de usuario?

Las reglas de usuario son preferencias globales que se aplican a todos tus proyectos. Se sincronizan con tu cuenta de Cursor en todos los dispositivos.

1. Abre Personalizar en la barra lateral
2. Haz clic en Reglas
3. Añade tus preferencias. Por ejemplo: "Responde de forma concisa. Evita repeticiones innecesarias."

¿Cómo uso AGENTS.md?

Crea un archivo AGENTS.md en la raíz de tu proyecto. Escribe instrucciones en markdown sin formato. Cursor lo detecta automáticamente.

# Instrucciones del proyecto- Usa TypeScript para todos los archivos nuevos- Sigue el patrón de repositorio para el acceso a datos- Mantén los componentes por debajo de las 200 líneas

Para controlar mejor cuándo se aplican las regla del proyecto, usa regla del proyecto en .cursor/rules/.

¿Cuáles son las buenas prácticas para escribir reglas?

• Mantén las reglas por debajo de 500 líneas. Divide las reglas grandes en archivos más pequeños y específicos.
• Incluye ejemplos concretos o archivos de referencia con @filename en el contenido de las reglas.
• Empieza poco a poco. Añade reglas cuando veas que Agent comete el mismo error más de una vez.
• Guarda las reglas en git para que tus compañeros de equipo también se beneficien.

¿Cómo organizo los archivos de reglas?

Guarda todas las reglas en un directorio .cursor/rules/ sin subcarpetas. Cursor detecta las reglas al escanear esta carpeta; las subcarpetas anidadas funcionan, pero una estructura plana es más sencilla y fácil de gestionar. Asigna nombres descriptivos a los archivos (p. ej., react-patterns.mdc, api-validation.mdc).

En proyectos grandes, divide las reglas en archivos específicos en lugar de usar una sola regla extensa. Cada archivo debe abordar un único aspecto, como convenciones de estilo, patrones de prueba o directrices de API.

¿Dónde se almacenan las reglas?

• Las reglas del proyecto se almacenan en .cursor/rules/, dentro de la carpeta de tu proyecto. Se controlan por versiones con git.
• Las reglas de usuario en los ajustes de Cursor se almacenan en tu cuenta de Cursor. Se aplican a todos tus proyectos y se sincronizan cuando inicias sesión en otra máquina.
• Los archivos de reglas de usuario en ~/.cursor/rules (Windows: %USERPROFILE%\.cursor\rules) permanecen en la máquina y no se sincronizan.
• Las reglas del equipo se almacenan en los servidores de Cursor y se gestionan desde el panel de control del equipo. Se sincronizan automáticamente con todos los miembros del equipo. Las reglas del equipo admiten patrones glob, por lo que puedes aplicar una regla a tipos de archivo específicos (p. ej., **/*.py).

Las reglas de usuario y las reglas del equipo no se incluyen en las exportaciones de perfiles. Al iniciar sesión en una máquina nueva, se sincronizan las reglas de usuario de tu cuenta.

¿Cómo funcionan las reglas del equipo?

Los planes Team y Enterprise pueden crear y aplicar reglas para toda la organización desde el panel de control de Cursor.

• Las reglas obligatorias son obligatorias para todos los miembros y no se pueden desactivar en sus ajustes.
• Las reglas opcionales están activadas de forma predeterminada, pero los miembros pueden desactivarlas en Personalizar > Reglas.
• Las reglas del equipo admiten patrones glob (p. ej., **/*.py) para aplicar una regla a tipos de archivo específicos.
• Cuando las reglas entran en conflicto, la prioridad es: Reglas del equipo > Reglas del proyecto > Reglas de usuario.

Las reglas del equipo son texto libre. No usan la estructura de carpetas de las reglas del proyecto y se sincronizan automáticamente con todos los miembros.

¿Cómo migro desde .cursorrules?

El archivo .cursorrules situado en la raíz de tu proyecto es heredado y quedará en desuso. Para migrar:

1. Crea una regla mediante la Paleta de comandos: busca "New Cursor Rule"
2. Copia el contenido de .cursorrules en el nuevo archivo de reglas
3. Establece el tipo de regla en Aplicar siempre (equivale al comportamiento anterior)
4. Elimina el archivo .cursorrules de la raíz de tu proyecto

¿Cómo funciona CLAUDE.md en Cursor?

Cursor lee los archivos CLAUDE.md igual que los archivos AGENTS.md. Coloca un archivo CLAUDE.md en la raíz de tu proyecto y Cursor lo detectará automáticamente.

Los archivos CLAUDE.md se aplican siempre a todas las conversaciones, independientemente de la configuración de frontmatter alwaysApply. Esto garantiza la compatibilidad con proyectos que también usan Claude Code. Si necesitas reglas condicionales, usa reglas del proyecto en .cursor/rules/.

¿Cómo funcionan las reglas con el mismo nombre en carpetas diferentes?

Cursor identifica las reglas por la ruta completa del archivo, no solo por su nombre. Dos reglas con el mismo nombre de archivo en carpetas diferentes se aplican si cumplen sus condiciones. No hay conflictos ni reemplazos según el nombre de archivo.

¿Qué ocurre si una regla no parece aplicarse?

Comprueba el tipo de regla. Para Aplicar inteligentemente, asegúrate de haber añadido una descripción para que Agent sepa cuándo debe aplicarla. Para Aplicar a archivos específicos, verifica que el patrón de archivo coincida con los archivos en los que estás trabajando.

Las reglas solo se aplican a Agent (Chat). No se aplican a Tab completion, Inline Edit ni a las revisiones de PR de Bugbot.

Contenido relacionado

• Referencia de reglas
• Skills
• Archivos ignorados