> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mémoires & règles

> Conservez le contexte d’une conversation Cascade à l’autre grâce à des mémoires générées automatiquement et à des règles définies par l’utilisateur aux niveaux global, de l’espace de travail et du système pour les équipes d’entreprise.

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

<div id="memories-rules-workflows-or-skills">
  ## Mémoires, Règles, Workflows ou Skills ?
</div>

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](#rules)**                           | Indiquent à Cascade *comment se comporter* (p. ex. « utiliser bun, pas npm »)             | `always_on`, `glob`, `model_decision` ou `manual` ([voir ci-dessous](#activation-modes)) | Conventions de code, guides de style, contraintes du projet                                                             |
| **[AGENTS.md](/fr/desktop/cascade/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](/fr/desktop/cascade/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](/fr/desktop/cascade/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](#memories)**                      | 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 |

<Tip>
  **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.
</Tip>

<div id="how-to-manage-memories">
  ## Comment gérer les mémoires
</div>

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

<video autoPlay controls muted loop playsInline className="aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/memories-rules.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=f264942bd2e40966555454624f1958b4" data-path="desktop/assets/windsurf/cascade/memories-rules.mp4" />

<div id="memories">
  ## Mémoires
</div>

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.

<Tip>La création et l'utilisation de mémoires générées automatiquement ne consomment PAS de crédits.</Tip>

<Note>
  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](#rules) sous `.devin/rules/` (ou l’ancien `.windsurf/rules/`) ou dans le fichier `AGENTS.md` de votre repo.
</Note>

<div id="rules">
  ## Règles
</div>

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](/fr/desktop/cascade/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](#activation-modes). 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](/fr/desktop/cascade/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)](#system-level-rules-enterprise) | Propre à l’OS (p. ex. `/etc/devin/rules/`, ancien `/etc/windsurf/rules/`) | Déployé par l’IT, en lecture seule pour les utilisateurs finaux.                                                                                                                                                                    |

<div id="rules-discovery">
  ## Découverte des règles
</div>

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

<div id="rules-storage-locations">
  ### Emplacements de stockage des règles
</div>

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.

<Tip>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](https://windsurf.com/editor/directory) pour vous aider à démarrer.</Tip>

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.

<div id="activation-modes">
  ### Modes d’activation
</div>

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                        |

<Note>
  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.
</Note>

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

```markdown theme={null}
---
trigger: glob
globs: **/*.test.ts
---

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

<div id="best-practices">
  ### Bonnes pratiques
</div>

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

<div id="system-level-rules-enterprise">
  ## Règles système (Enterprise)
</div>

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.

<div id="how-system-rules-work">
  ### Fonctionnement des règles système
</div>

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.

<Note>
  **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.
</Note>