Fix Issues

0.3 Baseline-Tests verifizieren

flutter test

• Tests MÜSSEN grün sein bevor du startest
• Falls Tests fehlschlagen: STOPP und User informieren

PHASE 1: TRIAGE

1.1 Priority-Sortierung

1.2 Duplikat-Erkennung

Prüfe .claude/bug-report.md auf bereits dokumentierte Duplikate:

• Gleiche Datei + gleiche Zeile = Duplikat
• Ähnliches Problem = zusammen fixen

1.3 Gruppierung

Bugs in der gleichen Datei sollten zusammen gefixt werden:

• Reduziert Commits
• Vermeidet Merge-Konflikte
• Effizientere Analyse

Beispiel-Gruppen:

Gruppe 1 (player_repository.dart):
  - SEC-006, SEC-007, SEC-008, SEC-009

Gruppe 2 (pending_players_page.dart):
  - SEC-001, SEC-002, FN-008/RT-005, RT-006, RT-007

1.4 User-Scope bestätigen

AskUserQuestion:
  question: "Welche Issues sollen bearbeitet werden?"
  options:
    - label: "Alle Issues"
      description: "Alle offenen Bug-Issues systematisch abarbeiten"
    - label: "Nur KRITISCH"
      description: "Nur Issues mit priority: critical"
    - label: "Auswahl"
      description: "Spezifische Issue-Nummern angeben"

Falls $ARGUMENTS bereits spezifische Issues enthält (z.B. #1 #2 #4), diesen Schritt überspringen.

PHASE 2: PARALLELE ANALYSE

2.1 Bug-Analyzer parallel starten

WICHTIG: Für JEDEN Bug/Gruppe PARALLEL einen Analyzer starten!

Task(
  subagent_type: "bug-analyzer",
  description: "Analyze Issue #X",
  prompt: "Analysiere Issue #X: [TITEL]. Details: [BODY]. Liefere: Root-Cause, betroffene Dateien, Fix-Ansatz.",
  run_in_background: true
)

Beispiel für mehrere Issues:

// Alle parallel starten!
Task(subagent_type: "bug-analyzer", prompt: "Issue #1...", run_in_background: true)
Task(subagent_type: "bug-analyzer", prompt: "Issue #2...", run_in_background: true)
Task(subagent_type: "bug-analyzer", prompt: "Issue #3...", run_in_background: true)

2.2 Ergebnisse aggregieren

Mit TaskOutput auf alle Analyzer warten und sammeln:

• Root-Cause pro Bug
• Betroffene Dateien
• Abhängigkeiten zwischen Bugs

2.3 Fix-Reihenfolge optimieren

Nach Analyse die Reihenfolge optimieren:

1. Bugs ohne Abhängigkeiten zuerst
2. Repository-Bugs vor UI-Bugs (Basis stabilisieren)
3. Gruppierte Bugs zusammen

PHASE 3: FIX-LOOP

3.1 Fix-Modus wählen (IMMER vor dem Loop!)

AskUserQuestion:
  question: "Welcher Fix-Modus?"
  options:
    - label: "Automatisch (Recommended)"
      description: "Läuft durch ohne Bestätigung, pausiert nur bei Fehlern"
    - label: "Interaktiv"
      description: "Bestätigung vor jedem Bug-Fix, maximale Kontrolle"
    - label: "Batch"
      description: "Bestätigung pro Gruppe (z.B. alle Security-Bugs zusammen)"

3.2 Tasks erstellen

Für jeden Bug/Gruppe einen Task erstellen:

TaskCreate(
  subject: "Fix #X: [KURZTITEL]",
  description: "Root-Cause: [CAUSE]. Fix: [APPROACH]. Datei: [FILE]",
  activeForm: "Fixe Issue #X"
)

3.3 TDD-Zyklus (pro Bug/Gruppe)

PFLICHT: Für JEDEN Bug den vollständigen Zyklus durchlaufen!

Schritt 1: Failing Test schreiben

// test/features/xxx/xxx_test.dart

test('sollte [erwartetes Verhalten] - Issue #X', () {
  // Arrange - Setup für den Bug-Fall

  // Act - Aktion die den Bug auslöst

  // Assert - Erwartetes korrektes Verhalten
  expect(actual, expected);
});

Schritt 2: Test MUSS rot sein

flutter test test/features/xxx/xxx_test.dart

• Falls grün: Test ist falsch oder Bug existiert nicht mehr

Schritt 3: Fix implementieren

• Minimaler Fix - nur was nötig ist
• Keine Refactorings "nebenbei"
• Keine zusätzlichen Features

Schritt 4: Test MUSS grün sein

flutter test test/features/xxx/xxx_test.dart

Schritt 5: Alle Tests grün

flutter test

• ALLE Tests müssen grün sein
• Keine Regressionen erlaubt

Schritt 6: Code-Analyse

dart analyze lib/

• Keine neuen Warnings erlaubt

Schritt 7: Flutter-Review (bei komplexen Fixes)

Task(
  subagent_type: "flutter-reviewer",
  prompt: "Review Bug-Fix für Issue #X. Geänderte Dateien: [LISTE]"
)

Bei kritischen Issues: STOPP und fixen!

Schritt 8: Commit mit Issue-Referenz

git add [geänderte Dateien]
git commit -m "$(cat <<'EOF'