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

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

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:
  • XML-Tags können eine effektive Möglichkeit sein, um Informationen zu vermitteln und ähnliche Regeln zu gruppieren. Zum Beispiel:

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:
Linux/WSL:
Windows:
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.