Guía Completa para Crear Reglas en Cursor

Introducción

Cursor permite definir reglas contextuales que guían a la IA mientras programas, para que respete el estilo y las convenciones de tus proyectos. En esta guía veremos cómo crear reglas efectivas, cuándo usarlas y en qué se diferencian de los otros dos formatos que Cursor soporta hoy. Y si todavía estás evaluando la herramienta, revisa primero los precios y planes de Cursor para elegir el tier que se ajusta a tu uso.

¿Qué son las reglas de Cursor?

Las reglas son documentos que ayudan al agente de IA de Cursor a entender el contexto de tu código. Existen varios tipos de reglas:

• Always Apply: Siempre aplicadas.
• Apply to Specific Files: Se activan automáticamente según patrones de archivos.
• Apply Intelligently: El agente decide si la usa a partir de su description.
• Apply Manually: Activadas manualmente usando @ruleName.

Estructura y ubicación

Las reglas se guardan en .cursor/rules con formato .mdc. Cada archivo puede tener metadata como:

---
description: "Ejemplo de regla"
globs: src/**/*.ts
alwaysApply: false
---

Si alwaysApply vale true, la regla entra en todas las conversaciones y Cursor ignora globs y description. Varios patrones en globs van separados por comas.

Y debajo, el contenido que describe qué debe hacer el desarrollador.

Si vienes del archivo .cursorrules

El formato original era un único archivo .cursorrules en la raíz del proyecto, en texto plano y sin metadata. La ayuda de Cursor lo marca como legacy y anuncia que se va a deprecar, así que conviene migrarlo.

La diferencia práctica es que .cursorrules se cargaba entero y siempre, mientras que .cursor/rules te deja partir las reglas en varios archivos .mdc y decidir cuándo aplica cada uno con globs y alwaysApply. En un proyecto mediano eso es la diferencia entre inyectar todo el contexto en cada petición o solo el que corresponde al archivo que estás tocando.

Para migrar: crea la carpeta .cursor/rules, mueve el contenido a uno o varios .mdc con el frontmatter de arriba, y borra el .cursorrules viejo. Si quieres conservar el comportamiento de antes, marca la regla como Always Apply.

Ejemplo práctico

---
description: "Usar snake_case en servicios"
globs: backend/**/*.ts
alwaysApply: false
---
 
- Los nombres de función deben seguir el formato snake_case.

Crear reglas desde Cursor

Puedes usar la interfaz de Cursor (Customize > Rules > Add Rule, o "New Cursor Rule" en la paleta de comandos) o el comando /create-rule en el chat del agente para generar contenido automáticamente.

¿Rules, AGENTS.md o SKILL.md?

Cuando escribí este artículo, las Cursor Rules en .mdc eran la única forma de darle contexto permanente al editor. Ya no lo son: Cursor soporta también AGENTS.md y las Agent Skills en .cursor/skills/ y .agents/skills/, y los tres conviven resolviendo cosas distintas.

Antes de invertir tiempo en un formato, conviene saber cuál de los tres te toca:

Rules, AGENTS.md y SKILL.md en Cursor: cuál usar

Mejores prácticas

• Mantén reglas por debajo de 500 líneas.
• Usa ejemplos concretos.
• Organiza las reglas en carpetas temáticas (frontend, backend, tests).
• Documenta el propósito de cada regla claramente.

Preguntas frecuentes

Conclusión

Empieza por una sola regla corta y concreta, comprueba que el editor la respeta y ve sumando desde ahí. Y si dudas entre .mdc, AGENTS.md o una Skill, lo comparo en Rules, AGENTS.md y SKILL.md en Cursor.

Referencia oficial: Documentación de Reglas en Cursor y la ayuda sobre reglas

Fuentes

• Rules | Cursor Docs (documentación oficial de Cursor)
• Rules | Cursor Help (ayuda oficial de Cursor)
• Agent Skills | Cursor Docs (documentación oficial de Cursor)