Project Rules
Gespeichert in
.cursor/rules
, versionsverwaltet und auf deinen Codebase-Kontext begrenzt.User Rules
Global in deiner Cursor-Umgebung. In den Einstellungen definiert und immer angewendet.
AGENTS.md
Agent-Anweisungen im Markdown-Format. Eine einfache Alternative zu
.cursor/rules
..cursorrules (Legacy)
Weiterhin unterstützt, aber veraltet. Verwende stattdessen Project Rules.
Wie Regeln funktionieren

Regeln gelten für Chat und Inline
Edit. Aktive Regeln werden in der Agent-Seitenleiste angezeigt.
Projektregeln
.cursor/rules
. Jede Regel ist eine Datei und steht unter Versionskontrolle. Sie können über Pfad-Muster eingegrenzt, manuell ausgeführt oder basierend auf Relevanz einbezogen werden. Unterverzeichnisse können ihr eigenes .cursor/rules
-Verzeichnis enthalten, das auf diesen Ordner beschränkt ist.
Verwende Projektregeln, um:
- domänenspezifisches Wissen über deine Codebasis zu erfassen
- projektspezifische Workflows oder Vorlagen zu automatisieren
- Stil- oder Architekturentscheidungen zu standardisieren
Anatomie einer Rule
.mdc
) geschrieben, einem Format, das Metadaten und Inhalt unterstützt. Steuere über das Typ-Dropdown, wie Rules angewendet werden; es ändert die Properties description
, globs
, alwaysApply
.
Rule-Typ | Beschreibung |
---|---|
Always | Immer im Model-Kontext enthalten |
Auto Attached | Wird einbezogen, wenn referenzierte Dateien einem Glob-Pattern entsprechen |
Agent Requested | Für die AI verfügbar, die entscheidet, ob sie es einbezieht. Beschreibung erforderlich |
Manual | Nur enthalten, wenn explizit mit @ruleName erwähnt |
Verschachtelte Regeln
.cursor/rules
-Verzeichnissen überall im Projekt ablegst. Verschachtelte Regeln werden automatisch verknüpft, wenn auf Dateien in ihrem Verzeichnis verwiesen wird.
Eine Regel erstellen
New Cursor Rule
oder über Cursor Settings > Rules
. Dadurch wird eine neue Regeldatei in .cursor/rules
erstellt. In den Einstellungen kannst du alle Regeln und ihren Status sehen.

Regeln generieren
/Generate Cursor Rules
. Praktisch, wenn du Entscheidungen zum Agentenverhalten getroffen hast und sie wiederverwenden willst.
Best Practices
- Halt Regeln unter 500 Zeilen
- Teil große Regeln in mehrere, kombinierbare Regeln auf
- Gib konkrete Beispiele oder verlinkte Dateien an
- Vermeide vage Anleitungen. Schreib Regeln wie klare interne Doku
- Nutze Regeln wieder, wenn Prompts im Chat wiederholt werden
Beispiele
Standards für Frontend-Komponenten und API-Validierung
Standards für Frontend-Komponenten und API-Validierung
Diese Regel legt Standards für Frontend-Komponenten fest:Im components-Verzeichnis:
- Immer Tailwind für Styles verwenden
- Framer Motion für Animationen nutzen
- Namenskonventionen für Komponenten einhalten
- zod für alle Validierungen verwenden
- Rückgabetypen mit zod-Schemas definieren
- Aus den Schemas generierte Typen exportieren
Vorlagen für Express-Services und React-Komponenten
Vorlagen für Express-Services und React-Komponenten
Diese Regel stellt eine Vorlage für Express-Services bereit:Verwende diese Vorlage beim Erstellen eines Express-Services:
- RESTful-Prinzipien einhalten
- Error-Handling-Middleware einbinden
- Sinnvolles Logging einrichten
- Props-Interface oben
- Komponente als benannter Export
- Styles unten
Automatisierung von Entwicklungs-Workflows und Dokumentationsgenerierung
Automatisierung von Entwicklungs-Workflows und Dokumentationsgenerierung
Diese Regel automatisiert die App-Analyse:Wenn du die App analysieren sollst:
- Dev-Server mit
npm run dev
starten - Logs aus der Konsole holen
- Performance-Verbesserungen vorschlagen
- Extrahieren von Code-Kommentaren
- Analysieren der README.md
- Generieren von Markdown-Dokumentation
Eine neue Einstellung in Cursor hinzufügen
Eine neue Einstellung in Cursor hinzufügen
Zuerst eine Property zum Umschalten in Um es in der App zu verwenden,
@reactiveStorageTypes.ts
anlegen.Standardwert in INIT_APPLICATION_USER_PERSISTENT_STORAGE
in @reactiveStorageService.tsx
hinzufügen.Für Beta-Features den Toggle in @settingsBetaTab.tsx
hinzufügen, sonst in @settingsGeneralTab.tsx
. Toggles können als <SettingsSubSection>
für allgemeine Checkboxen hinzugefügt werden. Sieh dir den Rest der Datei für Beispiele an.reactiveStorageService
importieren und die Property nutzen:AGENTS.md
AGENTS.md
ist eine einfache Markdown-Datei, in der du Anweisungen für Agents definierst. Leg sie im Projekt-Root ab – als Alternative zu .cursor/rules
für unkomplizierte Use Cases.
Im Gegensatz zu den Project Rules ist AGENTS.md
eine reine Markdown-Datei ohne Metadaten oder komplexe Konfigurationen. Perfekt für Projekte, die einfache, gut lesbare Anweisungen brauchen, ohne den Overhead strukturierter Regeln.
Benutzerregeln
.cursorrules
(Legacy)
.cursorrules
im Projekt-Root wird weiterhin unterstützt, ist aber veraltet. Wir empfehlen, auf Project Rules zu migrieren, um mehr Kontrolle, Flexibilität und Transparenz zu bekommen.
FAQ
Warum wird meine Regel nicht angewendet?
Warum wird meine Regel nicht angewendet?
Check den Regeltyp. Für
Agent Requested
stell sicher, dass eine Beschreibung definiert ist. Für Auto Attached
stell sicher, dass das Dateimuster zu den referenzierten Dateien passt.Können Regeln andere Regeln oder Dateien referenzieren?
Können Regeln andere Regeln oder Dateien referenzieren?
Ja. Verwende
@filename.ts
, um Dateien in den Kontext deiner Regel einzubinden.Kann ich eine Regel aus dem Chat erstellen?
Kann ich eine Regel aus dem Chat erstellen?
Ja, generiere Projektregeln aus dem Chat mit dem Befehl
/Generate Cursor Rules
.
Wenn Memories aktiviert sind, werden Memories automatisch erzeugt.Beeinflussen Regeln den Cursor Tab oder andere KI‑Features?
Beeinflussen Regeln den Cursor Tab oder andere KI‑Features?
Nein. Regeln gelten nur für Agent und Inline Edit.