Passer au contenu principal
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 :
FonctionnalitéCe qu’elle faitComment elle est activéeQuand l’utiliser
RèglesIndique à Cascade comment se comporter (par 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.mdRègles limitées à un emplacement, sans configurationAutomatique — racine = toujours actif, sous-répertoire = globConventions propres à un répertoire, sans frontmatter
WorkflowsModèles de prompt pour des tâches répétables en plusieurs étapesManuel uniquement via la commande slash /[workflow-name]Déploiements, revues de PR, checklists de release
SkillsProcédures en plusieurs étapes regroupées avec des fichiers de support (scripts, modèles)Appelées dynamiquement par le modèle, ou via @mentionTâches complexes où Cascade a besoin de fichiers de référence — investissez ici
MemoriesContexte que Cascade génère automatiquement au fil des conversationsRécupération automatique lorsque c’est pertinentLaissez Cascade se souvenir de faits ponctuels ; pour des connaissances durables, privilégiez les règles ou AGENTS.md
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.
PortéeEmplacementRemarques
Globale~/.codeium/windsurf/memories/global_rules.mdFichier unique, appliqué à tous les workspaces. Toujours activé. Limité à 6 000 caractères.
Workspace.windsurf/rules/*.mdUn fichier par règle, chacun avec son propre mode d’activation. Limité à 12 000 caractères par fichier.
AGENTS.mdN’importe quel répertoire de votre workspaceTraité par le même moteur de règles — niveau racine = toujours activé, sous-répertoire = auto-glob pour ce répertoire.
Système (Enterprise)Spécifique au système d’exploitation (par ex. /etc/windsurf/rules/)Déployé par l’équipe informatique, en lecture seule pour les utilisateurs finaux.

​
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 :
ModeValeur trigger:Comment elle parvient à CascadeCoût en contexte
Toujours actifalways_onLe contenu complet de la règle est inclus dans le prompt système à chaque message.Chaque message
Décision du modèle d’IAmodel_decisionSeule la description est affichée dans le prompt système. Cascade lit le fichier de règle complet lorsqu’il juge la description pertinente.Description toujours ; contenu complet à la demande
GlobglobLa règle est appliquée lorsque Cascade lit ou modifie un fichier correspondant au motif globs (par ex. *.js, src/**/*.ts).Uniquement lorsque des fichiers correspondants sont concernés
ManuelmanualLa règle n’est 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 actifs.
Exemple de règle de workspace avec frontmatter : 
---
trigger: glob
globs: **/*.test.ts
---

All test files must use `describe`/`it` blocks and mock external API calls.

​
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 :
# Directives de codage 
- Le langage de programmation de mon projet est Python
- Utiliser les retours anticipés lorsque c'est possible
- Toujours ajouter de la documentation lors de la création de nouvelles fonctions et classes
  • Les balises XML sont un moyen efficace de communiquer et de regrouper des règles similaires. Par exemple :
<coding_guidelines>
- Le langage de programmation de mon projet est Python
- Utilisez des retours anticipés lorsque c'est possible
- Ajoutez toujours de la documentation lors de la création de nouvelles fonctions et 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 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 : 
/Library/Application Support/Windsurf/rules/*.md
Linux/WSL : 
/etc/windsurf/rules/*.md
Windows : 
C:\ProgramData\Windsurf\rules\*.md
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.