Skip to main content
Memories est le système qui permet de partager et de conserver le contexte entre les conversations. Windsurf propose deux mécanismes à cet effet : Memories, qui sont générées automatiquement par Cascade, et règles, qui sont définies manuellement par l’utilisateur au niveau global, workspace ou système.

​
Memories, règles, Workflows ou Skills ?

Windsurf propose plusieurs façons de personnaliser Cascade. Utilisez ce tableau pour choisir la bonne :
Recommandation : Pour les connaissances que vous voulez que Cascade réutilise de manière fiable, consignez-les sous forme de règle ou ajoutez-les à AGENTS.md dans votre dépôt plutôt que de vous appuyer sur des Memories générées automatiquement. Les règles sont versionnées, partageables avec votre équipe et vous donnent un contrôle explicite sur leur activation.

​
Comment gérer les Memories

Les Memories et les Rules sont accessibles et configurables à tout moment en cliquant sur l’icône Customisations dans le menu latéral en haut à droite de Cascade, ou via “Windsurf - Settings” dans le coin inférieur droit. Pour modifier une Memory existante, cliquez simplement dessus puis sur le bouton Edit.

​
Memories

Au cours d’une conversation, Cascade peut générer et stocker automatiquement des Memories lorsqu’il rencontre un contexte qu’il juge utile de conserver. Vous pouvez également demander à tout moment à Cascade de créer une Memory. Il suffit de lui demander de « créer une Memory de … ». Les Memories générées automatiquement par Cascade sont associées au workspace 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 Memories générées dans un workspace ne sont pas disponibles dans un autre, et elles ne sont pas versionnées dans votre dépôt.
La création et l’utilisation de Memories générées automatiquement ne consomment PAS de crédits.
Les Memories générées automatiquement n’existent que sur votre machine. Si vous voulez que Cascade se souvienne durablement de quelque chose — et le partager avec votre équipe — demandez à Cascade de l’écrire plutôt dans une règle sous .windsurf/rules/ ou dans le fichier AGENTS.md de votre dépôt.

​
Règles

Les utilisateurs peuvent définir explicitement leurs propres règles que Cascade doit suivre. Les règles peuvent être définies au niveau global, du workspace ou du système. Elles peuvent également être déduites des fichiers AGENTS.md.

​
Découverte des règles

Windsurf découvre automatiquement des règles à partir de plusieurs emplacements pour offrir une organisation flexible :
  • Workspace actuel et sous-répertoires : Tous les répertoires .windsurf/rules au sein de votre workspace actuel et de ses sous-répertoires
  • Structure du dépôt Git : Pour les dépôts Git, Windsurf recherche également jusqu’à la racine du dépôt afin de trouver des règles dans les répertoires parents
  • Prise en charge de plusieurs workspaces : Lorsque plusieurs dossiers sont ouverts dans le même workspace, les règles sont dédupliquées et affichées avec le chemin relatif le plus court

​
Emplacements de stockage des règles

Les règles peuvent être stockées dans l’un de ces emplacements :
  • .windsurf/rules dans le répertoire de votre workspace actuel
  • .windsurf/rules dans n’importe quel sous-répertoire de votre workspace
  • .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 .windsurf/rules de votre workspace actuel, pas nécessairement à la racine Git. Pour commencer avec les règles, cliquez sur l’icône Customizations dans le menu coulissant en haut à droite de Cascade, puis accédez au panneau Rules. Là, vous pouvez cliquer sur le bouton + Global ou + Workspace pour créer de nouvelles règles au niveau global ou au niveau du workspace, respectivement.
Vous pouvez trouver des modèles de règles d’exemple sélectionnés par l’équipe Windsurf à l’adresse https://windsurf.com/editor/directory pour vous aider à démarrer.
Les fichiers de règles de workspace sont limités à 12 000 caractères chacun. Le fichier de règle global est limité à 6 000 caractères.

​
Modes d’activation

Chaque règle de workspace 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 utilise :
Le fichier de règles global (global_rules.md) et les fichiers AGENTS.md à la racine n’utilisent pas de frontmatter — ils sont toujours actifs.
Exemple de règle de workspace avec frontmatter :

​
Bonnes pratiques

Pour aider Cascade à appliquer efficacement vos règles, suivez ces bonnes pratiques :
  • Gardez des règles simples, concises et précises. Des règles trop longues ou vagues peuvent dérouter Cascade.
  • Inutile d’ajouter des règles génériques (p. ex. « write good code »), car elles sont déjà intégrées aux données d’entraînement de Cascade.
  • Formatez vos règles avec des listes à puces, des listes numérotées et du Markdown. Elles sont plus faciles à suivre pour Cascade qu’un long paragraphe. Par exemple :
  • Les balises XML sont un moyen efficace de communiquer et de regrouper des règles similaires. Par exemple :

​
Règles système (Enterprise)

Les organisations Enterprise peuvent déployer des règles système qui s’appliquent globalement à tous les workspaces et ne peuvent pas être modifiées par les utilisateurs finaux sans droits d’administrateur. C’est idéal pour faire respecter, à l’échelle de l’organisation, les normes de codage, les politiques de sécurité et les exigences de conformité. Les règles système sont chargées depuis des répertoires spécifiques au système d’exploitation : macOS :
Linux/WSL :
Windows :
Placez vos fichiers de règles (au format .md) dans le répertoire approprié à 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 au niveau du système sont combinées avec les règles de workspace et les règles globales, ce qui fournit un contexte supplémentaire à Cascade sans remplacer les règles définies par les utilisateurs. Cela permet aux organisations de définir des normes de base tout en laissant les équipes ajouter des personnalisations spécifiques à leurs projets. Dans l’interface Windsurf, les règles au niveau du système sont affichées avec le libellé « System » et ne peuvent pas être supprimées par les utilisateurs finaux.
Important : Les règles au niveau du système doivent être gérées par votre équipe informatique ou de sécurité. Assurez-vous que vos équipes internes gèrent le déploiement, les mises à jour et la conformité conformément aux politiques de votre organisation. Vous pouvez utiliser des outils et des flux de travail standard tels que la gestion des appareils mobiles (MDM) ou la gestion de la configuration pour ce faire.