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.
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.
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
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.
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.
Los archivos de Rules están limitados a 12 000 caracteres cada uno.
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>