Passer au contenu principal

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.

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 faitComment elle s’activeQuand l’utiliser
RèglesIndiquent à 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.mdRègles propres à un emplacement, sans configurationAutomatique — racine = always-on, sous-répertoire = globConventions spécifiques à un répertoire sans frontmatter
WorkflowsModèles de prompt pour des tâches répétables en plusieurs étapesManuel uniquement via la slash command /[workflow-name]Déploiements, revues de PR, checklists de publication
SkillsProcédures en plusieurs étapes regroupées avec des fichiers de support (scripts, modèles)Invoqués dynamiquement par le modèle, ou via @mentionTâches complexes où Cascade a besoin de fichiers de référence — privilégiez cette option
MémoiresContexte que Cascade génère automatiquement au fil des conversationsRécupération automatique lorsque pertinentLaissez 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 « Windsurf - 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ètreEmplacementNotes
Global~/.codeium/windsurf/memories/global_rules.mdFichier 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.mdN’importe quel répertoire de votre espace de travailTraité 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 :
Modetrigger: valueComment elle parvient à CascadeCoût en contexte
Toujours activéalways_onL’intégralité du contenu de la règle est incluse dans le prompt système à chaque message.Chaque message
Décision du modèlemodel_decisionSeule 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
GlobglobLa 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
ManuelmanualLa 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.