Zum Hauptinhalt springen

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 ist das System, mit dem Kontext über Unterhaltungen hinweg geteilt und dauerhaft gespeichert wird. In Devin Desktop gibt es dafür zwei Mechanismen: Memories, die von Cascade automatisch generiert werden, und Rules, die vom Nutzer manuell auf globaler, Workspace- oder Systemebene definiert werden.

​
Memories, Rules, Workflows oder Skills?

Devin Desktop bietet mehrere Möglichkeiten, Cascade anzupassen. Nutze diese Tabelle, um die passende auszuwählen:
FeatureWas es tutWie es aktiviert wirdWann du es verwenden solltest
RulesGeben Cascade vor, wie es sich verhalten soll (z. B. „verwende bun statt npm“)always_on, glob, model_decision oder manual (siehe unten)Coding-Conventions, Styleguides, Projektvorgaben
AGENTS.mdRegeln mit Verzeichnisbezug, ganz ohne KonfigurationAutomatisch — Root = immer aktiv, Unterverzeichnis = globVerzeichnisspezifische Konventionen ohne frontmatter
WorkflowsPrompt-Vorlagen für wiederkehrende mehrstufige AufgabenNur manuell über den /[workflow-name] Slash CommandDeployments, PR-Reviews, Release-Checklisten
SkillsMehrstufige Anleitungen, gebündelt mit unterstützenden Dateien (Skripte, Vorlagen)Vom Modell dynamisch aufgerufen oder per @mentionKomplexe Aufgaben, bei denen Cascade Referenzdateien benötigt — hier lohnt es sich zu investieren
MemoriesKontext, den Cascade in Unterhaltungen automatisch generiertAutomatischer Abruf, wenn relevantLass Cascade sich einmalige Fakten merken; für dauerhaftes Wissen solltest du Rules oder AGENTS.md bevorzugen
Empfehlung: Für Wissen, das Cascade zuverlässig wiederverwenden soll, schreibe es als Rule oder füge es in deinem Repo zu AGENTS.md hinzu, statt dich auf automatisch generierte Memories zu verlassen. Rules sind versionskontrolliert, im Team teilbar und geben dir explizite Kontrolle über die Aktivierung.

​
So verwalten Sie Memories

Auf Memories und Rules können Sie jederzeit zugreifen und sie konfigurieren, indem Sie in Cascade im Schiebemenü oben rechts auf das Symbol Customizations klicken oder unten rechts „Windsurf - Settings“ auswählen. Um eine vorhandene Memory zu bearbeiten, klicken Sie einfach darauf und dann auf die Schaltfläche Edit.

​
Memory

Während der Unterhaltung kann Cascade automatisch Memory erstellen und speichern, wenn es auf Kontext stößt, den es für später nützlich hält. Außerdem kannst du Cascade jederzeit bitten, eine Memory zu erstellen. Gib Cascade dazu einfach den Prompt „Erstelle eine Memory zu …“. Die von Cascade automatisch erstellten Memory sind dem Workspace zugeordnet, in dem sie erstellt wurden, und werden lokal in ~/.codeium/windsurf/memories/ gespeichert. Cascade ruft sie ab, wenn es sie für relevant hält. Memory, die in einem Workspace erstellt wurden, sind in einem anderen nicht verfügbar und werden nicht in deinem Repository committet.
Das Erstellen und Verwenden automatisch generierter Memory verbraucht KEINE Credits.
Automatisch generierte Memory existieren nur auf deinem Rechner. Wenn du möchtest, dass Cascade sich dauerhaft an etwas erinnert — und es mit deinem Team teilt — bitte Cascade stattdessen, es in eine Rule in .devin/rules/ (oder das legacy .windsurf/rules/) oder in die AGENTS.md deines Repo zu schreiben.

​
Rules

Nutzer können eigene Rules explizit definieren, denen Cascade folgen soll. Rules können auf globaler, Workspace- oder Systemebene definiert und auch aus AGENTS.md-Dateien abgeleitet werden.
GeltungsbereichSpeicherortHinweise
Global~/.codeium/windsurf/memories/global_rules.mdEinzelne Datei, die für alle Workspaces gilt. Immer aktiv. Auf 6.000 Zeichen begrenzt.
Workspace.devin/rules/*.md (bevorzugt) oder .windsurf/rules/*.md (Fallback)Eine Datei pro Rule, jeweils mit eigenem Aktivierungsmodus. Auf 12.000 Zeichen pro Datei begrenzt. Die Legacy-Einzeldatei .windsurfrules im Workspace-Stammverzeichnis wird ebenfalls weiterhin gelesen.
AGENTS.mdBeliebiges Verzeichnis in Ihrem WorkspaceWird von derselben Rules-Engine verarbeitet — auf Root-Ebene = immer aktiv, in Unterverzeichnissen = automatisches Glob für dieses Verzeichnis.
System (Enterprise)Betriebssystemspezifisch (z. B. /etc/devin/rules/, Legacy /etc/windsurf/rules/)Wird von der IT bereitgestellt, für Endnutzer schreibgeschützt.

​
Auffinden von Rules

Devin Desktop findet Rules automatisch an mehreren Speicherorten, um eine flexible Organisation zu ermöglichen. Das Verzeichnis .devin/ ist der bevorzugte Speicherort und hat Vorrang, wobei .windsurf/ aus Gründen der Abwärtskompatibilität als Fallback beibehalten wird:
  • Aktueller Workspace und Unterverzeichnisse: Alle .devin/rules-Verzeichnisse (und veralteten .windsurf/rules-Verzeichnisse) in Ihrem aktuellen Workspace und dessen Unterverzeichnissen
  • Git-Repository-Struktur: In Git-Repositories sucht Devin Desktop außerdem bis zum Git-Root-Verzeichnis nach oben, um Rules in übergeordneten Verzeichnissen zu finden
  • Unterstützung für mehrere Workspaces: Wenn mehrere Ordner im selben Workspace geöffnet sind, werden Rules dedupliziert und mit dem kürzesten relativen Pfad angezeigt

​
Speicherorte für Rules

Rules können an jedem dieser Orte gespeichert werden (.devin/ wird bevorzugt und hat Vorrang vor .windsurf/):
  • .devin/rules oder .windsurf/rules im Verzeichnis Ihres aktuellen Workspace
  • .devin/rules oder .windsurf/rules in einem beliebigen Unterverzeichnis Ihres Workspace
  • .devin/rules oder .windsurf/rules in übergeordneten Verzeichnissen bis zum Git-Root (für Git-Repositories)
Wenn Sie eine neue Regel erstellen, wird sie im Verzeichnis .devin/rules Ihres aktuellen Workspace gespeichert, nicht unbedingt am Git-Root. Um mit Rules zu beginnen, klicken Sie im Ausklappmenü oben rechts in Cascade auf das Symbol Customizations und wechseln Sie dann zum Bereich Rules. Dort können Sie auf die Schaltfläche + Global oder + Workspace klicken, um jeweils neue Rules auf globaler Ebene oder auf Workspace-Ebene zu erstellen.
Beispielvorlagen für Rules, zusammengestellt vom Devin-Desktop-Team, finden Sie unter https://windsurf.com/editor/directory, um den Einstieg zu erleichtern.
Workspace-Regeldateien sind jeweils auf 12.000 Zeichen begrenzt. Die globale Rules-Datei ist auf 6.000 Zeichen begrenzt.

​
Aktivierungsmodi

Jede Workspace-Regel deklariert in ihrem Frontmatter über das Feld trigger einen Aktivierungsmodus. Dieser legt fest, wann der Inhalt der Regel an Cascade übergeben wird und wie viel Platz im Kontextfenster er belegt:
Modustrigger:-WertWie die Regel zu Cascade gelangtKontextkosten
Immer aktivalways_onDer vollständige Regelinhalt wird bei jeder Nachricht in den System-Prompt aufgenommen.Jede Nachricht
Modellentscheidungmodel_decisionIm System-Prompt wird nur die description angezeigt. Cascade liest die vollständige Regeldatei, wenn es entscheidet, dass die Beschreibung relevant ist.Beschreibung immer; vollständiger Inhalt bei Bedarf
GlobglobDie Regel wird angewendet, wenn Cascade eine Datei liest oder bearbeitet, die dem globs-Muster entspricht (z. B. *.js, src/**/*.ts).Nur wenn passende Dateien betroffen sind
ManuellmanualDie Regel ist nicht im System-Prompt enthalten. Sie wird aktiviert, indem @rule-name in das Cascade-Eingabefeld eingegeben wird.Nur bei @Erwähnung
Die globale Regeldatei (global_rules.md) und AGENTS.md-Dateien auf Root-Ebene verwenden kein Frontmatter — sie sind immer aktiv.
Beispiel für eine Workspace-Regel mit Frontmatter: 
---
trigger: glob
globs: **/*.test.ts
---

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

​
Bewährte Vorgehensweisen

Damit Cascade Ihre Regeln zuverlässig befolgt, beachten Sie diese Best Practices:
  • Halten Sie Regeln einfach, prägnant und spezifisch. Zu lange oder zu vage Regeln können Cascade verwirren.
  • Es ist nicht nötig, allgemeine Regeln hinzuzufügen (z. B. “guten Code schreiben”), da diese bereits in Cascades Trainingsdaten enthalten sind.
  • Formatieren Sie Ihre Regeln mit Aufzählungspunkten, nummerierten Listen und Markdown. Diese kann Cascade leichter befolgen als einen langen Absatz. Zum Beispiel:
# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
  • XML-Tags können eine effektive Möglichkeit sein, ähnliche Regeln zu kommunizieren und zusammenzufassen. Zum Beispiel:
<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>

​
Rules auf Systemebene (Enterprise)

Enterprise-Organisationen können Rules auf Systemebene festlegen, die global für alle Workspaces gelten und von Nutzern ohne Administratorberechtigungen nicht geändert werden können. Das ist ideal, um organisationsweite Programmierstandards, Sicherheitsrichtlinien und Compliance-Anforderungen durchzusetzen. Rules auf Systemebene werden aus betriebssystemspezifischen Verzeichnissen geladen. Das Verzeichnis Devin wird bevorzugt und hat Vorrang, während das Legacy-Verzeichnis Windsurf als Fallback beibehalten wird: macOS: 
/Library/Application Support/Devin/rules/*.md
/Library/Application Support/Windsurf/rules/*.md   # legacy fallback
Linux/WSL: 
/etc/devin/rules/*.md
/etc/windsurf/rules/*.md   # legacy Fallback
Windows: 
C:\ProgramData\Devin\rules\*.md
C:\ProgramData\Windsurf\rules\*.md   # legacy Fallback
Legen Sie Ihre Regeldateien (als .md-Dateien) im passenden Verzeichnis für Ihr Betriebssystem ab. Das System lädt automatisch alle .md-Dateien aus diesen Verzeichnissen.

​
Wie Regeln auf Systemebene funktionieren

Regeln auf Systemebene werden mit Workspace- und globalen Regeln zusammengeführt und liefern Cascade zusätzlichen Kontext, ohne von Nutzern definierte Regeln zu überschreiben. Dadurch können Organisationen grundlegende Standards festlegen und Teams gleichzeitig projektspezifische Anpassungen hinzufügen. In der Devin Desktop UI werden Regeln auf Systemebene mit dem Label „System“ angezeigt und können von Endnutzern nicht gelöscht werden.
Wichtig: Regeln auf Systemebene sollten von Ihrem IT- oder Sicherheitsteam verwaltet werden. Stellen Sie sicher, dass Ihre internen Teams Bereitstellung, Aktualisierungen und die Einhaltung von Richtlinien gemäß den Vorgaben Ihrer Organisation übernehmen. Dazu können Sie Standard-Tools und -Workflows wie Mobile Device Management (MDM) oder Configuration Management verwenden.