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

Project Rules

Almacenadas en .cursor/rules, con control de versiones y con ámbito a tu base de código.

User Rules

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

AGENTS.md

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

.cursorrules (Legacy)

Aún compatible, pero en desuso. Usa Project Rules en su lugar.

Cómo funcionan las reglas

Los modelos de lenguaje grandes no conservan memoria entre completions. Las reglas proporcionan contexto persistente y reutilizable a nivel de prompt. Cuando se aplican, el contenido de la regla se incluye al comienzo 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.
Regla aplicada en el contexto con chat
Las reglas se aplican a Chat y Inline Edit. Las reglas activas aparecen 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 con patrones de ruta, invocarse manualmente o incluirse según su relevancia. Los subdirectorios pueden incluir su propio directorio .cursor/rules con alcance a esa carpeta. Usa las reglas del proyecto para:
  • Codificar conocimiento específico del dominio sobre tu 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 selector de tipo, que modifica las propiedades description, globs, alwaysApply.
Rule TypeDescription
AlwaysSiempre incluida en el contexto del modelo
Auto AttachedSe incluye cuando se hace referencia a archivos que coinciden con un patrón glob
Agent RequestedDisponible para la IA, que decide si incluirla. Debe proporcionar una descripción
ManualSolo se incluye 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

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 hace referencia a archivos en su directorio.
project/
  .cursor/rules/        # Reglas a nivel de proyecto
  backend/
    server/
      .cursor/rules/    # Reglas específicas de backend
  frontend/
    .cursor/rules/      # Reglas específicas de 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 entre reglas concisas y extensas

Generar reglas

Genera reglas directamente en 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 indicaciones vagas. Escribe las reglas como documentación interna clara
  • Reutiliza reglas cuando repitas prompts en el chat

Ejemplos

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 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 Project Rules, AGENTS.md es un archivo markdown plano, sin metadatos ni configuraciones complejas. Es perfecto para proyectos que necesitan instrucciones simples y legibles sin la sobrecarga 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

Limitaciones actuales

  • Solo en la raíz: AGENTS.md debe estar en la raíz de tu proyecto (v1.5)
  • Sin alcance: Las instrucciones se aplican globalmente a tu proyecto
  • Archivo único: A diferencia de .cursor/rules, no puedes dividir las instrucciones en varios archivos
El soporte para AGENTS.md anidado en subdirectorios está previsto para la v1.6.

Reglas de usuario

Las reglas de usuario son preferencias globales definidas en Cursor Settings → Rules que se aplican en todos los proyectos. Son texto plano y perfectas para definir el estilo de comunicación preferido o las convenciones de código:
Please reply in a concise style. Avoid unnecessary repetition or filler language.

.cursorrules (legado)

El archivo .cursorrules en la raíz de tu proyecto sigue siendo compatible, pero quedará obsoleto. Te recomendamos migrar a Reglas del proyecto para obtener más control, flexibilidad y visibilidad.

Preguntas frecuentes