Cursor

Qué es Cursor

Fork de VS Code con agente de IA integrado: chat, edición multiarchivo, reglas de proyecto, skills y MCP. Uno de los editores más usados para programar con agentes.

Docs: cursor.com/docs

Orden sugerido (sin prisa)

1. Contexto del repo

Crea AGENTS.md en la raíz con build, tests y 3–5 convenciones. Es lo que más impacto tiene al inicio.

2. Reglas del proyecto

Carpeta .cursor/rules/ con reglas cortas por stack. Empieza con una regla; no copies listas enteras de Cursor Directory sin leerlas.

Concepto: ¿Qué es una regla?.

Ejemplo de regla mínima:

---
description: Convenciones del proyecto
globs: **/*.{ts,tsx}
---
- Usar App Router de Next.js
- Tests con Vitest
- No usar `any`

3. Skills (cuando tengas una tarea repetida)

Carpeta con SKILL.md en .cursor/skills/. Guías: ¿Qué es un skill? · Skills vs reglas vs MCP.

No instales skills virales el primer día. Ejemplos del catálogo: ui-skills, ponytail (polémico — léelo antes).

4. MCP (solo si lo necesitas)

Settings → MCP. Guía: ¿Qué es un MCP?. Útil si el modelo inventa APIs: Context7. Para browser: Playwright MCP. No actives diez a la vez.

5. Modelos locales

Cursor en la práctica usa modelos del proveedor según tu plan. Endpoint Ollama local es nicho y requiere configuración avanzada. Para self-host claro: OpenCode o Cline — nube vs local.

Headroom en Cursor requiere proxy manual — no es plug-and-play; ver Headroom.

Dónde va cada cosa

Pieza	Ubicación
Contexto repo	AGENTS.md
Reglas	.cursor/rules/*.mdc o .md
Skills	.cursor/skills/<nombre>/SKILL.md
MCP	Settings → MCP

Cursor vs VS Code vs Windsurf

	Cursor	VS Code + Copilot	Windsurf
Agente	Integrado	Copilot / Cline	Cascade
Reglas	.cursor/rules/	copilot-instructions	.windsurfrules
Skills	.cursor/skills/	.github/skills/	Según doc

Errores comunes

• 50 reglas genéricas → el agente las ignora. Menos y específicas.
• MCPs sin caso de uso → ruido en el contexto.
• Saltarse AGENTS.md → repites instrucciones en cada chat.