# Portabilitaet: UNIVERSAL
# Zuletzt validiert: 2026-01-28 (Gemini)
# Naechste Pruefung: 2027-01-28
# Quellen: [skills/_protocols/bugfix-protokoll.md]

BUGFIX PROTOKOLL WORKFLOW
=========================

Stand: 2026-01-28

WAS IST DER BUGFIX PROTOKOLL WORKFLOW?
--------------------------------------
Dieses Protokoll definiert ein systematisches Vorgehen zur Analyse, Diagnose und Behebung von Softwarefehlern (Bugs), insbesondere in Python/PyQt6 Projekten. Es dient dazu, Zeit zu sparen und strukturiert vorzugehen.

PHASEN DES PROTOKOLLS
---------------------
1. **Schnell-Check (< 2 Min):**
   - Analyse der Fehlermeldung und Exit-Codes.
   - Erkennung typischer Muster (z.B. Access Violation bei PyQt6).

2. **Diagnose mit DEV_TOOLS (2-10 Min):**
   - Nutzung vordefinierter Skripte (`c_import_diagnose.py`, `c_method_analyzer.py`).
   - Pruefung auf Import-Fehler, undefinierte Attribute und Syntax.

3. **Isoliertes Testen (5-15 Min):**
   - Erstellung minimaler Reproduktions-Skripte.
   - Schrittweise Eingrenzung des Fehlers.

4. **Websuche:**
   - Gezielte Suche nach Fehlermeldungen bei StackOverflow oder GitHub Issues.

5. **Tool-Entwicklung:**
   - Bei wiederkehrenden Problemen: Erstellung eines Diagnose-Tools.

6. **Exit-Strategie:**
   - 20-Minuten-Regel: Kein Fortschritt nach 20 Min -> Stopp und Dokumentation.

WICHTIGE PYQT6 FALLEN
---------------------
Das Protokoll hebt spezifische PyQt6-Probleme hervor:
- **QObject Singleton:** Darf nicht in `__new__` erstellt werden (Access Violation).
- **QApplication:** Muss immer VOR anderen QObjects initialisiert werden.
- **Race Conditions:** Signale nicht verbinden, bevor Objekte existieren.

DOKUMENTATION
-------------
Ergebnisse werden in Bug-Reports (`BUGREPORT_[datum]_[kurzname].md`) festgehalten.

SIEHE AUCH
----------
skills/_protocols/bugfix-protokoll.md   Vollstaendiges Protokoll
