Configuración avanzada de Cursor Rules: crea tu asistente de programación con IA

En el mismo proyecto, Cursor a veces genera código elegante y a veces algo que no encaja con tu estilo. Escribes reglas en .cursorrules y parece que la IA no las ve. Cambias de proyecto y vuelves a configurar todo.

La primera vez pasé horas escribiendo reglas sin cambio real: el problema no eran las reglas, sino cómo entendía el sistema.

Este artículo trata el uso avanzado de Cursor Rules: no un «qué es .cursorrules», sino prácticas para sacarle partido de verdad.

1. Reconceptualizar Cursor Rules

1.1 De .cursorrules a .cursor/rules

Si llevas tiempo con Cursor, quizá sigues con un único .cursorrules. Funciona, pero con límites claros.

Un solo archivo concentra todo y complica el mantenimiento. No puedes reglas distintas por tipo de archivo: React y Python en el mismo repo, reglas separadas — el formato antiguo no lo permite bien.

En 2026, Cursor añadió .cursor/rules/ con formato MDC.

Vultr - Servidor cloud NVMe de alto rendimiento, 32 ubicaciones globales, despliegue Docker con un clic

Ver precios →Anuncio

.cursor/
└── rules/
    ├── base.mdc
    ├── frontend.mdc
    ├── backend.mdc
    └── testing.mdc

Cada .mdc es un módulo con globs: frontend.mdc para .tsx, backend.mdc para .py.

La migración es sencilla: .cursorrules sigue válido; para actualizar, divide en varios .mdc.

1.2 Tres tipos de reglas

Project Rules en .cursor/rules/, solo el proyecto actual. Stack (React 18 + Tailwind), etc. El equipo las hereda al clonar.

Team Rules en la nube, compartidas. Estándares de equipo; requiere plan Team de Cursor.

User Rules en ajustes de Cursor, todos tus proyectos. Preferencias personales (tabs vs espacios, idioma de comentarios).

Prioridad: User > Team > Project.

1.3 Cómo se activan las reglas

El contenido de las reglas entra en el contexto del modelo y consume tokens. Más no es mejor.

Los globs funcionan como .gitignore: ["**/*.tsx"] o ["app/api/**/*"].

KiloClaw - OpenClaw gestionado para empresas: orquestación de agentes IA y enrutamiento inteligente

Empezar →Anuncio

Si varias reglas aplican al mismo archivo, Cursor carga por orden lexicográfico del nombre. Prefijos numéricos (00-base.mdc, 01-frontend.mdc) controlan prioridad.

2. Configuración práctica

2.1 React + TypeScript

Copia en .cursor/rules/react.mdc:

---
description: Reglas proyecto React + TypeScript
globs: ["**/*.{ts,tsx}"]
---

# Stack
- React 18+
- TypeScript 5.0+
- Tailwind CSS

# Estilo
- Componentes funcionales con function
- Props con interfaces TypeScript
- Estructura: componente exportado → subcomponentes → helpers → types
- Exportaciones nombradas, evitar default export

# Buenas prácticas React
- Server Components si usas Next.js
- useState / useReducer para estado
- useEffect con cleanup
- React.memo en componentes sensibles al rendimiento

# Errores
- early return
- guard clauses
- Mensajes amigables al usuario

Orden: stack → estilo → prácticas → errores.

2.2 Next.js 14 full-stack

.cursor/
└── rules/
    ├── base.mdc
    ├── api.mdc
    ├── components.mdc
    ├── database.mdc
    └── testing.mdc

Ejemplo api.mdc:

---
globs: ["app/api/**/*.{ts,tsx}"]
---

# Rutas API
- Route Handlers (app/api/)
- Tipo APIResponse unificado
- Validación con Zod
- Errores con next-safe-action

# Formato de respuesta
- GET: { success, data?, error? }
- POST: validar → procesar → responder
- Clasificar: validación, negocio, sistema

Las reglas API solo actúan en app/api/.

2.3 Python FastAPI

---
description: Reglas Python FastAPI
globs: ["**/*.py"]
---

# Stack
- Python 3.12+
- FastAPI 0.100+
- SQLAlchemy 2.0
- Pydantic v2

# Estilo
- Black + isort
- type hints obligatorios
- snake_case en funciones

# FastAPI
- Inyección de dependencias para BD
- Validación Pydantic
- background tasks
- Middleware de errores unificado

# Base de datos
- SQLAlchemy 2.0 async
- Alembic para migraciones
- soft delete y auditoría

2.4 Trabajo en equipo

proyecto/
├── .cursor/rules/
│   ├── README.md
│   ├── base.mdc
│   ├── frontend.mdc
│   ├── backend.mdc
│   └── team-guidelines.mdc
└── .cursorrules  # opcional

• Versiona las reglas en Git
• Comenta cada archivo para onboarding
• Revisa y actualiza cada iteración

3. Depuración y optimización

3.1 Diagnóstico

1. Ubicación: .cursor/rules/ o .cursorrules en raíz
2. globs: pregunta a la IA qué reglas ve
3. YAML: frontmatter MDC bien indentado
4. Conflictos: fusiona requisitos contradictorios

3.2 Estrategias

Concisión: lo importante primero.

Especificidad: «componentes funcionales» mejor que «código limpio».

Alibaba Cloud - Opción preferida para desarrolladores, 15 % de descuento exclusivo en Lighthouse

Obtener 15% dto. →Anuncio

Capas: Stack → estilo → prácticas → errores.

Iteración: ajusta según la calidad del código generado.

3.3 Métricas

• Tasa de uso directo del código generado
• Consistencia de estilo
• Menos bugs
• Mayor velocidad de desarrollo

4. MDC y modularización (2026)

4.1 Formato MDC

---
description: Descripción (opcional)
globs: ["patrón"]
alwaysApply: false
---

# Contenido de la regla

alwaysApply: true gasta tokens; úsalo con cuidado.

4.2 Arquitectura modular

.cursor/rules/
    ├── 00-base.mdc
    ├── 01-tech-stack.mdc
    ├── 10-frontend/react.mdc
    ├── 20-backend/api.mdc
    └── README.md

4.3 Herramientas

cursor.directory, cursorrules.org, awesome-cursorrules — personaliza, no copies a ciegas.

5. Resumen y acción

5.1 Checklist

1. Tipo de proyecto
2. Plantilla de comunidad
3. Personalizar stack y hábitos
4. Probar generación de código
5. Compartir en el repo

5.2 Evitar

• Reglas vagas o archivos >200 líneas
• Desplegar sin probar
• No actualizar cuando el proyecto cambia

5.3 Recursos

• Documentación oficial Cursor
• awesome-cursorrules
• Foro Cursor

Abre tu proyecto y configura la primera regla. Empieza simple: verás cómo la IA se acerca más a tu forma de trabajar.