Memories es el sistema para compartir y mantener el contexto entre conversaciones.
En Windsurf hay dos mecanismos para esto: Memories, que Cascade genera automáticamente, y Rules, que el usuario define manualmente a nivel global, de workspace o de sistema.
Windsurf ofrece varias formas de personalizar Cascade. Usa esta tabla para elegir la más adecuada:
Puedes acceder y configurar Memories y Rules en cualquier momento haciendo clic en el icono de
Customizations en el menú deslizante superior derecho de Cascade, o mediante “Windsurf - Settings” en la esquina inferior derecha. Para editar una memory existente, simplemente haz clic en ella y luego en el botón Edit.
Durante la conversación, Cascade puede generar y almacenar Memories automáticamente si encuentra contexto que considera útil recordar.
Además, puedes pedirle a Cascade que cree una memory en cualquier momento. Basta con indicarle a Cascade: “create a memory of …”.
Las Memories autogeneradas de Cascade están asociadas al workspace en el que se crearon y se almacenan localmente en ~/.codeium/windsurf/memories/. Cascade las recuperará cuando considere que son relevantes. Las Memories generadas en un workspace no estarán disponibles en otro, y no se confirman en tu repositorio.
Las Memories autogeneradas solo existen en tu máquina. Si quieres que Cascade recuerde algo de forma duradera —y compartirlo con tu equipo— pídele a Cascade que lo escriba en una Rule dentro de
.windsurf/rules/ o en el AGENTS.md de tu repositorio.
Windsurf detecta automáticamente reglas desde múltiples ubicaciones para ofrecer una organización flexible:
- workspace actual y subdirectorios: Todos los directorios
.windsurf/rulesdentro de tu workspace actual y sus subdirectorios - Estructura del repositorio Git: Para repositorios Git, Windsurf también busca hasta el directorio raíz de Git para encontrar reglas en los directorios superiores
- Compatibilidad con múltiples workspaces: Cuando hay varias carpetas abiertas en el mismo workspace, las reglas se desduplican y se muestran con la ruta relativa más corta
.windsurf/rulesen el directorio de tu workspace actual.windsurf/rulesen cualquier subdirectorio de tu workspace.windsurf/rulesen directorios superiores hasta la raíz de git (para repositorios de git)
.windsurf/rules de tu workspace actual, no necesariamente en la raíz de git.
Para comenzar con Rules, haz clic en el ícono Customizations en el menú deslizante superior derecho de Cascade y luego ve al panel Rules. Allí puedes hacer clic en el botón + Global o + Workspace para crear nuevas rules a nivel global o de workspace, respectivamente.
Los archivos de rules de workspace tienen un límite de 12 000 caracteres cada uno. El archivo de rules globales tiene un límite de 6 000 caracteres.
Cada regla de workspace declara un modo de activación en su frontmatter mediante el campo trigger. Esto controla cuándo se envía el contenido de la regla a Cascade y cuánta ventana de contexto consume:
El archivo de reglas globales (
global_rules.md) y los archivos AGENTS.md en la raíz no usan frontmatter; siempre están activados.- Mantén las reglas simples, concisas y específicas. Las reglas demasiado largas o vagas pueden confundir a Cascade.
- No es necesario añadir reglas genéricas (p. ej., “write good code”), ya que eso ya está incorporado en los datos de entrenamiento de Cascade.
- Da formato a tus reglas con viñetas, listas numeradas y Markdown. A Cascade le resulta más fácil seguir esto que un párrafo largo. Por ejemplo:
- Las etiquetas XML pueden ser una forma eficaz de expresar y agrupar reglas similares. Por ejemplo:
.md) en el directorio correspondiente para tu sistema operativo. El sistema cargará automáticamente todos los archivos .md ubicados en esos directorios.
Las reglas a nivel de sistema se combinan con las reglas de workspace y las reglas globales, proporcionando contexto adicional a Cascade sin sobrescribir las reglas definidas por el usuario. Esto permite que las organizaciones establezcan estándares básicos, al tiempo que siguen permitiendo que los equipos añadan personalizaciones específicas de cada proyecto.
En la interfaz de Windsurf, las reglas a nivel de sistema se muestran con una etiqueta “System” y no pueden ser eliminadas por los usuarios finales.
Importante: Las reglas a nivel de sistema deben ser administradas por su equipo de TI o de seguridad. Asegúrese de que sus equipos internos gestionen la implementación, las actualizaciones y el cumplimiento de acuerdo con las políticas de su organización. Puede usar herramientas y flujos de trabajo estándar, como Mobile Device Management (MDM) o Configuration Management, para hacerlo.