Claude-Code-Bug-Report-Vorlage: Aus vagen Fehlern reproduzierbare Fixes machen

Debugging mit Claude Code beginnt mit dem Bug Report

“Geht nicht” zwingt Claude Code zum Raten. Ein guter Bug Report enthält Symptom, Reproduktion, erwartetes Ergebnis, tatsächliches Ergebnis, Grenzen und Prüfung.

Nutze ihn nach dem First-Task-Runbook und zusammen mit der Handoff-Vorlage, wenn Kontext weitergegeben wird.

Vorlage zum Kopieren

Ziel:
- Zu behebender Bug:
- Nicht Teil der Aufgabe:

Umgebung:
- OS / browser / runtime:
- branch:
- relevante Befehle:

Reproduktion:
1.
2.
3.

Erwartetes Ergebnis:
-

Tatsächliches Ergebnis:
-

Logs oder Screenshots:
-

Grenzen:
- erlaubte Dateien:
- verbotene Dateien:
- keine externen Dienste:

Prüfung:
- build/test:
- visuell zu prüfende URL:

Bitte an Claude Code:
Grenze zuerst die Ursache auf 3 Hypothesen ein.
Nenne Minimalfix, Dateien und Prüfschritte. Vor Freigabe nicht editieren.

Gutes Beispiel

Bug:
Auf Mobile läuft der Pricing-CTA rechts aus dem Viewport.

Reproduktion:
1. /en/products/ mit 390px Breite öffnen
2. Bis zur pricing card scrollen
3. Rechter Rand des CTA liegt außerhalb des Viewports

Prüfung:
npm.cmd run build
Playwright-Screenshot bei 390px

Schlechtes Beispiel

Die Seite ist komisch. Bitte fixen.

Es fehlen Umfang, Erfolgskriterium und Grenzen.

Check vor dem Senden

• Dauert die Reproduktion weniger als 3 Minuten
• Ist Erfolg per Befehl oder Screenshot prüfbar
• Sind verbotene Dateien genannt
• Gibt es Logs, URL oder Screenshot

Nächster Schritt

Halte Befehle im kostenlosen Cheatsheet fest. Für Debugging-Prompts nutze 50 Prompt Templates. Für Team-Prozesse siehe Beratung.

In der Praxis Untersuchung und Fix trennen

Der häufige Fehler ist ein Patch, bevor die Ursache eingegrenzt wurde. Stabiler ist: reproduzieren, Hypothesen bilden, Minimalfix anwenden. So bleibt jeder Schritt reviewbar.

Untersuche diesen Bug Report, ohne schon zu editieren.
1. ist er reproduzierbar
2. 3 Ursachenhypothesen
3. wahrscheinlichster Codebereich
4. Dateien, die vor dem Fix gelesen werden müssen
5. reicht ein Minimalfix oder braucht es Designänderung

Wenn “nicht reproduzierbar”, “Logs fehlen” oder “Scope zu groß” herauskommt, nicht fixen. Ein guter Bug Report baut eine prüfbare Untersuchungsreihenfolge.