.cursorrules-Datei (Projektregeln für KI)
Spezielle Konfigurationsdatei im Repository-Stammverzeichnis (.cursorrules). Überträgt automatisch Code-Stilregeln, den Technologie-Stack, verbotene Bibliotheken und architektonische Einschränkungen vor jeder Generierung an das Modell.
1. Überblick über das Konzept und den Zweck
Wenn Sie gemeinsam mit einer KI an einem Projekt arbeiten, werden Sie schnell ihre unangenehmen Gewohnheiten bemerken:
- Sie entscheidet sich plötzlich für die Installation einer veralteten Bibliotheksversion, die seit drei Jahren nicht mehr unterstützt wird.
- Sie schreibt Code in JavaScript statt im streng typisierten TypeScript.
- Sie erfindet eine eigene Ordnerstruktur und bricht damit die Architektur Ihrer Website.
Die Datei .cursorrules ist das Gesetz Ihres Projekts. Es handelt sich um einen kurzen Regelkatalog im Format von einfachem Text oder Markdown, den Sie einmalig im Stammverzeichnis des Projekts ablegen. Jedes Mal, wenn die KI versucht, auch nur eine Zeile Code zu schreiben oder zu ändern, muss sie diese Datei konsultieren.
Das zentrale ingenieurtechnische Prinzip lautet: Der einfachste Weg, Code sauber und ordentlich zu halten, ohne der KI täglich langweilige Ermahnungen geben zu müssen.
2. Anatomie der idealen .cursorrules-Datei
Hier ist eine fertige Vorlage, die Sie sofort in Ihr Projekt kopieren können:
# Стек технологій та стандарти проекту
- Мова: TypeScript (суворий режим strict: true)
- Фреймворк: Next.js (App Router)
- Стилі: Tailwind CSS (жодних інлайн-стилів чи звичайного CSS)
- База даних: Drizzle ORM + PostgreSQL / SQLite
# Правила для агента:
1. Завжди пиши повні реалізації файлів. Ніколи не залишай лінивих коментарів типу "// ... тут решта коду".
2. Усі користувацькі тексти та кнопки мають бути українською мовою.
3. Перед створенням нового npm-пакету перевір, чи немає вже встановленого аналогу в package.json.
4. Якщо бачиш помилку в архітектурі — спершу поясни ризик, а потім пропонуй зміни.
3. Vier Dinge, die unbedingt verboten werden sollten
- Verbot von faulen Kommentaren: Das Schlimmste ist, wenn das Modell die Mitte Ihres Arbeitscodes löscht und
// ... keep existing codeschreibt. Formulieren Sie ein klares Verbot dieser Praxis. - Fixierung von Bibliotheksversionen: Geben Sie beispielsweise an: „Verwende ausschließlich Lucide-React für Icons“, damit das Modell nicht gleichzeitig FontAwesome und HeroIcons importiert.
- Regeln für die Komponentennamen (Naming): Legen Sie fest: „Komponentennamen werden in PascalCase geschrieben, Utility-Namen in camelCase“.
- Anforderungen an Typen: Verbieten Sie die Verwendung des Typs
anyin TypeScript.
4. Warum dies Stunden beim Debugging spart
Dank .cursorrules fühlt sich das Modell vom ersten Moment an wie ein erfahrener Entwickler Ihres Teams, der die unternehmensinternen Standards perfekt kennt. Sie erhalten Code, der beim ersten Versuch kompiliert – ohne Syntaxkonflikte!
FAQ: .cursorrules-Datei (Projektregeln für KI)
Verwandte Begriffe
Agent Rules (.cursorrules / CLAUDE.md / AGENTS.md)
Maschinenlesbare Dateien mit Architekturrichtlinien und Einschränkungen im Repository, die automatisch in den Systemkontext von KI-Agenten eingebunden werden, um eine Degradation der Codebasis zu verhindern.
Cursor Composer (Mehrdater-Agenten-Bearbeitung)
Der Flaggschiff-Agentenmodus des Code-Editors Cursor (Strg+I / Cmd+I). Ermöglicht es der künstlichen Intelligenz, gleichzeitig Dutzende von Projektdateien zu erstellen, zu ändern und miteinander zu verknüpfen, Befehle im Terminal auszuführen und Fehler zu überprüfen.
Spezifikation vor Code (Spec-First Vibe Coding)
Eine KI-gestützte Entwicklungsmethodik (Spec-Driven Development). Anstatt sofort chaotischen Code zu generieren, lässt der Entwickler das Modell zunächst eine strukturierte SPEC.md-Datei erstellen, die Architektur, Datentypen und Implementierungsschritte definiert.