Zum Hauptinhalt springen
Memories ist das System zum Teilen und dauerhaften Speichern von Kontext über Gespräche hinweg. In Windsurf gibt es dafür zwei Mechanismen: Memories, die automatisch von Cascade erzeugt werden, und Regeln, die vom Benutzer auf globaler Ebene, Workspace-Ebene oder Systemebene manuell definiert werden.

​
Memories, Regeln, Workflows oder Skills?

Windsurf bietet mehrere Möglichkeiten, Cascade anzupassen. Verwenden Sie diese Tabelle, um die richtige Option auszuwählen:
FeatureWas es machtWie es aktiviert wirdWann Sie es verwenden sollten
RulesGeben Cascade vor, wie es sich verhalten soll (z. B. „bun statt npm verwenden“)always_on, glob, model_decision oder manual (siehe unten)Coding-Konventionen, Styleguides, Projektvorgaben
AGENTS.mdVerzeichnisbezogene Regeln ohne KonfigurationsaufwandAutomatisch — root = immer aktiv, Unterverzeichnis = globVerzeichnisspezifische Konventionen ohne Frontmatter
WorkflowsPrompt-Vorlagen für wiederkehrende mehrstufige AufgabenNur manuell über den Slash-Befehl /[workflow-name]Deployments, PR-Reviews, Release-Checklisten
SkillsMehrstufige Abläufe, gebündelt mit unterstützenden Dateien (Skripte, Vorlagen)Dynamisch durch das Modell aufgerufen oder per @mentionKomplexe Aufgaben, bei denen Cascade Referenzdateien benötigt — hier lohnt es sich, Zeit zu investieren
MemoriesKontext, den Cascade während Unterhaltungen automatisch generiertAutomatischer Abruf, wenn relevantLassen Sie Cascade einmalige Fakten speichern; für dauerhaftes Wissen sind Regeln oder AGENTS.md besser geeignet
Empfehlung: Für Wissen, das Cascade zuverlässig wiederverwenden soll, schreiben Sie es als Regel oder fügen Sie es in Ihrem Repository zu AGENTS.md hinzu, statt sich auf automatisch generierte Memories zu verlassen. Regeln sind versionskontrolliert, mit Ihrem Team teilbar und geben Ihnen explizite Kontrolle über die Aktivierung.

​
So verwalten Sie Memories

Auf Memories und Rules können Sie jederzeit zugreifen und sie konfigurieren, indem Sie im Schiebemenü oben rechts in Cascade auf das Symbol Customizations klicken oder über „Windsurf – Settings“ in der rechten unteren Ecke. Um eine bestehende Memory zu bearbeiten, klicken Sie einfach darauf und anschließend auf die Schaltfläche Edit.

​
Memorys

Während eines Gesprächs kann Cascade automatisch Memorys generieren und speichern, wenn es auf Kontext stößt, den es für nützlich hält, um ihn sich zu merken. Außerdem kannst du Cascade jederzeit bitten, ein Memory zu erstellen. Bitte Cascade einfach: „Erstelle ein Memory von …“. Die automatisch generierten Memorys von Cascade 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. In einem Workspace generierte Memorys sind in einem anderen nicht verfügbar, und sie werden nicht in dein Repository übernommen.
Das Erstellen und Verwenden automatisch generierter Memorys verbraucht KEINE Credits.
Automatisch generierte Memorys befinden sich 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 Regel in .windsurf/rules/ oder in die AGENTS.md deines Repos zu schreiben.

​
Regeln

Benutzer können explizit eigene Regeln festlegen, die Cascade befolgen soll. Regeln können auf globaler, Workspace- oder Systemebene definiert werden und auch aus AGENTS.md-Dateien abgeleitet werden.
GeltungsbereichSpeicherortHinweise
Global~/.codeium/windsurf/memories/global_rules.mdEine einzelne Datei, die für alle Workspaces gilt. Immer aktiv. Auf 6.000 Zeichen begrenzt.
Workspace.windsurf/rules/*.mdEine Datei pro Regel, jeweils mit eigenem Aktivierungsmodus. Auf 12.000 Zeichen pro Datei begrenzt.
AGENTS.mdBeliebiges Verzeichnis in Ihrem WorkspaceWird von derselben Regel-Engine verarbeitet — im Stammverzeichnis = immer aktiv, im Unterverzeichnis = Auto-Glob für dieses Verzeichnis.
System (Enterprise)Betriebssystemabhängig (z. B. /etc/windsurf/rules/)Von der IT bereitgestellt, für Endbenutzer schreibgeschützt.

​
Regelermittlung

Windsurf erkennt Regeln automatisch aus mehreren Quellen, um eine flexible Organisation zu ermöglichen:
  • Aktueller Workspace und Unterverzeichnisse: Alle .windsurf/rules-Verzeichnisse innerhalb Ihres aktuellen Workspaces und seiner Unterverzeichnisse
  • Git-Repository-Struktur: Für Git-Repositories durchsucht Windsurf zusätzlich bis zum Git-Root-Verzeichnis, um Regeln in übergeordneten Verzeichnissen zu finden
  • Unterstützung mehrerer Workspaces: Wenn mehrere Ordner im selben Workspace geöffnet sind, werden Regeln dedupliziert und mit dem kürzesten relativen Pfad angezeigt

​
Speicherorte für Regeln

Regeln können an folgenden Orten gespeichert werden:
  • .windsurf/rules in Ihrem aktuellen Workspace-Verzeichnis
  • .windsurf/rules in jedem Unterverzeichnis Ihres Workspaces
  • .windsurf/rules in übergeordneten Verzeichnissen bis zum Git-Root (für Git-Repositories)
Wenn Sie eine neue Regel erstellen, wird sie im Verzeichnis .windsurf/rules Ihres aktuellen Workspaces gespeichert, nicht unbedingt im Git-Root. Um mit Regeln zu starten, klicken Sie im Schiebemenü oben rechts in Cascade auf das Symbol Customizations und navigieren Sie anschließend zum Panel Rules. Dort können Sie auf die Schaltfläche + Global oder + Workspace klicken, um neue Regeln entweder auf globaler Ebene oder auf Workspace-Ebene zu erstellen.
Beispielvorlagen für Regeln, kuratiert vom Windsurf-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 Regeldatei ist auf 6.000 Zeichen begrenzt.

​
Aktivierungsmodi

Jede Workspace-Regel legt in ihrem Frontmatter über das Feld trigger einen Aktivierungsmodus fest. Dieser steuert, wann der Inhalt der Regel an Cascade übergeben wird und wie viel Platz er im Kontextfenster belegt:
Modustrigger:-WertSo gelangt sie zu CascadeKontextkosten
Immer aktivalways_onDer vollständige Regelinhalt wird bei jeder Nachricht in den System-Prompt aufgenommen.Bei jeder Nachricht
Modellentscheidungmodel_decisionNur die description wird im System-Prompt 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. Du aktivierst sie, indem du @rule-name in das Cascade-Eingabefeld eingibst.Nur bei @Erwähnung
Die globale Regeldatei (global_rules.md) und AGENTS.md-Dateien im Root-Verzeichnis verwenden kein Frontmatter — sie sind immer aktiv.
Beispiel für eine Workspace-Regel mit Frontmatter: 
---
trigger: glob
globs: **/*.test.ts
---

Alle Testdateien müssen `describe`/`it`-Blöcke verwenden und externe API-Aufrufe mocken.

​
Best Practices

Damit Cascade Ihren Regeln effektiv folgen kann, beachten Sie diese Best Practices:
  • Halten Sie Regeln einfach, prägnant und konkret. Zu lange oder vage Regeln können Cascade verwirren.
  • Fügen Sie keine generischen Regeln hinzu (z. B. „schreibe guten Code“), da diese bereits in Cascades Trainingsdaten enthalten sind.
  • Formatieren Sie Ihre Regeln mit Aufzählungspunkten, nummerierten Listen und Markdown. Das ist für Cascade einfacher zu befolgen als ein langer Fließtext. Zum Beispiel:
# Coding-Richtlinien 
- Die Programmiersprache meines Projekts ist Python
- Verwende Early Returns, wenn möglich
- Füge immer Dokumentation hinzu, wenn du neue Funktionen und Klassen erstellst
  • XML-Tags können eine effektive Möglichkeit sein, um Informationen zu vermitteln und ähnliche Regeln zu gruppieren. Zum Beispiel:
<coding_guidelines>
- Die Programmiersprache meines Projekts ist Python
- Verwende frühe Rückgaben, wenn möglich
- Füge immer Dokumentation hinzu, wenn du neue Funktionen und Klassen erstellst
</coding_guidelines>

​
System-Level Rules (Enterprise)

Enterprise-Organisationen können System-Level Rules bereitstellen, die global für alle Workspaces gelten und von Endbenutzern ohne Administratorrechte nicht geändert werden können. Dies ist ideal, um organisationsweite Coding-Standards, Sicherheitsrichtlinien und Compliance-Vorgaben durchzusetzen. System-Level Rules werden aus betriebssystemspezifischen Verzeichnissen geladen: macOS: 
/Library/Application Support/Windsurf/rules/*.md
Linux/WSL: 
/etc/windsurf/rules/*.md
Windows: 
C:\ProgramData\Windsurf\rules\*.md
Legen Sie Ihre Regeldateien (als .md-Dateien) in das entsprechende Verzeichnis für Ihr Betriebssystem. Das System lädt automatisch alle .md-Dateien aus diesen Verzeichnissen.

​
Wie Systemregeln funktionieren

Systemweite Regeln werden mit Workspace- und globalen Regeln zusammengeführt und stellen zusätzlichen Kontext für Cascade bereit, ohne benutzerdefinierte Regeln zu überschreiben. So können Organisationen grundlegende Standards festlegen und Teams gleichzeitig erlauben, projektspezifische Anpassungen vorzunehmen. In der Windsurf-Benutzeroberfläche werden systemweite Regeln mit der Kennzeichnung „System“ angezeigt und können von Endbenutzern nicht gelöscht werden.
Wichtig: Systemweite Regeln sollten von Ihrem IT- oder Sicherheitsteam verwaltet werden. Stellen Sie sicher, dass Ihre internen Teams Bereitstellung, Updates und Compliance gemäß den Richtlinien Ihrer Organisation durchführen. Sie können dafür Standardtools und -Workflows wie Mobile Device Management (MDM) oder Konfigurationsmanagement verwenden.