Cursor ist für viele Teams der Einstieg in KI-gestützte Entwicklung, weil der Editor vertraut wirkt und der Agent direkt im Code arbeitet. Sobald mehrere Personen am selben Projekt arbeiten, zeigt sich jedoch: Ohne gemeinsame Regeln liefert der Agent bei jedem Teammitglied andere Ergebnisse. Cursor Rules schaffen hier Verbindlichkeit, der Agent-Modus braucht klare Grenzen. Dieser Leitfaden erklärt die Regeltypen, zeigt eine sinnvolle Ordnerstruktur und gibt Hinweise, wie Sie den Agent-Modus im Team verantwortungsvoll nutzen.
Die Regeltypen in Cursor
Projektregeln liegen als Dateien mit der Endung mdc im Ordner .cursor/rules und werden mit dem Repository versioniert. Jede Regel hat Metadaten, die festlegen, wann sie greift. Always-Regeln werden bei jeder Anfrage mitgeschickt. Auto-Attached-Regeln greifen, wenn betroffene Dateien zu einem Glob-Muster passen, etwa alle TypeScript-Dateien im Frontend. Agent-Requested-Regeln haben eine Beschreibung, anhand derer der Agent entscheidet, ob er sie lädt. Manuelle Regeln werden nur bei ausdrücklicher Erwähnung einbezogen.
Daneben gibt es Benutzerregeln in den persönlichen Einstellungen, die für alle Projekte gelten, und in Business-Plänen zentral verwaltete Teamregeln. Die ältere Einzeldatei .cursorrules wird noch gelesen, sollte aber durch den Regelordner ersetzt werden. Cursor unterstützt außerdem AGENTS.md, was praktisch ist, wenn im Team mehrere Werkzeuge parallel genutzt werden.
Eine Regelstruktur, die skaliert
Bewährt hat sich eine kleine Always-Regel mit den Grundlagen: Stack, Befehle für Tests und Build, wichtigste Konventionen. Alles Weitere wird spezifisch: eine Regel für das Frontend mit Glob auf die Komponentenordner, eine für Datenbankmigrationen, eine für API-Endpunkte. So bekommt der Agent nur das Wissen, das zur jeweiligen Datei passt, und der Kontext bleibt frei für den eigentlichen Code.
Schreiben Sie Regeln wie Anweisungen an eine erfahrene Kollegin: kurz, konkret und mit Beispielen. Ein kurzes Codebeispiel für den gewünschten Stil wirkt oft stärker als drei Absätze Erklärung. Referenzieren Sie vorhandene Dateien als Vorlage, statt Code in die Regel zu kopieren, der dann veraltet.
Vermeiden Sie Regeln, die sich widersprechen, etwa eine allgemeine Vorgabe für Fehlerbehandlung und eine abweichende im Backend-Ordner ohne klaren Hinweis, welche Vorrang hat. Solche Widersprüche führen zu wechselhaften Ergebnissen, die sich schwer erklären lassen.
Agent-Modus mit Augenmaß
Im Agent-Modus plant Cursor selbstständig, bearbeitet mehrere Dateien und führt Terminalbefehle aus. Legen Sie in den Einstellungen fest, welche Befehle ohne Rückfrage laufen dürfen, und halten Sie diese Liste kurz. Ein automatisches Ausführen aller Befehle ist bequem, öffnet aber die Tür für ungewollte Installationen oder Löschvorgänge. Auch MCP-Server erweitern die Möglichkeiten des Agenten und sollten im Team abgestimmt werden.
Nutzen Sie Checkpoints, um Änderungen des Agenten zurückzurollen, ersetzen Sie damit aber nicht Git. Kleine Commits nach jedem abgeschlossenen Schritt machen Ergebnisse nachvollziehbar und erleichtern das Review. Für Aufgaben, die länger laufen, bieten sich die Hintergrund-Agenten von Cursor an, die in einer Remote-Umgebung arbeiten.
Klären Sie im Team außerdem, wie mit Ergebnissen des Agenten umgegangen wird. Wer eine Änderung committet, ist für sie verantwortlich, unabhängig davon, ob sie aus dem Agenten stammt. Diese einfache Regel verhindert, dass ungeprüfter Code in Pull Requests landet, und schärft den Blick für die Qualität der Vorschläge.
Regeln im Team einführen
- Sammeln Sie die häufigsten Korrekturen, die Ihr Team an Agenten-Ergebnissen vornimmt.
- Formulieren Sie daraus eine schlanke Always-Regel und zwei bis drei spezifische Regeln mit Glob-Muster.
- Legen Sie die Regeln im Repository ab und ändern Sie sie nur per Pull Request.
- Vereinbaren Sie, welche Terminalbefehle der Agent ohne Rückfrage ausführen darf.
- Überprüfen Sie die Regeln nach einigen Wochen anhand echter Ergebnisse und streichen Sie, was nicht wirkt.
Mit Training schneller zum Standard
Regeln sind schnell geschrieben, aber gute Regeln entstehen erst durch Erfahrung mit dem eigenen Code. In den Cursor-Workshops von neooutput erarbeiten unsere AI Code Engineers mit Ihrem Team ein Regelwerk für Ihre echte Codebasis und üben den sicheren Umgang mit dem Agent-Modus, auf Wunsch auch im Vergleich mit Claude Code oder Codex. Lassen Sie uns in einem kostenlosen 15-Minuten-Erstgespräch besprechen, wo Ihr Team steht.
Häufige Fragen
Brauche ich noch eine .cursorrules-Datei?
Nein. Die Datei wird zwar weiterhin unterstützt, für neue Projekte empfiehlt sich aber der Ordner .cursor/rules mit einzelnen Regeldateien. Sie sind übersichtlicher und lassen sich gezielter einsetzen.
Wie viele Always-Regeln sind sinnvoll?
So wenige wie möglich, idealerweise eine kurze Grundregel. Alles, was nur für bestimmte Bereiche gilt, gehört in Regeln mit Glob-Muster oder Beschreibung. So bleibt der Kontext schlank.
Kann ich Cursor-Regeln auch für Claude Code nutzen?
Nicht direkt, da Claude Code die CLAUDE.md liest. Wenn Sie gemeinsame Inhalte pflegen möchten, bietet sich die AGENTS.md als gemeinsame Basis an, auf die beide Werkzeuge zugreifen können.