Instrucciones versionadas para Agent en `.cursor/rules` con globs y modos de aplicación
Las Project Rules de Cursor son archivos Markdown o `.mdc` dentro de `.cursor/rules`, versionados en git e inyectados en el Agent según frontmatter (`description`, `globs`, `alwaysApply`). Sirven para arquitectura, zonas delicadas o plantillas repetibles; Cursor documenta cuatro tipos de aplicación más AGENTS.md como alternativa ligera.
Casos de uso
- Enforcing migration patterns only inside `database/` directories
- Documenting RPC conventions so Cursor Agent pulls guidance automatically during backend edits
- Blocking edits to generated output folders stated explicitly in Always Apply rules
- Providing onboarding checklists referenced via `@template.md` snippets
- Aligning frontend conventions whenever `*.tsx` files under `src/components/` enter context
Funciones principales
- Crea `.cursor/rules/` en la raíz del repositorio
- Redacta `.md` simples o `.mdc` con frontmatter conforme a la tabla oficial
- Selecciona Always Apply, Intelligent, patrones glob o menciones manuales `@rule`
- Divide guías largas; Cursor recomienda límites cercanos a 500 líneas por archivo
- Referencia archivos canónicos con `@archivo.ts` en lugar de copiar todo el contenido
- Versiona `.cursor/rules` en git para equipos
Relacionados
Relacionados
3 Entradas indexadas
API design and versioning
Da forma a superficies de API REST o RPC con modelado consistente de recursos, respuestas de error predecibles, endpoints de lista paginados y una política de deprecación explícita antes de que la implementación te encasille en contratos costosos de cambiar. Un buen diseño de API previene breakage de clientes, reduce carga de soporte y hace las adiciones de funcionalidades menos disruptivas.
Codebase indexing
Construye y mantiene índices semánticos de un codebase para que asistentes de codificación de IA puedan retrieve contexto relevante: relaciones de archivos, uso de símbolos, decisiones históricas sin re-parsear el codebase completo en cada query. Codebase indexing es esencial para codebases grandes donde límites de context window previenen alimentar el codebase completo al modelo.
Contract testing
Bloquea expectativas de API entre servicios usando consumer-driven contracts para que cuando un equipo cambia su implementación, falla en CI en lugar de durante un deployment de producción Coordinado. Contract testing previene el patrón común de fallo de integración donde ambos lados de una API parecen trabajar en aislamiento pero rompen cuando se conectan en producción.