bug-fix.mdc

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

Für wen: Bug-Bearbeitung mit Prozess

Im Detail

bug-fix.mdc bildet den kompletten Standardablauf einer Fehlerbehebung als Regel ab: vom Issue über das Anlegen eines Branches, einen reproduzierenden Test, die eigentliche Korrektur bis zum fertigen Pull Request. Der Vorteil gegenüber informellem Vorgehen ist, dass kein Schritt vergessen wird — insbesondere der reproduzierende Test vor dem Fix, der sonst gerne übersprungen wird und dann keine Sicherheit gibt, dass der Bug wirklich behoben ist. Geeignet für Teams mit klarem Git-Workflow (Branch pro Fix, PR-Pflicht); für sehr kleine oder informelle Projekte kann der Prozess overhead-lastig wirken.

Voraussetzungen

• Git-Workflow mit Branch pro Fix und PR-Pflicht
• Test-Infrastruktur, um einen reproduzierenden Test schreiben zu können

Schritt für Schritt

1. Regel bei einem gemeldeten Issue aktivieren, bevor die Korrektur beginnt
2. Branch gemäß dem vorgegebenen Ablauf anlegen
3. reproduzierenden Test schreiben, der den Bug zunächst zuverlässig fehlschlagen lässt
4. eigentliche Korrektur umsetzen, bis der Test grün ist
5. Pull Request gemäß dem Ablauf erstellen
6. bei sehr kleinen oder informellen Projekten abwägen, ob der volle Prozess angemessen ist

Beispiel aus der Praxis

Ein gemeldeter Bug führt zu einem neuen Branch, einem Test, der den Fehler zunächst reproduziert, der Fix-Implementierung bis der Test besteht, und einem PR, der den gesamten Ablauf dokumentiert.

Praxis-Tipp

Kombinieren Sie diese Regel mit test-strategy.md für den reproduzierenden Test und mit pr-message-format.md für den sauberen Abschluss des Pull Requests.

Stolperfallen

Den reproduzierenden Test vor dem Fix zu überspringen ist der klassische Fehler, den die Regel verhindern soll — ohne ihn fehlt der Beleg, dass der Bug wirklich behoben ist. In sehr kleinen oder informellen Projekten kann der vollständige Prozess unnötig schwerfällig wirken.

Siehe auch

• test-strategy.md
• pr-message-format.md
• commit-push-pr.md

Lizenz & Quelle

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

Lade …