IDE-Tools · Foto: Homedust, CC BY 2.0
code-analysis.mdc
Zuletzt aktualisiert:
Typ
Rule
Lizenz
MIT
Anwendungsfeld
Windsurf Rules & Cross-IDE-Rules
Codebase-Audits
Voraussetzungen
- Bestehendes, ausreichend großes oder gewachsenes Repository
- KI-Editor/Agent mit Unterstützung für Custom-Regeln (z. B. Cursor)
Einordnung
Der Aufbau eines Knowledge Graphs und einer Architekturanalyse ist aufwendig, liefert bei großen Codebasen aber entsprechend viel.
Erweiterte Code-Analyse: Knowledge Graph, Qualität, Architektur
Für wen: Codebase-Audits
Im Detail
Diese Cursor-Regel rüstet den Assistenten für tiefere Codebase-Audits aus: Sie fordert an, einen Knowledge Graph der Abhängigkeiten aufzubauen, Codequalität systematisch zu bewerten und Architekturmuster zu erkennen, statt Dateien isoliert zu betrachten. Damit eignet sie sich, wenn man ein unbekanntes oder gewachsenes Repository verstehen will, bevor größere Refactorings oder Migrationen anstehen. Im Vergleich zu einfachen Review-Regeln liefert sie einen strukturierten Überblick statt einzelner Zeilenkommentare. Der Nutzen hängt stark von der Projektgröße ab – bei kleinen Skripten ist der Analyseaufwand meist übertrieben und lohnt sich nicht.
Schritt für Schritt
- Regel vor größeren Refactorings oder Migrationen auf ein unbekanntes oder gewachsenes Repository anwenden
- Agenten einen Knowledge Graph der Abhängigkeiten aufbauen lassen
- Codequalität systematisch bewerten lassen statt einzelne Dateien isoliert zu betrachten
- erkannte Architekturmuster als Grundlage für die weitere Planung nutzen
- Ergebnis mit dem Team abgleichen, bevor das eigentliche Refactoring beginnt
Beispiel aus der Praxis
Vor der Migration eines über Jahre gewachsenen Backend-Repositories lässt man code-analysis.mdc laufen; der Agent erstellt einen Abhängigkeits-Graph und markiert Module mit inkonsistenten Architekturmustern, die vorab bereinigt werden sollten.
Praxis-Tipp
Setzen Sie die Regel gezielt vor einem größeren Refactoring oder der Übernahme eines Fremdprojekts ein, um erst die Architektur zu verstehen, bevor Änderungen erfolgen.
Stolperfallen
Bei kleinen Skripten ist der Analyseaufwand laut Quelle übertrieben und lohnt sich nicht - die Regel entfaltet ihren Nutzen erst bei größeren, gewachsenen Codebasen.
Siehe auch
Lizenz & Quelle
- Lizenz: MIT
- Quelle: github.com/steipete/agent-rules
Häufige Fragen.
Wofür eignet sich diese Regel besser als eine einfache Review-Regel?
Sie liefert einen strukturierten Überblick über Architektur und Abhängigkeiten statt einzelner Zeilenkommentare.
Lohnt sich die Regel bei kleinen Projekten?
Nein, laut Quelle ist der Analyseaufwand bei kleinen Skripten meist übertrieben.
Wann ist der richtige Zeitpunkt für den Einsatz?
Am sinnvollsten vor größeren Refactorings oder Migrationen an einem unbekannten oder gewachsenen Repository.
Inhalt ansehen (code-analysis.mdc)
Lade …
Erfahrungen & Kommentare.
Funktioniert der Rule bei Ihnen? Tipps, Stolperfallen, Varianten — teilen Sie es mit der Community.
Lade Kommentare …
Passt dazu.
v5.md
Basis-Regelwerk: Task-Klassifizierung (leicht/standard/kritisch), Tool-Nutzung, Antwortstil
prompt-injection-guard.md
Schutz vor Prompt-Injection aus externem Kontext (Web/RAG/Dateien): Stopp + Rückfrage bei gefährlichen Aktionen
commit-message-format.md
Commit-Messages nach Conventional Commits (Prefix + Summary + Bullet-Body)
