Windsurf

Qué es Windsurf

Editor con agente Cascade, modelos múltiples, reglas, skills y soporte MCP. Comparte mucho ADN con Cursor en configuración de proyecto.

Docs: docs.windsurf.com

Orden sugerido

1. Contexto del repo

AGENTS.md con build, tests y 3–5 convenciones. Especialmente útil si el equipo mezcla Windsurf con Cursor u otros agentes.

2. Reglas globales y de workspace

Windsurf usa .windsurfrules o reglas por workspace (según versión). Convenciones cortas y específicas — no listas genéricas.

Concepto: ¿Qué es una regla?. Inspiración: Cursor Directory — muchas entradas sirven para Windsurf; adapta, no copies.

3. Skills

Formato Agent Skills (SKILL.md). Guía: ¿Qué es un skill?. Añade skills solo cuando repites una tarea (UI → ui-skills, etc.).

4. MCP

Integración MCP en settings. Guía: ¿Qué es un MCP?. Ejemplos: Context7, directorio Smithery. Un MCP bien elegido al inicio.

5. Cascade (modo agente)

Tareas multi-paso: define objetivo claro en el primer mensaje; referencia archivos con @ si la UI lo permite. Revisa el plan antes de cambios grandes.

6. Modelos locales

Windsurf en la práctica usa modelos del servicio (nube). Ollama local no es el flujo habitual. Para self-host: OpenCode o Cline — guía nube vs local.

Dónde va cada cosa

Pieza	Ubicación habitual
Contexto repo	AGENTS.md
Reglas	.windsurfrules / reglas de workspace
Skills	Carpeta de skills del proyecto (según doc Windsurf)
MCP	Settings → MCP

Windsurf vs Cursor vs Antigravity

	Windsurf	Cursor	Antigravity
Agente	Cascade	Chat / Composer	Editor + Agent Manager
Reglas	.windsurfrules	.cursor/rules/	Workspace rules
Multi-agente	Principalmente uno	Principalmente uno	Varios (Agent Manager)

Si ya tienes reglas de cursor.directory, revísalas antes de duplicar en Windsurf.

Errores comunes

• Importar reglas de otro stack sin editar.
• Activar MCPs que no usarás en esa sesión.
• Saltarse AGENTS.md y repetir instrucciones en cada chat.