MemoryLake
Volver a todos los artículos
Pain Point22 de mayo de 20267 min de lectura

¿Por qué Windsurf olvida las reglas de mi proyecto?

Tienes un archivo `.windsurfrules` en la raíz de tu repositorio. Dice, claramente: "Nunca escribas en tablas `prod_*` sin un aviso de confirmación." Cascade lo lee en el turno 1, está de acuerdo entusiastamente, y en el turno 38 propone alegremente un `DELETE FROM prod_users` sin un solo asterisco de advertencia.

El archivo de reglas es real. Cascade lo vio. ¿Entonces qué pasó?

La respuesta corta

Windsurf olvida las reglas del proyecto porque .windsurfrules y global_rules.md son texto estático inyectado en la parte superior de cada chat, ambos tienen un límite práctico de alrededor de 6,000 caracteres, y Cascade resume automáticamente las sesiones largas — lo que comprime los detalles de las reglas en una reafirmación de una línea. Una memoria de proyecto recuperable mantiene las reglas aplicables en cada turno.

Por qué Windsurf olvida las reglas del proyecto

Cascade intenta obedecer tus reglas. Tres mecánicas las socavan silenciosamente:

1. Las reglas son un prefijo, no memoria activa. .windsurfrules y global_rules.md se anteponen a tu aviso. Cascade las lee una vez al inicio de la sesión. Viven en la misma ventana de contexto que tu código y tu conversación, y compiten por espacio a medida que la sesión crece.

2. Los archivos de reglas están limitados. Windsurf documenta un límite práctico de alrededor de 6,000 caracteres por archivo antes de que las reglas empiecen a perder efecto. Combina reglas de espacio de trabajo, reglas globales y la convención AGENTS.md que algunos equipos utilizan, y puedes alcanzar el límite en un solo sprint.

3. La resumación comprime los detalles de las reglas. Codeium ha reconocido en su registro de cambios que la resumación previa de Cascade fue lo suficientemente agresiva como para eliminar contexto importante. Incluso con mejoras, los resúmenes son perdedores. Una regla de 12 líneas sobre operaciones seguras en la base de datos puede volver a través de la resumación como "ten cuidado con la base de datos" — lo que no es una regla, es una sensación.

El resultado: las reglas funcionan por un tiempo, se desvían gradualmente y fallan en el peor momento.

Lo que pierdes cuando Windsurf olvida las reglas del proyecto

Una regla que no se mantiene es peor que no tener regla alguna — da una falsa sensación de seguridad:

  • Operaciones inseguras se cuelan. La regla "nunca tocar prod" que funcionó en el turno 5 falla silenciosamente en el turno 40, cuando Cascade está profundamente en una refactorización y propone exactamente la operación que prohibiste.
  • Las convenciones de la casa se desvanecen. "Siempre usa acciones del servidor para mutaciones" funciona para los primeros tres archivos. Para el sexto, Cascade está buscando un antiguo patrón de ruta de API porque los detalles de la regla se resumieron.
  • Reafirmas la misma regla, cada sesión, para siempre. Y en el momento en que olvidas reafirmarla, Cascade vuelve a los valores predeterminados.

Soluciones integradas de Windsurf (y dónde cada una falla)

Windsurf tiene tres mecanismos nativos para las reglas. Cada uno ayuda; ninguno mantiene la línea por sí solo.

`.windsurfrules` (espacio de trabajo) es el archivo de reglas por repositorio. Cascade lo carga en cada sesión. Es estático, limitado y compite con la conversación por espacio de contexto. Las sesiones largas lo comprimen.

`global_rules.md` (interespacio de trabajo) vive en tu configuración de Windsurf y se aplica en todas partes. Mismo formato, mismo límite, mismo problema de compresión.

Memorias de Cascade generan automáticamente notas cortas de alcance de espacio de trabajo durante los chats. Útil para "recordar que el usuario ejecuta pnpm test". No útil para reglas de proyecto matizadas que abarcan múltiples líneas o incluyen ejemplos.

Puedes leer la documentación oficial de Memorias de Cascade para el desglose completo de características.

Para un puñado de reglas estables, los nativos funcionan. Para un verdadero libro de reglas de proyecto que evoluciona semana a semana, se quedan cortos.

Dónde la memoria integrada de Windsurf se queda corta

Las reglas del proyecto viven por encima del editor. La regla "nunca tocar prod" se aplica ya sea que estés en Cascade, Cursor, Claude Code o ChatGPT. .windsurfrules no viaja a ninguno de ellos. Cada herramienta obtiene su propia copia, esas copias se desvían, y el proyecto pierde su única fuente de verdad.

Las reglas pertenecen al proyecto. La memoria necesita vivir con el proyecto, no con el editor.

Cómo MemoryLake soluciona el olvido de reglas de proyecto en Windsurf

MemoryLake es una capa de memoria intermodelo que se conecta a Windsurf a través del soporte nativo de MCP de Cascade. En lugar de anteponer una cadena de reglas truncada, cargas el libro de reglas completo en un proyecto, y Cascade recupera la regla relevante por turno.

  • Reglas como memoria recuperable, no como una cadena antepuesta. Carga tu libro de reglas completo — seguridad de DB, higiene de ramas, verificaciones de despliegue, nomenclatura, pruebas — en el proyecto. Cascade extrae la regla relevante en el momento de la decisión, por lo que la regla no tiene que luchar por espacio de contexto.
  • 10,000× más contexto que la indicación en bruto. El motor de recuperación de MemoryLake lee de miles de millones de tokens de memoria del proyecto y presenta lo que es relevante por turno. No más límite de 6,000 caracteres.
  • Un libro de reglas, cada herramienta de IA. Las mismas reglas rigen Cursor, Claude Code, ChatGPT, Claude Desktop y Gemini. Cuando la regla cambia una vez, cambia en todas partes.

MemoryLake obtuvo un 94.03% en el benchmark de contexto largo de LoCoMo — el mejor resultado publicado hasta 2026 — con recuperación en milisegundos y cifrado de extremo a extremo AES-256.

Conectar MemoryLake a Windsurf en 3 pasos

  1. Crea un proyecto y carga tu libro de reglas. Inicia sesión en MemoryLake, abre Gestión de Proyectos, haz clic en Crear Proyecto y nómbralo según tu repositorio (por ejemplo, "acme-platform — reglas del proyecto"). Sube tu .windsurfrules, AGENTS.md, manuales de ejecución y documentos de seguridad existentes a través del Document Drive (PDF, Markdown, Word, Excel, imágenes todos soportados). Agrega reglas imperativas cortas en la pestaña de Memorias — una regla por memoria funciona bien para la recuperación.
  2. Genera un endpoint de servidor MCP. Abre la pestaña de Servidores MCP dentro de tu proyecto, haz clic en Agregar Servidor MCP, nómbralo "integración de Windsurf" y haz clic en Generar. MemoryLake devuelve un ID de clave API, secreto y URL de endpoint. Copia el secreto inmediatamente — se muestra solo una vez.
  3. Agrega el servidor a la configuración de MCP de Cascade. En Windsurf, abre Configuración → Cascade → Administrar MCPs → Ver configuración en bruto, luego agrega una entrada memorylake con la URL del endpoint y tu token Bearer. Guarda y reinicia Cascade. Cascade ahora tiene una herramienta memorylake que puede llamar para recuperar la regla aplicable cada vez que esté a punto de realizar una acción arriesgada.

Preguntas frecuentes

¿Windsurf recuerda las reglas del proyecto?

Windsurf carga .windsurfrules (espacio de trabajo) y global_rules.md (global) en cada chat de Cascade. Cascade las sigue al inicio de una sesión. A medida que las sesiones largas resumen automáticamente el contexto anterior, los detalles de las reglas pueden comprimirse, por lo que las reglas detalladas a menudo se desvían a mitad de camino.

¿Cómo hago que Cascade siga mis reglas de proyecto de manera consistente?

Conecta Cascade a una capa de memoria externa como MemoryLake a través del soporte nativo de MCP de Windsurf. Las reglas viven en la memoria del proyecto como elementos recuperables, por lo que Cascade puede obtener la regla específica que se aplica a la acción actual en lugar de depender de una cadena antepuesta que compite con todo lo demás por el contexto.

¿Por qué Cascade ignora mi archivo .windsurfrules?

Generalmente no se ignora al inicio — se comprime más tarde. Windsurf tiene un límite práctico de alrededor de 6,000 caracteres por archivo de reglas, y las sesiones largas resumen agresivamente los turnos anteriores. Una regla de 12 líneas puede volver como una paráfrasis vaga que ya no lleva detalles aplicables.

¿Cuál es la diferencia entre .windsurfrules y global_rules.md?

.windsurfrules vive en tu repositorio y se aplica solo a ese espacio de trabajo. global_rules.md vive en tu configuración de Windsurf y se aplica en todas partes. Ambos tienen el mismo límite de caracteres, ambos se cargan como texto estático y ambos enfrentan la misma deriva de resumación en sesiones largas.

¿Puedo compartir mis reglas de proyecto entre Windsurf y Cursor?

.windsurfrules y .cursorrules son específicos de la herramienta y no se transfieren. MemoryLake almacena reglas en un Proyecto neutral al modelo, por lo que el mismo libro de reglas funciona en Windsurf, Cursor, Claude Code, Claude Desktop, ChatGPT y cualquier herramienta que hable MCP o REST.