Project Rules
Almacenadas en
.cursor/rules
, con control de versiones y aplicadas al alcance de tu base de código.User Rules
Globales para tu entorno de Cursor. Definidas en la configuración y siempre aplicadas.
AGENTS.md
Instrucciones para Agent en formato Markdown. Alternativa simple a
.cursor/rules
..cursorrules (Legacy)
Aún compatibles, pero obsoletas. Usá Project Rules en su lugar.
Cómo funcionan las reglas

Las reglas se aplican a Chat y a Inline Edit. Las reglas activas se muestran en la barra lateral del agente.
Reglas del proyecto
.cursor/rules
. Cada regla es un archivo y está bajo control de versiones. Pueden limitarse mediante patrones de ruta, invocarse manualmente o incluirse según su relevancia. Los subdirectorios pueden incluir su propio directorio .cursor/rules
con alcance limitado a esa carpeta.
Usa las reglas del proyecto para:
- Codificar conocimiento específico del dominio sobre tu base de código
- Automatizar flujos de trabajo o plantillas específicos del proyecto
- Estandarizar decisiones de estilo o de arquitectura
Anatomía de una regla
.mdc
), un formato que admite metadatos y contenido. Controla cómo se aplican las reglas desde el menú desplegable de tipo, que modifica las propiedades description
, globs
, alwaysApply
.
Rule Type | Description |
---|---|
Always | Siempre incluida en el contexto del modelo |
Auto Attached | Incluida cuando se referencian archivos que coinciden con un patrón glob |
Agent Requested | Disponible para la IA, que decide si incluirla. Debe proporcionar una descripción |
Manual | Solo se incluye cuando se menciona explícitamente usando @ruleName |
Reglas anidadas
.cursor/rules
a lo largo de tu proyecto. Las reglas anidadas se aplican automáticamente cuando se hace referencia a archivos dentro de su directorio.
Crear una regla
New Cursor Rule
o desde Cursor Settings > Rules
. Esto crea un nuevo archivo de regla en .cursor/rules
. Desde la configuración puedes ver todas las reglas y su estado.

Generar reglas
/Generate Cursor Rules
. Útil cuando ya definiste el comportamiento del agente y quieres reutilizarlo.
Mejores prácticas
- Mantén las reglas por debajo de 500 líneas
- Divide las reglas grandes en varias reglas componibles
- Proporciona ejemplos concretos o archivos de referencia
- Evita las indicaciones vagas. Escribe las reglas como documentación interna clara
- Reutiliza reglas cuando repitas prompts en el chat
Ejemplos
Estándares para componentes de frontend y validación de API
Estándares para componentes de frontend y validación de API
Esta regla define estándares para componentes de frontend:Al trabajar en el directorio de components:
- Usa siempre Tailwind para estilos
- Usa Framer Motion para animaciones
- Sigue las convenciones de nomenclatura de componentes
- Usa zod para toda la validación
- Define los tipos de retorno con esquemas de zod
- Exporta los tipos generados a partir de los esquemas
Plantillas para servicios de Express y componentes de React
Plantillas para servicios de Express y componentes de React
Esta regla proporciona una plantilla para servicios de Express:Usa esta plantilla al crear un servicio de Express:
- Sigue los principios RESTful
- Incluye middleware de manejo de errores
- Configura un logging adecuado
- Interfaz de Props al inicio
- Componente como export nombrado
- Estilos al final
Automatización de flujos de desarrollo y generación de documentación
Automatización de flujos de desarrollo y generación de documentación
Esta regla automatiza el análisis de la app:Cuando te pidan analizar la app:
- Ejecuta el servidor de desarrollo con
npm run dev
- Obtén los logs de la consola
- Sugiere mejoras de rendimiento
- Extrayendo comentarios del código
- Analizando README.md
- Generando documentación en Markdown
Añadir una nueva configuración en Cursor
Añadir una nueva configuración en Cursor
Primero crea una propiedad con toggle en Para usarlo en la app, importa reactiveStorageService y usa la propiedad:
@reactiveStorageTypes.ts
.Añade el valor por defecto en INIT_APPLICATION_USER_PERSISTENT_STORAGE
en @reactiveStorageService.tsx
.Para funciones beta, agrega el toggle en @settingsBetaTab.tsx
; de lo contrario, agrégalo en @settingsGeneralTab.tsx
. Los toggles se pueden añadir como <SettingsSubSection>
para checkboxes generales. Revisa el resto del archivo para ver ejemplos.AGENTS.md
AGENTS.md
es un archivo markdown simple para definir instrucciones de agentes. Ponlo en la raíz de tu proyecto como alternativa a .cursor/rules
para casos de uso sencillos.
A diferencia de las Reglas del proyecto, AGENTS.md
es un archivo markdown sin metadatos ni configuraciones complejas. Es perfecto para proyectos que necesitan instrucciones simples y fáciles de leer, sin la sobrecarga de reglas estructuradas.
Reglas de usuario
.cursorrules
(Legacy)
.cursorrules
en la raíz de tu proyecto sigue siendo compatible, pero se va a deprecar. Te recomendamos migrar a Project Rules para tener más control, flexibilidad y visibilidad.
Preguntas frecuentes
¿Por qué no se aplica mi regla?
¿Por qué no se aplica mi regla?
Revisa el tipo de regla. Para
Agent Requested
, asegúrate de que haya una descripción definida. Para Auto Attached
, asegúrate de que el patrón de archivos coincida con los archivos referenciados.¿Pueden las reglas referenciar otras reglas o archivos?
¿Pueden las reglas referenciar otras reglas o archivos?
Sí. Usa
@filename.ts
para incluir archivos en el contexto de tu regla.¿Puedo crear una regla desde el chat?
¿Puedo crear una regla desde el chat?
Sí, genera reglas del proyecto desde el chat usando el comando
/Generate Cursor Rules
.
Si Memories está habilitado, las memorias se generan automáticamente.¿Las reglas afectan a Cursor Tab u otras funciones de IA?
¿Las reglas afectan a Cursor Tab u otras funciones de IA?
No. Las reglas solo se aplican a Agent y a Inline Edit.