Regeln

Steuere, wie sich das Agent-Modell mit wiederverwendbaren, kontextbezogenen Anweisungen verhält.

Regeln liefern Systemanweisungen für Agent und Inline Edit. Denk an sie als persistenten Kontext, Voreinstellungen oder Workflows für deine Projekte.

Cursor unterstützt vier Arten von Regeln:

Project Rules

Gespeichert in .cursor/rules, versionskontrolliert und auf deine Codebase beschränkt.

User Rules

Global in deiner Cursor-Umgebung. In den Einstellungen definiert und immer angewendet.

AGENTS.md

Anweisungen für den Agent im Markdown-Format. Einfache Alternative zu .cursor/rules.

.cursorrules (Legacy)

Weiterhin unterstützt, aber veraltet. Verwende stattdessen Project Rules.

Wie Regeln funktionieren

Große Sprachmodelle behalten zwischen Ausgaben keinen Speicher. Regeln liefern auf Prompt-Ebene einen persistenten, wiederverwendbaren Kontext.

Wenn sie angewendet werden, werden die Regelinhalte am Anfang des Modellkontexts eingefügt. So bekommt die KI konsistente Leitlinien zum Generieren von Code, Interpretieren von Edits oder Unterstützen von Workflows.

Regeln gelten für Chat und Inline Edit. Aktive Regeln werden in der Agent-Sidebar angezeigt.

Projektregeln

Projektregeln liegen in .cursor/rules. Jede Regel ist eine eigene Datei und wird versioniert. Sie können per Pfadmuster eingeschränkt, manuell ausgeführt oder basierend auf Relevanz einbezogen werden. Unterverzeichnisse können ihr eigenes .cursor/rules-Verzeichnis haben, das auf diesen Ordner scoped ist.

Verwende Projektregeln, um:

• domänenspezifisches Wissen über deine Codebase zu hinterlegen
• projektspezifische Workflows oder Vorlagen zu automatisieren
• Stil- oder Architekturentscheidungen zu standardisieren

Anatomie einer Regel

Jede Regeldatei wird in MDC (.mdc) geschrieben, einem Format für Metadaten und Inhalt. Steuere über das Typ-Dropdown, wie Regeln angewendet werden; es ändert die Eigenschaften description, globs, alwaysApply.

Rule Type	Beschreibung
Always	Immer im Modellkontext enthalten
Auto Attached	Wird einbezogen, wenn referenzierte Dateien einem Glob-Muster entsprechen
Agent Requested	Für die KI verfügbar, die entscheidet, ob sie es einbezieht. Es muss eine Beschreibung angegeben werden
Manual	Nur enthalten, wenn ausdrücklich mit @ruleName erwähnt

---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Verwende unser internes RPC-Pattern beim Definieren von Services
- Verwende für Servicenamen immer snake_case.

@service-template.ts

Verschachtelte Regeln

Organisiere Regeln, indem du sie in .cursor/rules-Verzeichnissen überall im Projekt ablegst. Verschachtelte Regeln werden automatisch angehängt, wenn Dateien in ihrem Verzeichnis referenziert werden.

project/
  .cursor/rules/        # Projektweite Regeln
  backend/
    server/
      .cursor/rules/    # Backend-spezifische Regeln
  frontend/
    .cursor/rules/      # Frontend-spezifische Regeln

Eine Regel erstellen

Erstelle Regeln mit dem Befehl New Cursor Rule oder über Cursor Settings > Rules. Dadurch wird eine neue Regeldatei in .cursor/rules angelegt. In den Einstellungen siehst du alle Regeln und ihren Status.

Regeln generieren

Generiere Regeln direkt in Unterhaltungen mit dem Befehl /Generate Cursor Rules. Praktisch, wenn du Entscheidungen zum Verhalten von Agenten getroffen hast und sie wiederverwenden willst.

Best Practices

Gute Regeln sind fokussiert, umsetzbar und sauber abgegrenzt.

• Halt Regeln unter 500 Zeilen
• Teil große Regeln in mehrere, kombinierbare Regeln auf
• Gib konkrete Beispiele oder verlinkte/verweise auf zugehörige Dateien
• Vermeide vage Anweisungen. Schreib Regeln wie klare interne Dokus
• Wiederverwend Regeln, wenn Prompts im Chat wiederholt werden

Beispiele

Standards für Frontend-Komponenten und API-Validierung

Diese Regel definiert Standards für Frontend-Komponenten:

Beim Arbeiten im components-Verzeichnis:

• Verwende immer Tailwind fürs Styling
• Nutze Framer Motion für Animationen
• Halte dich an die Namenskonventionen für Komponenten

Diese Regel erzwingt die Validierung für API-Endpunkte:

Im API-Verzeichnis:

• Nutze zod für alle Validierungen
• Definiere Rückgabetypen mit zod-Schemas
• Exportiere aus den Schemas generierte Typen

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:

• Befolge RESTful-Prinzipien
• Binde Error-Handling-Middleware ein
• Richte sauberes Logging ein

@express-service-template.ts

Diese Regel definiert die Struktur von React-Komponenten:

React-Komponenten sollten diesem Aufbau folgen:

• Props-Interface oben
• Komponente als Named Export
• Styles unten

@component-template.tsx

Automatisierung von Entwicklungs-Workflows und Dokumentationsgenerierung

Diese Regel automatisiert die App-Analyse:

Wenn du gebeten wirst, die App zu analysieren:

1. Starte den Dev-Server mit npm run dev
2. Sammle die Logs aus der Konsole
3. Schlage Performance-Verbesserungen vor

Diese Regel hilft bei der Generierung von Dokumentation:

Hilf beim Entwurf der Dokumentation, indem du:

• Code-Kommentare extrahierst
• die README.md analysierst
• Markdown-Dokumentation generierst

Eine neue Einstellung in Cursor hinzufügen

Erstelle zuerst eine Property zum Umschalten in @reactiveStorageTypes.ts.

Füge den Default-Wert in INIT_APPLICATION_USER_PERSISTENT_STORAGE in @reactiveStorageService.tsx hinzu.

Für Beta-Features füge den Toggle in @settingsBetaTab.tsx hinzu, ansonsten in @settingsGeneralTab.tsx. Toggles können als <SettingsSubSection> für allgemeine Checkboxen hinzugefügt werden. Schau dir den Rest der Datei für Beispiele an.

<SettingsSubSection
				label="Your feature name"
				description="Your feature description"
				value={
					vsContext.reactiveStorageService.applicationUserPersistentStorage
						.myNewProperty ?? false
				}
				onChange={(newVal) => {
					vsContext.reactiveStorageService.setApplicationUserPersistentStorage(
						'myNewProperty',
						newVal
					);
				}}
			/>

Um es in der App zu verwenden, importiere reactiveStorageService und nutze die Property:

const flagIsEnabled = vsContext.reactiveStorageService.applicationUserPersistentStorage.myNewProperty

Viele Beispiele sind von Providern und Frameworks verfügbar. Community-Beiträge findest du in crowdsourced Sammlungen und Repositories online.

AGENTS.md

AGENTS.md ist eine einfache Markdown-Datei zum Definieren von Agent-Anweisungen. Lege sie in dein Projekt-Root als Alternative zu .cursor/rules für unkomplizierte Use Cases.

Anders als Project Rules ist AGENTS.md eine reine Markdown-Datei ohne Metadaten oder komplexe Konfigurationen. Sie ist perfekt für Projekte, die einfache, gut lesbare Anweisungen brauchen – ohne den Overhead strukturierter Regeln.

# Project Instructions

## Code Style
- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture
- Follow the repository pattern
- Keep business logic in service layers

Benutzerregeln

Benutzerregeln sind globale Einstellungen, die in Cursor Settings → Rules definiert werden und für alle Projekte gelten. Sie sind reiner Text und ideal, um bevorzugten Kommunikationsstil oder Code-Konventionen festzulegen:

Please reply in a concise style. Avoid unnecessary repetition or filler language.

.cursorrules (Legacy)

Die Datei .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 erhalten.

FAQ

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?

Ja. Verwende @filename.ts, um Dateien in den Kontext deiner Regel einzubinden.

Kann ich eine Regel aus dem Chat erstellen?

Ja, generier Projektrichtlinien 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?

Nein. Regeln gelten nur für Agent und Inline Edit.