> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Memories y Rules
> Conserva el contexto a lo largo de las conversaciones de Cascade con Memories generadas automáticamente y Rules definidas por el usuario en los niveles global, de workspace y de sistema para equipos Enterprise.
`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.
## ¿Memories, Rules, Workflows o Skills?
Windsurf ofrece varias formas de personalizar Cascade. Usa esta tabla para elegir la más adecuada:
| Función | Qué hace | Cómo se activa | Cuándo usarla |
| ----------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **[Rules](#rules)** | Le indican a Cascade *cómo debe comportarse* (p. ej., "usa bun, no npm") | `always_on`, `glob`, `model_decision` o `manual` ([ver más abajo](#activation-modes)) | Convenciones de código, guías de estilo, restricciones del proyecto |
| **[AGENTS.md](/es/windsurf/cascade/agents-md)** | Rules con alcance por ubicación y sin configuración | Automática: raíz = always-on; subdirectorio = glob | Convenciones específicas de directorio sin frontmatter |
| **[Workflows](/es/windsurf/cascade/workflows)** | Plantillas de prompts para tareas repetibles de varios pasos | **Solo manual**, mediante el comando con barra `/[workflow-name]` | Despliegues, revisiones de PR, listas de verificación de lanzamientos |
| **[Skills](/es/windsurf/cascade/skills)** | Procedimientos de varios pasos agrupados con archivos de apoyo (scripts, plantillas) | El modelo de IA las invoca dinámicamente, o mediante `@mention` | Tareas complejas en las que Cascade necesita archivos de referencia — **prioriza esto** |
| **[Memories](#memories)** | Contexto que Cascade genera automáticamente durante las conversaciones | Recuperación automática cuando corresponde | Deja que Cascade recuerde datos puntuales; para conocimiento duradero, es mejor usar Rules o AGENTS.md |
**Recomendación:** Para el conocimiento que quieres que Cascade reutilice de forma fiable, escríbelo como una Rule o añádelo a `AGENTS.md` en tu repositorio, en lugar de depender de Memories generadas automáticamente. Las Rules tienen control de versiones, se pueden compartir con tu equipo y te dan control explícito sobre la activación.
## Cómo gestionar Memories
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`.
## Memories
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.
Crear y usar Memories autogeneradas NO consume créditos.
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](#rules) dentro de `.windsurf/rules/` o en el `AGENTS.md` de tu repositorio.
## Rules
Los usuarios pueden definir explícitamente sus propias Rules para que Cascade las siga.
Las Rules pueden definirse a nivel global, del workspace o del sistema, y también pueden inferirse a partir de archivos [AGENTS.md](/es/windsurf/cascade/agents-md).
| Alcance | Ubicación | Notas |
| ----------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Global | `~/.codeium/windsurf/memories/global_rules.md` | Un solo archivo, aplicado en todos los workspaces. Siempre activo. Limitado a 6.000 caracteres. |
| Workspace | `.windsurf/rules/*.md` | Un archivo por rule, cada uno con su propio [modo de activación](#activation-modes). Limitado a 12.000 caracteres por archivo. |
| [AGENTS.md](/es/windsurf/cascade/agents-md) | Cualquier directorio de tu workspace | Procesado por el mismo motor de Rules: nivel raíz = siempre activo; subdirectorio = auto-glob para ese directorio. |
| [System (Enterprise)](#system-level-rules-enterprise) | Específico del sistema operativo (p. ej. `/etc/windsurf/rules/`) | Lo implementa TI y es de solo lectura para los usuarios finales. |
## Descubrimiento de reglas
Windsurf detecta 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 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
### Ubicaciones para almacenar Rules
Las Rules pueden almacenarse 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 de 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 í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.
Puedes encontrar plantillas de rules de ejemplo seleccionadas por el equipo de Windsurf en [https://windsurf.com/editor/directory](https://windsurf.com/editor/directory) para ayudarte a empezar.
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.
### Modos de activación
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**:
| Modo | Valor de `trigger:` | Cómo llega a Cascade | Costo de contexto |
| ------------------ | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **Always On** | `always_on` | El contenido completo de la regla se incluye en el prompt del sistema en cada mensaje. | En cada mensaje |
| **Model Decision** | `model_decision` | Solo se muestra la `description` en el prompt del sistema. Cascade lee el archivo completo de la regla cuando determina que la descripción es relevante. | La descripción siempre; el contenido completo bajo demanda |
| **Glob** | `glob` | La regla se aplica cuando Cascade lee o edita un archivo que coincide con el patrón `globs` (p. ej., `*.js`, `src/**/*.ts`). | Solo cuando se modifican archivos coincidentes |
| **Manual** | `manual` | La regla **no** está en el prompt del sistema. La activas escribiendo `@rule-name` en el cuadro de entrada de Cascade. | Solo cuando se la menciona con @ |
El archivo de reglas globales (`global_rules.md`) y los archivos `AGENTS.md` en la raíz no usan frontmatter; siempre están activados.
Ejemplo de una regla de workspace con frontmatter:
```markdown theme={null}
---
trigger: glob
globs: **/*.test.ts
---
All test files must use `describe`/`it` blocks and mock external API calls.
```
### Mejores prácticas
Para ayudar a Cascade a seguir tus reglas de manera efectiva, aplica 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., “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:
```
# 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 expresar y agrupar reglas similares. Por ejemplo:
```
- 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
```
## Reglas a nivel de sistema (Enterprise)
Las organizaciones Enterprise pueden desplegar reglas a nivel de sistema que se aplican globalmente en todos los workspaces y que no pueden ser modificadas por los usuarios finales sin permisos de administrador. Esto es ideal para hacer cumplir estándares de codificación a nivel de organización, políticas de seguridad y requisitos de cumplimiento normativo.
Las reglas a nivel de sistema se cargan desde directorios específicos del sistema operativo:
**macOS:**
```
/Library/Application Support/Windsurf/rules/*.md
```
**Linux/WSL:**
```
/etc/windsurf/rules/*.md
```
**Windows:**
```
C:\ProgramData\Windsurf\rules\*.md
```
Coloca los archivos de reglas (como archivos `.md`) en el directorio correspondiente para tu sistema operativo. El sistema cargará automáticamente todos los archivos `.md` ubicados en esos directorios.
### Cómo funcionan las reglas de sistema
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.