Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Memories es el sistema para compartir y mantener el contexto entre conversaciones. En Devin Desktop, hay dos mecanismos para ello: Memorias, que Cascade genera automáticamente, y Rules, que el usuario define manualmente a nivel global, de espacio de trabajo o de sistema.

​
¿Memorias, Rules, Workflows o Skills?

Devin Desktop ofrece varias formas de personalizar Cascade. Usa esta tabla para elegir la opción adecuada:
FunciónQué haceCómo se activaCuándo usarla
RulesLe indican a Cascade cómo debe comportarse (p. ej., “usa bun, no npm”)always_on, glob, model_decision o manual (ver más abajo)Convenciones de código, guías de estilo, restricciones del proyecto
AGENTS.mdRules con ámbito por ubicación y sin configuraciónAutomática — raíz = activo, subdirectorio = globConvenciones específicas de directorio sin frontmatter
WorkflowsPlantillas de prompts para tareas repetibles de varios pasosSolo Manual mediante el comando de barra diagonal /[workflow-name]Despliegues, revisiones de PR, listas de comprobación de lanzamientos
SkillsProcedimientos de varios pasos agrupados con archivos de apoyo (scripts, plantillas)Invocadas dinámicamente por el modelo o mediante @mentionTareas complejas en las que Cascade necesita archivos de referencia — empieza por aquí
MemoriasContexto que Cascade genera automáticamente durante las conversacionesRecuperación automática cuando es relevanteDeja que Cascade recuerde datos puntuales; para conocimiento persistente, 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 agrégalo a AGENTS.md en tu repo en lugar de depender de memorias 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 las memorias

Puedes acceder a las memorias y a Rules, y configurarlas en cualquier momento, haciendo clic en el icono Customizations del menú deslizante de la esquina superior derecha de Cascade, o desde “Windsurf - Settings” en la esquina inferior derecha. Para editar una memoria existente, simplemente haz clic en ella y luego en el botón Edit.

​
Memorias

Durante una conversación, Cascade puede generar y almacenar memorias automáticamente si encuentra contexto que considera útil recordar. Además, puedes pedirle a Cascade que cree una memoria en cualquier momento. Solo dile a Cascade: “crea una memoria sobre …”. Las memorias generadas automáticamente por Cascade se asocian con el espacio de trabajo en el que se crearon y se almacenan localmente en ~/.codeium/windsurf/memories/. Cascade las recupera cuando considera que son relevantes. Las memorias generadas en un espacio de trabajo no están disponibles en otro, y no se incluyen en los commits de tu repositorio.
Crear y usar memorias generadas automáticamente NO consume créditos.
Las memorias generadas automáticamente 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 archivo AGENTS.md de tu repo.

​
Rules

Los usuarios pueden definir explícitamente sus propias reglas para que Cascade las cumpla. Las Rules se pueden definir a nivel global, del workspace o del sistema, y también se pueden inferir a partir de archivos AGENTS.md.
ÁmbitoUbicaciónNotas
Global~/.codeium/windsurf/memories/global_rules.mdUn solo archivo; se aplica a todos los workspaces. Siempre activo. Limitado a 6.000 caracteres.
Workspace.windsurf/rules/*.mdUn archivo por regla, cada uno con su propio modo de activación. Limitado a 12.000 caracteres por archivo.
AGENTS.mdCualquier directorio de tu workspaceSe procesa con el mismo motor de Rules: raíz = siempre activo; subdirectorio = auto-glob para ese directorio.
Sistema (Enterprise)Específico del sistema operativo (p. ej., /etc/windsurf/rules/)Lo implementa TI; es de solo lectura para los usuarios finales.

​
Detección de Rules

Devin Desktop detecta automáticamente Rules en múltiples ubicaciones para ofrecer una organización flexible:
  • Espacio de trabajo actual y subdirectorios: Todos los directorios .windsurf/rules dentro de tu espacio de trabajo actual y sus subdirectorios
  • Estructura del repositorio Git: En los repositorios Git, Devin Desktop también busca hasta el directorio raíz de Git para encontrar Rules en los directorios superiores
  • Compatibilidad con múltiples espacios de trabajo: Cuando hay varias carpetas abiertas en el mismo espacio de trabajo, las Rules se deduplican y se muestran con la ruta relativa más corta

​
Ubicaciones de almacenamiento de Rules

Las Rules pueden almacenarse en cualquiera de estas ubicaciones:
  • .windsurf/rules en el directorio actual de tu espacio de trabajo
  • .windsurf/rules en cualquier subdirectorio de tu espacio de trabajo
  • .windsurf/rules en directorios superiores hasta la raíz del repositorio Git (para repositorios Git)
Cuando crees una nueva regla, se guardará en el directorio .windsurf/rules de tu espacio de trabajo actual, no necesariamente en la raíz del repositorio Git. Para empezar a usar Rules, haz clic en el icono Customizations del menú lateral deslizante de la esquina superior derecha en Cascade y, a continuación, ve al panel Rules. Allí, puedes hacer clic en el botón + Global o + Workspace para crear nuevas reglas a nivel global o del espacio de trabajo, respectivamente.
Puedes encontrar plantillas de reglas de ejemplo seleccionadas por el equipo de Devin Desktop en https://windsurf.com/editor/directory para ayudarte a empezar.
Los archivos de reglas del espacio de trabajo están limitados a 12.000 caracteres cada uno. El archivo de reglas globales está limitado a 6.000 caracteres.

​
Modos de activación

Cada regla del espacio de trabajo declara un modo de activación en su frontmatter mediante el campo trigger. Esto determina cuándo se proporciona el contenido de la regla a Cascade y cuánta ventana de contexto consume:
ModoValor de trigger:Cómo llega a CascadeCosto de contexto
Siempre activaalways_onEl contenido completo de la regla se incluye en el prompt del sistema en cada mensaje.En cada mensaje
Decisión del modelomodel_decisionSolo se muestra la description en el prompt del sistema. Cascade lee el archivo completo de la regla cuando decide que la descripción es relevante.La descripción siempre; contenido completo bajo demanda
GlobglobLa 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 tocan archivos coincidentes
ManualmanualLa regla no está en el prompt del sistema. Se activa escribiendo @rule-name en el cuadro de entrada de Cascade.Solo cuando se menciona con @
El archivo de reglas globales (global_rules.md) y los archivos AGENTS.md del directorio raíz no usan frontmatter: siempre están activos.
Ejemplo de una regla del espacio de trabajo con frontmatter: 
---
trigger: glob
globs: **/*.test.ts
---

Todos los archivos de prueba deben usar bloques `describe`/`it` y simular las API calls externas.

​
Mejores prácticas

Para ayudar a Cascade a seguir tus reglas de forma eficaz, 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 agregar reglas genéricas (p. ej., “escribe buen código”), ya que ya están integradas en los datos de entrenamiento de Cascade.
  • Organiza tus reglas con viñetas, listas numeradas y markdown. A Cascade le resulta más fácil seguir este formato que un párrafo largo. Por ejemplo:
# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
  • Las etiquetas XML pueden ser una forma eficaz de expresar y agrupar reglas similares. Por ejemplo:
<coding_guidelines>
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
</coding_guidelines>

​
Rules a nivel del sistema (Enterprise)

Las organizaciones Enterprise pueden implementar Rules a nivel del sistema que se aplican globalmente en todos los espacios de trabajo y que los usuarios finales no pueden modificar sin permisos de administrador. Esto es ideal para hacer cumplir estándares de codificación, políticas de seguridad y requisitos de cumplimiento en toda la organización. Las Rules a nivel del 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 tus archivos de reglas (como archivos .md) en el directorio correspondiente según tu sistema operativo. El sistema cargará automáticamente todos los archivos .md de estos directorios.

​
Cómo funcionan las Rules del sistema

Las Rules del sistema se combinan con las Rules del espacio de trabajo y las globales, lo que aporta contexto adicional a Cascade sin sobrescribir las Rules definidas por el usuario. Esto permite a las organizaciones establecer estándares de referencia y, al mismo tiempo, permite a los equipos agregar personalizaciones específicas de cada proyecto. En la interfaz de Devin Desktop, las Rules del sistema se muestran con la etiqueta “System” y los usuarios finales no pueden eliminarlas.
Importante: Las Rules del sistema deben ser gestionadas por tu equipo de TI o de seguridad. Asegúrate de que tus equipos internos se encarguen del despliegue, las actualizaciones y el cumplimiento de acuerdo con las políticas de tu organización. Para ello, puedes usar herramientas y flujos de trabajo estándar, como Mobile Device Management (MDM) o Configuration Management.