Deep Debugging Skill

Kein blindes Fixen. Kein Raten. Erst beweisen, dann lösen.

Trigger-Wörter (Skill sofort laden)

Dieser Skill wird sofort aktiviert wenn der User eines dieser Wörter schreibt:

• debug, debugg, debugge, debugging
• bug, bugfix, buggy
• broken, kaputt, geht nicht, funktioniert nicht
• fehler, error, crash, absturz
• tief debuggen, tief analysieren, schau tiefer, such mal tiefer
• immer noch kaputt, immer noch ein fehler
• warum funktioniert X nicht, was ist falsch
• 401, 403, 500 (direkt als Nachricht)

Wenn du diesen Skill liest: STOPP.

Leg alle Fix-Ideen beiseite. Du wirst NICHTS ändern bevor du die Ursache zu 100% kennst.

PRE-PHASE — Quick Triage (30 Sekunden, IMMER zuerst)

Bevor du irgendwas analysierst — diese 5 Dinge in 30 Sekunden prüfen:

□ Server neu gestartet nach letzter Änderung?
□ ENV-Variablen korrekt gesetzt (auch in .env.local)?
□ npm install / yarn nach Package-Änderungen ausgeführt?
□ Datenbank-Migration gelaufen? (npx prisma migrate dev)
□ Browser-Cache geleert / Hard Reload (Ctrl+Shift+R)?

Wenn eines davon "Nein" → erst das fixen, dann weiter. Wenn alle "Ja" → weiter zu Phase 1.

PHASE 1 — Daten sammeln (nur beobachten, nichts anfassen)

Beantworte diese 4 Fragen mit echten Beweisen aus Logs/Code:

1. Was genau passiert?

• Exakte Fehlermeldung oder Stack Trace aus den Logs
• HTTP Status Code (401? 403? 500? Redirect?)
• Welcher Endpoint / welche Funktion / welcher Service ist betroffen
• Was sieht der User vs. was passiert im Backend

2. Wann passiert es?

• Immer oder nur manchmal?
• Nur bei bestimmten Usern / Rollen / Inputs?
• Seit wann — nach welchem Commit / welcher Änderung?
• Reproduzierbar in welchen Schritten genau?

3. Was sollte stattdessen passieren?

• Erwartetes Verhalten klar in einem Satz benennen
• Tatsächliches Verhalten klar in einem Satz benennen

4. Was wurde zuletzt geändert?

• Letzter relevanter Commit
• Neue ENV-Variablen, neue Abhängigkeiten, neue Migrationen?

→ STOPP. Erst wenn alle 4 Fragen beantwortet sind: weiter zu Phase 2.

PHASE 2 — Hypothese aufstellen (PFLICHT)

Formuliere EINE konkrete, testbare Hypothese bevor du irgendetwas anfasst:

"Der Fehler tritt auf weil [konkrete Ursache],
was ich beweise/widerlege indem ich [konkreter Test]."

Gute Hypothese:

"Der User wird rausgeworfen weil das JWT nach dem Login nicht 
korrekt im Cookie gesetzt wird, was ich beweise indem ich 
den Set-Cookie Header in der Login-Response in den Backend 
Logs überprüfe."

Schlechte Hypothese:

"Irgendwas stimmt mit der Auth nicht."
→ Zu vage. Nochmal. Konkrete Ursache benennen.

Melde die Hypothese bevor du weitermachst. Format: 🔬 HYPOTHESE: [deine Hypothese]

PHASE 3 — Binary Search (Fehler eingrenzen)