Las reglas proporcionan instrucciones a nivel de sistema para Agent e Inline Edit. Piensa en ellas como contexto persistente, preferencias o flujos de trabajo para tus proyectos. Cursor admite tres tipos de reglas:

Reglas de Proyecto

Almacenadas en .cursor/rules, controladas por versión y con alcance específico a tu base de código.

Reglas de Usuario

Globales a tu entorno de Cursor. Definidas en configuración y siempre aplicadas.

.cursorrules (Heredado)

Aún compatible, pero obsoleto. Usa Reglas de Proyecto en su lugar.

Cómo funcionan las reglas

Los modelos de lenguaje grandes no conservan memoria entre completaciones. 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 orientación consistente para generar código, interpretar ediciones o ayudar con flujos de trabajo.
Regla aplicada en contexto con chat
Las reglas se aplican a Chat y Edición en Línea. Las reglas activas se muestran en la barra lateral del Agente.

Reglas del proyecto

Las reglas del proyecto se encuentran en .cursor/rules. Cada regla es un archivo y está controlada por versiones. Pueden ser delimitadas usando patrones de ruta, invocadas manualmente, o incluidas basándose en relevancia. Los subdirectorios pueden incluir su propio directorio .cursor/rules delimitado 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íficas 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 soporta metadatos y contenido. Controla cómo se aplican las reglas desde el menú desplegable de tipo que cambia las propiedades description, globs, alwaysApply.
Tipo de ReglaDescripción
AlwaysSiempre incluida en el contexto del modelo
Auto AttachedIncluida cuando se referencian archivos que coinciden con un patrón glob
Agent RequestedDisponible para la IA, que decide si incluirla. Debe proporcionar una descripción
ManualSolo incluida cuando se menciona explícitamente usando @ruleName
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts
Los archivos referenciados como @service-template.ts se incluyen como contexto adicional cuando la regla se activa.

Reglas anidadas

Organiza las reglas colocándolas en directorios .cursor/rules a lo largo de tu proyecto. Las reglas anidadas se adjuntan automáticamente cuando se referencian archivos en su directorio.
project/
  .cursor/rules/        # Reglas de 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 yendo a 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.
Comparación de reglas concisas vs largas

Generar reglas

Genera reglas directamente en conversaciones usando el comando /Generate Cursor Rules. Útil cuando has tomado decisiones sobre el comportamiento del agente y quieres reutilizarlas.

Mejores prácticas

Las buenas reglas son enfocadas, accionables y tienen un alcance definido.
  • Mantén las reglas por debajo de 500 líneas
  • Divide las reglas grandes en múltiples reglas componibles
  • Proporciona ejemplos concretos o archivos de referencia
  • Evita orientación vaga. Escribe reglas como documentación interna clara
  • Reutiliza reglas cuando repitas prompts en el chat

Ejemplos

Muchos ejemplos disponibles de proveedores y frameworks. Las reglas contribuidas por la comunidad se encuentran en colecciones colaborativas y repositorios en línea.

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 convenciones de codificación:
Por favor responde de manera concisa. Evita repeticiones innecesarias o lenguaje de relleno.

.cursorrules (Heredado)

El archivo .cursorrules en la raíz de tu proyecto aún es compatible pero será descontinuado. Recomendamos migrar a las Reglas de Proyecto para obtener más control, flexibilidad y visibilidad.

Preguntas Frecuentes