IDE-Tools · Foto: Homedust, CC BY 2.0

RuleWindsurf Rules & Cross-IDE-RulesLizenz: MITfrei kopierbar

bug-fix.mdc

Zuletzt aktualisiert: 19. September 2026

⬇ Als Datei laden

⧉ –× kopiert⬇ –× heruntergeladenBewertung:

Typ

Rule

Lizenz

MIT

Quelle

github.com/steipete/agent-rules ↗

Anwendungsfeld

Windsurf Rules & Cross-IDE-Rules

Bug-Bearbeitung mit Prozess

Voraussetzungen

GitHub-Issue-System mit ausreichend beschriebenen Tickets
Vorhandene Test-Infrastruktur im Projekt
Berechtigung, Branches anzulegen und Pull Requests zu öffnen

Einordnung

Hoher Ertrag durch erzwungene Reihenfolge, aber nur mit Test-Infrastruktur und Issue-Disziplin sinnvoll einsetzbar.

Kompletter Bugfix-Ablauf: Issue → Branch → Test → Fix → PR

Für wen: Bug-Bearbeitung mit Prozess

Im Detail

Diese Regel bündelt den kompletten Bugfix-Workflow in einem Aufruf: Sie liest das zugehörige Issue, legt einen Branch an, schreibt zuerst einen fehlschlagenden Test, der den Bug reproduziert, behebt dann den Fehler und öffnet abschließend einen Pull Request mit Beschreibung. Der Vorteil gegenüber manuellem Vorgehen ist die erzwungene Reihenfolge: Ohne reproduzierenden Test wird nicht gepatcht, was Regressionen sichtbar macht. Sinnvoll für Teams mit klarer Issue-Kultur und Testpflicht vor jedem Merge. Wer ohne Test-Infrastruktur arbeitet oder Hotfixes ohne PR-Review braucht, profitiert weniger.

Schritt für Schritt

Vor dem ersten Einsatz prüfen, ob das Projekt eine Test-Infrastruktur besitzt, auf die die Regel aufsetzen kann
Issue-Nummer oder Link bereitstellen, damit der Agent den nötigen Kontext hat
Den generierten reproduzierenden Test gegenlesen, ob er den Bug tatsächlich korrekt abbildet
Branch-Namen und PR-Beschreibung vor dem Merge kontrollieren
Bei Hotfixes ohne PR-Pflicht die Regel anpassen oder für diesen Fall nicht verwenden

Beispiel aus der Praxis

Zu Issue #42 „Login schlägt bei Sonderzeichen im Passwort fehl“ legt die Regel einen Branch an, schreibt zuerst einen Test, der den Fehler reproduziert, behebt dann den Bug und öffnet abschließend einen Pull Request mit Beschreibung und Bezug auf das Issue.

Praxis-Tipp

Rufen Sie die Regel mit einer Issue-Nummer auf, z. B. “Fix Issue #217 nach bug-fix.mdc”, damit Branch-Name und PR-Titel automatisch aus dem Issue abgeleitet werden.

Stolperfallen

Ohne echte Test-Infrastruktur bricht der Workflow ab oder erzeugt Tests, die den Fehler nicht sauber abbilden. In Teams ohne klare Issue-Kultur fehlt dem Agenten der nötige Kontext, wodurch Branch, Test und PR am eigentlichen Problem vorbeigehen können.

Siehe auch

Lizenz & Quelle

Lizenz: MIT
Quelle: github.com/steipete/agent-rules

Häufige Fragen.

Brauche ich unbedingt ein bestehendes Test-Setup?

Ja, die Regel setzt voraus, dass im Projekt Tests geschrieben und ausgeführt werden können, sonst fehlt der zentrale Reproduktionsschritt.

Was, wenn ich schnell einen Hotfix ohne Review-Prozess brauche?

Dafür ist die Regel weniger geeignet, da sie zwingend einen Test vor dem Fix und einen Pull Request am Ende vorsieht.

Funktioniert das auch bei Issues ohne viele Details?

Die Qualität von Branch, Test und Fix hängt direkt davon ab, wie viel Kontext im Issue steht – bei dünnen Beschreibungen liefert der Ablauf entsprechend weniger Substanz.

Inhalt ansehen (bug-fix.mdc)

Lade …

Erfahrungen & Kommentare.

Funktioniert der Rule bei Ihnen? Tipps, Stolperfallen, Varianten — teilen Sie es mit der Community.

Lade Kommentare …