Regeln liefern systemweite Anweisungen für Agent und Inline Edit. Denk an sie als persistenten Kontext, Vorlieben oder Workflows für deine Projekte. Cursor unterstützt vier Arten von Regeln:

Projektregeln

Gespeichert in .cursor/rules, versionsverwaltet und auf deine Codebase scoped.

User-Regeln

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

AGENTS.md

Agent-Anweisungen im Markdown-Format. Einfache Alternative zu .cursor/rules.

.cursorrules (Legacy)

Weiterhin unterstützt, aber veraltet. Nutz stattdessen Projektregeln.

Wie Regeln funktionieren

Große Sprachmodelle behalten zwischen Ausgaben keinen Speicher. Regeln liefern persistierenden, wiederverwendbaren Kontext auf Prompt-Ebene. Wenn sie angewendet werden, werden die Inhalte der Regeln am Anfang des Modellkontexts eingefügt. Das gibt der KI konsistente Leitlinien zum Generieren von Code, Interpretieren von Edits oder Unterstützen von Workflows.
Regel im Kontext mit Chat angewendet
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 Datei und wird versioniert. Sie können über Pfadmuster eingeschränkt, manuell aufgerufen oder je nach Relevanz einbezogen werden. Unterverzeichnisse können eigene .cursor/rules-Verzeichnisse enthalten, die auf ihren Ordner beschränkt sind. Verwende Projektregeln, um:
  • domänenspezifisches Wissen über deine Codebase zu codieren
  • projektspezifische Workflows oder Vorlagen zu automatisieren
  • Stil- oder Architekturentscheidungen zu standardisieren

Aufbau einer Regel

Jede Regeldatei wird in MDC (.mdc) geschrieben, einem Format mit Unterstützung für Metadaten und Inhalt. Steuere die Anwendung von Regeln über das Typ-Dropdown, das die Eigenschaften description, globs, alwaysApply setzt.
RegeltypBeschreibung
AlwaysImmer im Modellkontext enthalten
Auto AttachedWird einbezogen, wenn auf Dateien verwiesen wird, die einem Glob-Muster entsprechen
Agent RequestedFür die KI verfügbar, die entscheidet, ob sie sie einbezieht. Beschreibung erforderlich
ManualNur enthalten, wenn ausdrücklich mit @ruleName erwähnt
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts

Verschachtelte Regeln

Organisiere Regeln, indem du sie in .cursor/rules-Verzeichnissen überall im Projekt platzierst. Verschachtelte Regeln werden automatisch angehängt, wenn auf Dateien in ihrem Verzeichnis verwiesen wird.
project/
  .cursor/rules/        # Projektweite Regeln
  backend/
    server/
      .cursor/rules/    # Backend-spezifische Regeln
  frontend/
    .cursor/rules/      # Frontend-spezifische Regeln

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.
Vergleich von knappen vs. ausführlichen Regeln

Regeln generieren

Generiere Regeln direkt in Unterhaltungen mit dem Befehl /Generate Cursor Rules. Praktisch, wenn du Entscheidungen über das Agent-Verhalten getroffen hast und sie wiederverwenden willst.

Best Practices

Gute Regeln sind fokussiert, umsetzbar und klar abgegrenzt.
  • Halt Regeln unter 500 Zeilen
  • Teil große Regeln in mehrere, kombinierbare Regeln auf
  • Liefere konkrete Beispiele oder referenzierte Dateien
  • Vermeide vage Hinweise. Schreib Regeln wie klare interne Doku
  • Nutz Regeln wieder, wenn du Prompts im Chat wiederholst

Beispiele

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

AGENTS.md

AGENTS.md ist eine einfache Markdown-Datei zum Definieren von Agent-Anweisungen. Leg sie ins Projekt-Root als Alternative zu .cursor/rules für unkomplizierte Use Cases. Im Unterschied zu den Project Rules ist AGENTS.md eine reine Markdown-Datei ohne Metadaten oder komplexe Konfigurationen. Sie eignet sich 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

Aktuelle Einschränkungen

  • Nur auf Root-Ebene: AGENTS.md muss im Projekt-Root liegen (v1.5)
  • Kein Scoping: Anweisungen gelten global für dein Projekt
  • Einzeldatei: Anders als bei .cursor/rules kannst du Anweisungen nicht auf mehrere Dateien aufteilen
Unterstützung für verschachtelte AGENTS.md in Unterverzeichnissen ist für v1.6 geplant.

Nutzerregeln

Nutzerregeln sind globale Präferenzen, die in Cursor Settings → Rules festgelegt werden und für alle Projekte gelten. Sie sind reiner Text und ideal, um deinen bevorzugten Kommunikationsstil oder Coding‑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, aber künftig abgeschafft. Wir empfehlen dir, auf Project Rules zu migrieren, um mehr Kontrolle, Flexibilität und Sichtbarkeit zu erhalten.

FAQ