Cursor Project Rules (.cursor/rules/*.mdc): Speicherort und Verwendung durch Tools

Cursor Project Rules sind .mdc-Dateien in .cursor/rules/, deren Frontmatter festlegt, wann die jeweilige Regel eingebunden wird. Cursor liest außerdem AGENTS.md sowie User Rules und Team Rules, die außerhalb des Repositorys festgelegt werden.

Speicherort

• .cursor/rules/**/*.mdc; Unterordner sind zulässig. Reguläre .md-Dateien in .cursor/rules werden ignoriert.
• AGENTS.md im Stammverzeichnis und in Unterordnern.
• User Rules, die in den Cursor-Einstellungen festgelegt werden.
• Team Rules, die im Team-Dashboard festgelegt werden.

Format

Markdown mit YAML-Frontmatter; die Erweiterung .mdc ist erforderlich. alwaysApply: true bindet die Regel immer ein. Globs mit alwaysApply: false binden sie ein, wenn eine passende Datei im Kontext ist. Bei alleiniger Angabe einer description entscheidet der Agent. Ist keines davon angegeben, gilt die Regel nur, wenn Sie sie mit @ erwähnen.

Frontmatter-Schlüssel: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

Priorität und Zusammenführung

Team Rules, dann Project Rules, dann User Rules. Alle anwendbaren Regeln werden zusammengeführt; bei Konflikten hat die zuerst genannte Quelle Vorrang. Erzwingbare Team Rules lassen sich nicht deaktivieren. Verschachtelte AGENTS.md-Dateien werden mit denen der übergeordneten Verzeichnisse zusammengeführt; die spezifischere Datei hat Vorrang.

Tools, die die Datei lesen

Tipps

• Trennen Sie mehrere Globs im Feld globs durch Kommas.
• Halten Sie jede Regel unter 500 Zeilen und verweisen Sie mit @filename auf Dateien, statt deren Inhalt einzufügen.
• Regeln gelten nicht für Cursor Tab, und User Rules gelten nicht für Inline Edit.
• Die veraltete Datei .cursorrules wird in der Cursor-Dokumentation nicht mehr erwähnt. Verschieben Sie sie nach .cursor/rules/.

Weitere Instruktionsdateien