Reglas

Controla cómo se comporta el modelo Agent con instrucciones reutilizables y con ámbito definido.

Las reglas proporcionan instrucciones a nivel de sistema para Agent e Inline Edit. Piénsalas como contexto persistente, preferencias o flujos de trabajo para tus proyectos.

Cursor admite cuatro tipos de reglas:

Project Rules

Se almacenan en .cursor/rules, están bajo control de versiones y se aplican al ámbito de tu codebase.

User Rules

Globales para tu entorno de Cursor. Se definen en la configuración y se aplican siempre.

AGENTS.md

Instrucciones para Agent en formato Markdown. Alternativa simple a .cursor/rules.

.cursorrules (Legacy)

Sigue siendo compatible, pero está en desuso. Usa Project Rules en su lugar.

Cómo funcionan las reglas

Los modelos de lenguaje grandes no mantienen memoria entre resultados. Las reglas proporcionan contexto persistente y reutilizable a nivel de prompt.

Cuando se aplican, el contenido de las reglas se incluye al inicio del contexto del modelo. Esto le da a la IA una guía consistente para generar código, interpretar ediciones o ayudar con flujos de trabajo.

Las reglas se aplican a Chat y Inline Edit. Las reglas activas se muestran en la barra lateral del Agent.

Reglas del proyecto

Las reglas del proyecto se encuentran en .cursor/rules. Cada regla es un archivo y está bajo control de versiones. Pueden delimitarse usando 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 arquitectura

Anatomía de una regla

Cada archivo de regla está escrito en MDC (.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.

Tipo de regla	Descripción
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 incluida cuando se menciona explícitamente usando @ruleName

---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Usa nuestro patrón interno de RPC al definir servicios
- Usa siempre snake_case para los nombres de los servicios.

@service-template.ts

Reglas anidadas

Organiza las reglas colocándolas en directorios .cursor/rules a lo largo de tu proyecto. Las reglas anidadas se aplican automáticamente cuando se hace referencia a archivos en su directorio.

project/
  .cursor/rules/        # Reglas para todo el proyecto
  backend/
    server/
      .cursor/rules/    # Reglas específicas del backend
  frontend/
    .cursor/rules/      # Reglas específicas del frontend

Crear una regla

Crea reglas usando el comando New Cursor Rule o desde Cursor Settings > Rules. Esto crea un nuevo archivo de regla en .cursor/rules. Desde Configuración puedes ver todas las reglas y su estado.

Generación de reglas

Genera reglas directamente en las conversaciones usando el comando /Generate Cursor Rules. Útil cuando ya decidiste el comportamiento del agente y quieres reutilizarlo.

Mejores prácticas

Las buenas reglas son específicas, accionables y bien acotadas.

• 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

Esta regla define estándares para componentes de frontend:

Al trabajar en el directorio components:

• Usa siempre Tailwind para los estilos
• Usa Framer Motion para animaciones
• Sigue las convenciones de nombres de los componentes

Esta regla aplica validación para endpoints de API:

En el directorio api:

• 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

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

@express-service-template.ts

Esta regla define la estructura de los componentes de React:

Los componentes de React deben seguir este esquema:

• Interfaz de props al inicio
• Componente como export nombrado
• Estilos al final

@component-template.tsx

Automatización de flujos de trabajo y generación de documentación

Esta regla automatiza el análisis de la app:

Cuando te pidan analizar la app:

1. Ejecuta el servidor de desarrollo con npm run dev
2. Obtén los logs desde la consola
3. Sugiere mejoras de rendimiento

Esta regla ayuda a generar documentación:

Ayuda a redactar documentación:

• Extrayendo comentarios del código
• Analizando README.md
• Generando documentación en Markdown

Agregar una nueva configuración en Cursor

Primero crea una propiedad para alternar en @reactiveStorageTypes.ts.

Agrega el valor predeterminado 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 agregar como <SettingsSubSection> para checkboxes generales. Mira el resto del archivo para ejemplos.

<SettingsSubSection
				label="Your feature name"
				description="Your feature description"
				value={
					vsContext.reactiveStorageService.applicationUserPersistentStorage
						.myNewProperty ?? false
				}
				onChange={(newVal) => {
					vsContext.reactiveStorageService.setApplicationUserPersistentStorage(
						'myNewProperty',
						newVal
					);
				}}
			/>

Para usarlo en la app, importa reactiveStorageService y utiliza la propiedad:

const flagIsEnabled = vsContext.reactiveStorageService.applicationUserPersistentStorage.myNewProperty

Hay muchos ejemplos disponibles de proveedores y frameworks. Las reglas aportadas por la comunidad se encuentran en colecciones y repositorios colaborativos en línea.

AGENTS.md

AGENTS.md es un archivo Markdown sencillo para definir instrucciones de agentes. Ponlo en la raíz de tu proyecto como alternativa a .cursor/rules para casos de uso simples.

A diferencia de las Reglas del Proyecto, AGENTS.md es un archivo Markdown plano, sin metadatos ni configuraciones complejas. Es perfecto para proyectos que necesitan instrucciones simples y legibles sin la carga de reglas estructuradas.

# Project Instructions

## Code Style
- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture
- Follow the repository pattern
- Keep business logic in service layers

Reglas de usuario

Las reglas de usuario son preferencias globales definidas en Cursor Settings → Rules que se aplican a todos los proyectos. Son texto plano y perfectas para establecer el estilo de comunicación preferido o las convenciones de código:

Responde con un estilo conciso. Evita repeticiones innecesarias o lenguaje de relleno.

.cursorrules (Legacy)

El archivo .cursorrules en la raíz de tu proyecto sigue siendo compatible, pero se desaprobará. Te recomendamos migrar a Project Rules para tener más control, flexibilidad y visibilidad.

Preguntas frecuentes

¿Por qué no se aplica mi regla?

Revisa el tipo de regla. Para Agent Requested, asegúrate de tener una descripción definida. Para Auto Attached, asegúrate de que el patrón de archivo coincida con los archivos referenciados.

¿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?

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?

No. Las reglas solo se aplican a Agent e Inline Edit.