Memories es el sistema para compartir y conservar contexto entre conversaciones. Hay dos mecanismos para esto en Cascade: Memories, que pueden generarse automáticamente por Cascade, y reglas, que el usuario define manualmente tanto a nivel local como global.

Cómo gestionar Memories

Puedes acceder y configurar Memories y Rules en cualquier momento haciendo clic en el icono Customizations en el menú deslizante superior derecho de Cascade. Para editar una Memory existente, simplemente haz clic en ella y luego en el botón Edit.

Memorias

Durante la conversación, Cascade puede generar y almacenar automáticamente memorias cuando detecta contexto que considera útil recordar. Además, puedes pedirle a Cascade que cree una memoria en cualquier momento. Solo indícale a Cascade: “create a memory of …”. Las memorias autogeneradas de Cascade están asociadas con el workspace en el que se crearon y Cascade las recuperará cuando considere que son relevantes. Las memorias generadas en un workspace no estarán disponibles en otro.
Crear y usar memorias autogeneradas NO consume créditos

Reglas

Los usuarios pueden definir explícitamente sus propias reglas para que Cascade las siga. Las reglas pueden definirse a nivel global o a nivel de workspace. global_rules.md - reglas aplicadas en todos los workspaces .windsurf/rules - directorio a nivel de workspace que contiene reglas asociadas a globs o descripciones en lenguaje natural.

Descubrimiento de reglas

Windsurf descubre automáticamente reglas desde múltiples ubicaciones para ofrecer una organización flexible:
  • workspace actual y subdirectorios: Todos los directorios .windsurf/rules dentro 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 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

Ubicaciones de almacenamiento de Rules

Las Rules se pueden guardar en cualquiera de estas ubicaciones:
  • .windsurf/rules en el directorio de tu workspace actual
  • .windsurf/rules en cualquier subdirectorio de tu workspace
  • .windsurf/rules en directorios superiores hasta la raíz de git (para repositorios git)
Cuando crees una nueva Rule, se guardará en el directorio .windsurf/rules de tu workspace actual, no necesariamente en la raíz de git. Para comenzar con Rules, haz clic en el icono Customizations en el menú deslizante superior derecho de Cascade y luego ve al panel Rules. Aquí puedes hacer clic en el botón + Global o + Workspace para crear nuevas Rules a nivel global o de workspace, respectivamente.
Puedes encontrar plantillas de Rules de ejemplo seleccionadas por el equipo de Windsurf en https://windsurf.com/editor/directory para ayudarte a comenzar.
Los archivos de Rules están limitados a 12 000 caracteres cada uno.

Mejores prácticas

Para ayudar a Cascade a seguir tus reglas de forma efectiva, sigue estas mejores prácticas:
  • 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., “escribe buen código”), ya que esto ya está incorporado en los datos de entrenamiento de Cascade.
  • Da formato a tus reglas usando viñetas, listas numeradas y Markdown. Así son más fáciles de seguir para Cascade que un párrafo largo.
Por ejemplo:
# Directrices de Codificación
- El lenguaje de programación de mi proyecto es Python
- Utiliza retornos tempranos cuando sea posible
- Siempre añade documentación al crear nuevas funciones y clases
  • Las etiquetas XML pueden ser una forma eficaz de comunicar y agrupar reglas similares. Por ejemplo:
<coding_guidelines>
- El lenguaje de programación de mi proyecto es Python
- Usa retornos tempranos cuando sea posible
- Siempre agrega documentación al crear nuevas funciones y clases
</coding_guidelines>