Mémoires Cascade

Memories est le système qui permet de partager et de conserver le contexte d’une conversation à l’autre. Dans Devin Desktop, cela repose sur deux mécanismes : les Mémoires, générées automatiquement par Cascade, et les Règles, définies manuellement par l’utilisateur au niveau global, de l’espace de travail ou du système.

Mémoires, Règles, Workflows ou Skills ?

Devin Desktop propose plusieurs façons de personnaliser Cascade. Utilisez ce tableau pour choisir la plus adaptée :

Fonctionnalité	Ce qu’elle fait	Comment elle s’active	Quand l’utiliser
Règles	Indiquent à Cascade comment se comporter (p. ex. « utiliser bun, pas npm »)	`always_on`, `glob`, `model_decision` ou `manual` (voir ci-dessous)	Conventions de code, guides de style, contraintes du projet
AGENTS.md	Règles propres à un emplacement, sans configuration	Automatique — racine = always-on, sous-répertoire = glob	Conventions spécifiques à un répertoire sans frontmatter
Workflows	Modèles de prompt pour des tâches répétables en plusieurs étapes	Manuel uniquement via la slash command `/[workflow-name]`	Déploiements, revues de PR, checklists de publication
Skills	Procédures en plusieurs étapes regroupées avec des fichiers de support (scripts, modèles)	Invoqués dynamiquement par le modèle, ou via `@mention`	Tâches complexes où Cascade a besoin de fichiers de référence — privilégiez cette option
Mémoires	Contexte que Cascade génère automatiquement au fil des conversations	Récupération automatique lorsque pertinent	Laissez Cascade retenir des informations ponctuelles ; pour des connaissances durables, privilégiez règles ou AGENTS.md

Recommandation : Pour les connaissances que vous souhaitez que Cascade réutilise de manière fiable, rédigez-les sous forme de Règle ou ajoutez-les à AGENTS.md dans votre repo plutôt que de vous appuyer sur les mémoires générées automatiquement. Les règles sont versionnées, partageables avec votre Team, et vous donnent un contrôle explicite sur leur activation.

Comment gérer les mémoires

Les mémoires et les règles sont accessibles et peuvent être configurées à tout moment en cliquant sur l’icône Customizations dans le menu coulissant situé en haut à droite de Cascade, ou via « Devin - Settings » dans le coin inférieur droit. Pour modifier une mémoire existante, cliquez simplement dessus, puis sur le bouton Edit.

Mémoires

Au cours d’une conversation, Cascade peut générer et stocker automatiquement des mémoires s’il rencontre un contexte qu’il juge utile de retenir. Vous pouvez également demander à Cascade de créer une mémoire à tout moment. Il suffit de lui demander « create a memory of … ». Les mémoires générées automatiquement par Cascade sont associées à l’espace de travail dans lequel elles ont été créées et sont stockées localement dans ~/.codeium/windsurf/memories/. Cascade les récupère lorsqu’il estime qu’elles sont pertinentes. Les mémoires générées dans un espace de travail ne sont pas disponibles dans un autre et ne sont pas enregistrées dans votre repository.

La création et l’utilisation de mémoires générées automatiquement ne consomment PAS de crédits.

Les mémoires générées automatiquement n’existent que sur votre machine. Si vous voulez que Cascade se souvienne durablement de quelque chose — et le partage avec votre Team — demandez à Cascade de l’écrire plutôt dans une règle sous .devin/rules/ (ou l’ancien .windsurf/rules/) ou dans le fichier AGENTS.md de votre repo.

Règles

Les utilisateurs peuvent définir explicitement leurs propres règles à suivre par Cascade. Les règles peuvent être définies au niveau global, de l’espace de travail ou du système, et peuvent aussi être déduites des fichiers AGENTS.md.

Périmètre	Emplacement	Notes
Global	`~/.codeium/windsurf/memories/global_rules.md`	Fichier unique, appliqué à tous les espaces de travail. Toujours actif. Limité à 6 000 caractères.
Espace de travail	`.devin/rules/.md` (préféré) ou `.windsurf/rules/.md` (fallback)	Un fichier par règle, chacun avec son propre mode d’activation. Limité à 12 000 caractères par fichier. L’ancien fichier unique `.windsurfrules` à la racine de l’espace de travail est également toujours lu.
AGENTS.md	N’importe quel répertoire de votre espace de travail	Traité par le même moteur de règles — racine = toujours actif, sous-répertoire = auto-glob pour ce répertoire.
Système (Entreprise)	Propre à l’OS (p. ex. `/etc/devin/rules/`, ancien `/etc/windsurf/rules/`)	Déployé par l’IT, en lecture seule pour les utilisateurs finaux.

Découverte des règles

Devin Desktop découvre automatiquement les règles à partir de plusieurs emplacements pour permettre une organisation flexible. Le répertoire .devin/ est l’emplacement privilégié et a priorité, tandis que .windsurf/ est conservé comme solution de secours pour assurer la rétrocompatibilité :

Espace de travail actuel et sous-répertoires : tous les répertoires .devin/rules (et les anciens .windsurf/rules) de votre espace de travail actuel et de ses sous-répertoires
Structure du dépôt Git : pour les dépôts Git, Devin Desktop remonte également jusqu’à la racine du dépôt pour trouver des règles dans les répertoires parents
Prise en charge de plusieurs espaces de travail : lorsque plusieurs dossiers sont ouverts dans le même espace de travail, les doublons sont supprimés et les règles sont affichées avec le chemin relatif le plus court

Emplacements de stockage des règles

Les règles peuvent être stockées à l’un des emplacements suivants (.devin/ est préférable et prévaut sur .windsurf/) :

.devin/rules ou .windsurf/rules dans le répertoire de votre espace de travail actuel
.devin/rules ou .windsurf/rules dans n’importe quel sous-répertoire de votre espace de travail
.devin/rules ou .windsurf/rules dans les répertoires parents, jusqu’à la racine Git (pour les dépôts Git)

Lorsque vous créez une nouvelle règle, elle est enregistrée dans le répertoire .devin/rules de votre espace de travail actuel, pas nécessairement à la racine Git. Pour commencer à utiliser les règles, cliquez sur l’icône Customizations dans le menu latéral coulissant en haut à droite de Cascade, puis accédez au panneau Rules. Vous pouvez ensuite cliquer sur le bouton + Global ou + Workspace pour créer de nouvelles règles au niveau global ou au niveau de l’espace de travail, respectivement.

Vous trouverez des modèles de règles d’exemple sélectionnés par l’équipe Devin Desktop à l’adresse https://windsurf.com/editor/directory pour vous aider à démarrer.

Les fichiers de règles de l’espace de travail sont limités à 12 000 caractères chacun. Le fichier de règles global est limité à 6 000 caractères.

Modes d’activation

Chaque règle d’espace de travail déclare un mode d’activation dans son frontmatter via le champ trigger. Cela détermine quand le contenu de la règle est transmis à Cascade et quelle part de la fenêtre de contexte il consomme :

Mode	`trigger:` value	Comment elle parvient à Cascade	Coût en contexte
Toujours activé	`always_on`	L’intégralité du contenu de la règle est incluse dans le prompt système à chaque message.	Chaque message
Décision du modèle	`model_decision`	Seule la `description` apparaît dans le prompt système. Cascade lit le fichier complet de la règle lorsqu’il estime que la description est pertinente.	Description systématique ; contenu complet à la demande
Glob	`glob`	La règle s’applique lorsque Cascade lit ou modifie un fichier correspondant au motif `globs` (p. ex. `.js`, `src//.ts`).	Uniquement lorsque des fichiers correspondants sont concernés
Manuel	`manual`	La règle ne figure pas dans le prompt système. Vous l’activez en saisissant `@rule-name` dans le champ de saisie de Cascade.	Uniquement lorsqu’elle est @mentionnée

Le fichier de règles global (global_rules.md) et les fichiers AGENTS.md à la racine n’utilisent pas de frontmatter : ils sont toujours activés.

Exemple de règle d’espace de travail avec frontmatter :

---
trigger: glob
globs: **/*.test.ts
---

Tous les fichiers de test doivent utiliser des blocs `describe`/`it` et simuler les appels d'API externes.

Bonnes pratiques

Pour aider Cascade à suivre efficacement vos règles, appliquez les bonnes pratiques suivantes :

Veillez à ce que vos règles soient simples, concises et spécifiques. Des règles trop longues ou trop vagues peuvent perturber Cascade.
Il n’est pas nécessaire d’ajouter des règles génériques (p. ex. “écrire du bon code”), car elles sont déjà intégrées aux données d’entraînement de Cascade.
Présentez vos règles sous forme de puces, de listes numérotées et de markdown. Ces formats sont plus faciles à suivre pour Cascade qu’un long paragraphe. Par exemple :

# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes

Les balises XML peuvent être un moyen efficace pour formuler et regrouper des règles similaires. Par exemple :

<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>

Règles système (Enterprise)

Les organisations Enterprise peuvent déployer des règles système qui s’appliquent globalement à tous les espaces de travail et que les utilisateurs ne peuvent pas modifier sans les autorisations d’un administrateur. C’est idéal pour faire respecter des normes de codage à l’échelle de l’organisation, des politiques de sécurité et des exigences de conformité. Les règles système sont chargées depuis des répertoires spécifiques au système d’exploitation. Le répertoire Devin est privilégié et prévaut, tandis que l’ancien répertoire Windsurf est conservé comme solution de secours : macOS :

/Library/Application Support/Devin/rules/*.md
/Library/Application Support/Windsurf/rules/*.md   # ancien fallback

Linux/WSL :

/etc/devin/rules/*.md
/etc/windsurf/rules/*.md   # ancien fallback

Windows :

C:\ProgramData\Devin\rules\*.md
C:\ProgramData\Windsurf\rules\*.md   # ancien fallback

Placez vos fichiers de règles (au format .md) dans le répertoire approprié pour votre système d’exploitation. Le système chargera automatiquement tous les fichiers .md présents dans ces répertoires.

Fonctionnement des règles système

Les règles système sont fusionnées avec les règles de l’espace de travail et les règles globales, afin de fournir un contexte supplémentaire à Cascade sans remplacer les règles définies par l’utilisateur. Cela permet aux organizations d’établir des standards de référence tout en laissant aux équipes la possibilité d’ajouter des personnalisations propres au projet. Dans l’interface de Devin Desktop, les règles système apparaissent avec le libellé “System” et ne peuvent pas être supprimées par les utilisateurs finaux.

Important : les règles système doivent être gérées par votre équipe informatique ou sécurité. Assurez-vous que vos équipes internes prennent en charge le déploiement, les mises à jour et la conformité conformément aux politiques de votre organization. Vous pouvez utiliser des outils et workflows standard comme la gestion des appareils mobiles (MDM) ou la gestion de la configuration à cet effet.

Devin Desktop

Centre de commande des agents

Versions

Plugins Windsurf

Comptes

Sécurité

Mémoires & règles

Mémoires, Règles, Workflows ou Skills ?

Comment gérer les mémoires

Mémoires

Règles

Découverte des règles

Emplacements de stockage des règles

Modes d’activation

Bonnes pratiques

Règles système (Enterprise)

Fonctionnement des règles système

​Mémoires, Règles, Workflows ou Skills ?

​Comment gérer les mémoires

​Mémoires

​Règles

​Découverte des règles

​Emplacements de stockage des règles

​Modes d’activation

​Bonnes pratiques

​Règles système (Enterprise)

​Fonctionnement des règles système

Mémoires, Règles, Workflows ou Skills ?

Comment gérer les mémoires

Mémoires

Règles

Découverte des règles

Emplacements de stockage des règles

Modes d’activation

Bonnes pratiques

Règles système (Enterprise)

Fonctionnement des règles système