@the-bearded-bear/claude-craft 5.2.1 → 5.3.0-next.cc5a278

package/Dev/i18n/de/Common/commands/recette-fix.md

@@ -0,0 +1,287 @@
+---
+description: Automatisierte Fehlerbehebung aus QA Recette Sitzungen
+argument-hint: --session=<session-id> [--dry-run|--skip-fix|--severity=<level>|--auto-commit]
+---
+
+# QA Recette Fix - Automatisierte Fehlerbehebung
+
+Ergaenzung zu `/qa:recette`. Liest einen Recette-Sitzungsbericht, verfeinert jeden Fehler fuer die Verarbeitung, generiert Projektmanagement-Dokumente (BMAD Bug Stories, Backlog, Sprint), und startet dann die TDD-basierte Behebung fuer jeden Bug. Implementiert die **Goldene Regel**: Ein behobener Fehler darf NIE wieder auftreten.
+
+## Argumente
+
+**$ARGUMENTS**
+
+- `--session=<id>` : Recette-Sitzungs-ID (z.B. REC-20260130-143022) **[erforderlich]**
+- `--dry-run` : Fehler verfeinern und BMAD-Dokumente generieren ohne zu beheben
+- `--severity=<level>` : Nach Mindestschwere filtern (critical, high, medium, low)
+- `--skip-fix` : Nur Dokumente generieren, keine TDD-Behebung
+- `--auto-commit` : Automatischer Commit nach jeder Fehlerbehebung
+
+## Hauptfunktionen
+
+| Funktion | Beschreibung |
+|----------|--------------|
+| **Fehlerverfeinerung** | Analysiert die Ursache, reproduziert ueber Chrome wenn verfuegbar |
+| **Intelligente Gruppierung** | Dedupliziert Fehler nach gemeinsamer Ursache |
+| **BMAD-Dokumente** | Generiert Bug Stories, aktualisiert Backlog und Sprint |
+| **TDD-Behebung** | RED → GREEN → REFACTOR Workflow fuer jeden Bug |
+| **Regressionstests** | Automatische Generierung und Registeraktualisierung |
+| **Fortschrittsverfolgung** | fix-state.yaml fuer Fortsetzung und Monitoring |
+
+## 7-Phasen-Prozess
+
+```
+Recette-Sitzung (.recette/sessions/{id}/)
+        |
+        v
+  Phase 1: Sitzung und Fehler laden
+        |
+        v
+  Phase 2: Fehlerbeschreibungen verfeinern
+        |     - Ueber Chrome reproduzieren wenn noetig
+        |     - Ursache identifizieren
+        |     - Schwere klassifizieren
+        |
+        v
+  Phase 3: Nach Ursache gruppieren
+        |     - Deduplizierung
+        |     - Priorisierung
+        |
+        v
+  Phase 4: BMAD-Dokumente generieren
+        |     - Bug Stories (US-XXX-bug-YYY)
+        |     - Backlog aktualisieren
+        |     - sprint-status.yaml aktualisieren
+        |
+        v
+  Phase 5: TDD-Behebung pro Bug
+        |     - RED: Test der den Bug reproduziert
+        |     - GREEN: Minimale Behebung
+        |     - REFACTOR: Verbesserung
+        |
+        v
+  Phase 6: Verifizierung
+        |     - Alle Tests bestehen
+        |     - Regressionstests generiert
+        |     - Regressionsregister aktualisiert
+        |
+        v
+  Phase 7: Zusammenfassungsbericht
+```
+
+### Phase 1: Sitzung Laden
+
+```
+┌─────────────────────────────────────────┐
+│  1. load_session(session_id)            │
+│     - .recette/sessions/{id}/ lesen     │
+│     - state.yaml laden                  │
+│     - Fehler extrahieren (failed)       │
+│     - Screenshots/Logs laden            │
+└─────────────────────────────────────────┘
+```
+
+### Phase 2: Fehlerverfeinerung
+
+Fuer jeden erkannten Fehler:
+
+1. Screenshot/Log des Fehlers aus der Sitzung erneut lesen
+2. Wenn Chrome MCP verfuegbar: Fehler reproduzieren zur Bestaetigung
+3. Quellcode analysieren um Ursache zu identifizieren
+4. Beschreibung neu formulieren mit: aktuelles Verhalten, erwartetes Verhalten, betroffene Dateien, vermutete Ursache
+
+**Schweregradmatrix:**
+
+| Fehlertyp | Benutzerauswirkung | Haeufigkeit | Schweregrad |
+|-----------|-------------------|-------------|-------------|
+| security | Beliebig | Beliebig | critical |
+| logic | Blockierend | Beliebig | critical |
+| logic | Nicht-blockierend | Haeufig | high |
+| validation | Blockierend | Beliebig | high |
+| validation | Nicht-blockierend | Selten | medium |
+| interaction | Beliebig | Beliebig | high |
+| visual | Schwere Verschlechterung | Beliebig | medium |
+| visual | Kosmetisch | Beliebig | low |
+| api | 5xx-Fehler | Beliebig | critical |
+| api | Unerwarteter 4xx | Beliebig | high |
+
+### Phase 3: Gruppierung nach Ursache
+
+Mehrere Recette-Fehler koennen die gleiche Ursache haben:
+
+- Formularvalidierungsfehler + Nachrichtenanzeigefehler = gleiche Validierungskomponente
+- API-Fehler auf 3 Endpunkten = gleiche Authentifizierungs-Middleware
+
+Die Gruppierung erstellt **eine einzige Bug Story** pro Ursache statt einer pro Fehler.
+
+### Phase 4: BMAD-Dokumentgenerierung
+
+Fuer jeden gruppierten Bug:
+
+1. Bug Story aus dem Template `bug-story.md` generieren
+2. Zu `.bmad/sprint-status.yaml` mit Status `ready-for-dev` hinzufuegen
+3. Wenn ein Sprint aktiv ist: zum aktuellen Sprint hinzufuegen
+4. Sonst: zum Backlog hinzufuegen
+
+### Phase 5: TDD-Behebung
+
+Fuer jede Bug Story (nach Schweregrad sortiert):
+
+```
+┌──────────────────────────────────────────────┐
+│  BUG-001 (critical)                          │
+│                                              │
+│  1. RED   : Test schreiben der Bug           │
+│             reproduziert → MUSS fehlschlagen │
+│                                              │
+│  2. GREEN : Minimale Code-Behebung           │
+│             → Ausfuehren → MUSS bestehen     │
+│             → Alle Tests → Nicht-Regression  │
+│                                              │
+│  3. REFACTOR : Verbessern wenn noetig        │
+│             → Regressionstest generieren     │
+│             → Register aktualisieren         │
+│             → fix-state.yaml aktualisieren   │
+│                                              │
+│  4. COMMIT (wenn --auto-commit)              │
+│     fix({modul}): {desc} [recette:{session}] │
+└──────────────────────────────────────────────┘
+```
+
+**Generierte Testtypen nach Klassifizierung:**
+
+| Fehlertyp | Unit-Test | Funktionstest | Behat-Feature |
+|-----------|:---------:|:-------------:|:-------------:|
+| logic | X | | |
+| validation | X | X | |
+| api | | X | |
+| interaction | | | X |
+| visual | | | X |
+| security | X | X | |
+
+### Phase 6: Verifizierung
+
+1. Alle Projekttests ausfuehren
+2. Pruefen ob generierte Regressionstests in `.recette/regression/tests/` sind
+3. Pruefen ob `.recette/regression/registry.yaml` aktuell ist
+4. Pruefen ob fix-state.yaml den korrekten Zustand widerspiegelt
+
+### Phase 7: Zusammenfassungsbericht
+
+Generiert einen Zusammenfassungsbericht mit:
+
+- Gesamtzahl verarbeiteter Fehler
+- Anzahl gruppierter Bugs (nach Deduplizierung)
+- Erfolgreiche / fehlgeschlagene / uebersprungene Behebungen
+- Generierte Regressionstests
+- Durchgefuehrte Commits (wenn `--auto-commit`)
+
+## Fortschrittszustand (fix-state.yaml)
+
+```yaml
+# .recette/sessions/{id}/fix-state.yaml
+session_id: "REC-20260130-143022"
+started_at: "2026-01-31T10:00:00"
+status: "in-progress"  # pending | in-progress | completed | paused
+
+errors:
+  total: 8
+  grouped: 5
+  refined: 5
+  fixed: 3
+  skipped: 0
+  remaining: 2
+
+bugs:
+  - id: "BUG-001"
+    error_ids: ["ERR-001", "ERR-003"]
+    severity: critical
+    title: "Authentifizierung schlaegt nach Sitzungs-Timeout fehl"
+    story_id: "US-042-bug-001"
+    status: "fixed"  # pending | refining | documented | fixing | fixed | skipped
+    tdd_phase: "refactor"
+    fix_commit: "abc1234"
+    regression_test: "tests/Functional/Auth/SessionTimeoutTest.php"
+
+  - id: "BUG-002"
+    error_ids: ["ERR-002"]
+    severity: high
+    title: "Kontaktformular zeigt Validierungsfehler nicht an"
+    story_id: "US-042-bug-002"
+    status: "fixing"
+    tdd_phase: "green"
+    fix_commit: null
+    regression_test: null
+
+current_bug: "BUG-002"
+resume_from:
+  bug_id: "BUG-002"
+  phase: "green"
+```
+
+## Beispiele
+
+```bash
+# Alle Bugs einer Recette-Sitzung beheben
+/qa:recette-fix --session=REC-20260130-143022
+
+# Dry Run: verfeinern und dokumentieren ohne zu beheben
+/qa:recette-fix --session=REC-20260130-143022 --dry-run
+
+# Nur kritische und hohe Bugs beheben
+/qa:recette-fix --session=REC-20260130-143022 --severity=high
+
+# BMAD-Dokumente generieren ohne TDD zu starten
+/qa:recette-fix --session=REC-20260130-143022 --skip-fix
+
+# Beheben mit automatischem Commit
+/qa:recette-fix --session=REC-20260130-143022 --auto-commit
+```
+
+## Ausgabestruktur
+
+```
+.recette/sessions/{session-id}/
+├── state.yaml              # Recette-Sitzungszustand
+├── fix-state.yaml          # Behebungs-Fortschrittszustand
+├── screenshots/            # Fehler-Screenshots
+└── logs/                   # Detaillierte Logs
+
+.bmad/stories/
+├── US-042-bug-001.md       # BMAD Bug Story
+├── US-042-bug-002.md
+└── ...
+
+.recette/regression/
+├── registry.yaml           # Aktualisiertes Register
+└── tests/
+    ├── Unit/
+    ├── Functional/
+    └── Behat/
+```
+
+## Verwandte Befehle
+
+| Befehl | Beschreibung |
+|--------|--------------|
+| `/qa:recette` | Akzeptanztests ausfuehren |
+| `/qa:recette-status` | Sitzungsstatus anzeigen |
+| `/qa:recette-regression` | Regressionstests anzeigen |
+| `/qa:recette-report` | Bericht generieren |
+
+## Fehlermeldungen
+
+| Fehler | Loesung |
+|--------|---------|
+| "Sitzung nicht gefunden" | Ueberpruefen Sie die Sitzungs-ID in `.recette/sessions/` |
+| "Keine Fehler in der Sitzung" | Die Sitzung hat keine Fehler zu beheben |
+| "sprint-status.yaml nicht gefunden" | BMAD mit `/bmad:init` initialisieren |
+| "RED-Test schlaegt nicht fehl" | Bug existiert moeglicherweise nicht mehr, manuell pruefen |
+
+## Best Practices
+
+1. **Mit Dry-Run beginnen** : Verfeinerte Fehler und Dokumente vor der Behebung pruefen
+2. **Nach Schweregrad priorisieren** : Mit kritischen Bugs beginnen
+3. **Gruppierungen validieren** : Pruefen ob gruppierte Fehler wirklich die gleiche Ursache haben
+4. **Stories ueberpruefen** : Generierte Bug Stories vor TDD-Start pruefen
+5. **Auto-Commit verwenden** : Fuer eine saubere Behebungshistorie

package/Dev/i18n/de/Common/commands/recette.md

@@ -210,6 +210,7 @@ entries:
 
 | Befehl | Beschreibung |
 |--------|--------------|
+| `/qa:recette-fix` | Bugs aus einer Recette-Sitzung beheben |
 | `/qa:recette-status` | Sitzungsstatus anzeigen |
 | `/qa:recette-regression` | Regressionstests anzeigen |
 | `/qa:recette-report` | Bericht generieren |

package/Dev/i18n/de/Common/templates/bug-story.md

@@ -0,0 +1,65 @@
+# {BUG_ID}: [BUG] {TITEL}
+
+## Metadata
+
+- **ID**: {BUG_ID}
+- **Typ**: bug
+- **Quelle**: Recette {SESSION_ID}
+- **Quellfehler**: {ERROR_ID}
+- **Schweregrad**: {critical|high|medium|low}
+- **Sprint**: {SPRINT}
+- **Status**: backlog
+- **Datum**: {DATE}
+
+## Fehlerbeschreibung
+
+**Aktuelles Verhalten**: {verfeinerte Beschreibung des beobachteten Verhaltens}
+
+**Erwartetes Verhalten**: {Beschreibung des korrekten erwarteten Verhaltens}
+
+## Reproduktionsschritte
+
+1. {Schritt 1}
+2. {Schritt 2}
+3. {Schritt 3}
+
+## Ursache
+
+{Ursachenanalyse aus der Verfeinerung}
+
+## Akzeptanzkriterien
+
+### AC-1: Bug tritt nicht mehr auf
+
+```gherkin
+GIVEN {Kontext}
+WHEN {Aktion die den Bug ausgeloest hat}
+THEN {korrektes Verhalten}
+```
+
+### AC-2: Regressionstest besteht
+
+```gherkin
+GIVEN die Behebung ist vorhanden
+WHEN die Regressions-Suite ausgefuehrt wird
+THEN bestehen alle Tests
+```
+
+## Betroffene Dateien
+
+- {Datei 1}
+- {Datei 2}
+
+## Screenshots
+
+<!-- Screenshots aus der Recette-Sitzung wenn verfuegbar -->
+<!-- Pfad: .recette/sessions/{SESSION_ID}/screenshots/ -->
+
+## Definition of Done
+
+- [ ] RED-Test geschrieben (reproduziert den Bug)
+- [ ] GREEN-Behebung angewendet
+- [ ] Refactoring durchgefuehrt
+- [ ] Regressionstests generiert
+- [ ] Regressionsregister aktualisiert
+- [ ] Alle Tests bestehen

package/Dev/i18n/en/Common/commands/recette-fix.md

@@ -0,0 +1,287 @@
+---
+description: Automated bug fixing from QA Recette sessions
+argument-hint: --session=<session-id> [--dry-run|--skip-fix|--severity=<level>|--auto-commit]
+---
+
+# QA Recette Fix - Automated Bug Fixing
+
+Complement to `/qa:recette`. Reads a recette session/report, refines each error to make it actionable, generates project management documents (BMAD bug stories, backlog, sprint), then launches TDD-based fixing for each bug. Implements the **Golden Rule**: A fixed bug should NEVER reappear.
+
+## Arguments
+
+**$ARGUMENTS**
+
+- `--session=<id>`: Recette session ID (e.g., REC-20260130-143022) **[required]**
+- `--dry-run`: Refine errors and generate BMAD documents without fixing
+- `--severity=<level>`: Filter by minimum severity (critical, high, medium, low)
+- `--skip-fix`: Generate documents only, no TDD fixing
+- `--auto-commit`: Automatic commit after each bug fix
+
+## Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **Error Refinement** | Analyzes root cause, reproduces via Chrome if available |
+| **Smart Grouping** | Deduplicates errors by common root cause |
+| **BMAD Documents** | Generates bug stories, updates backlog and sprint |
+| **TDD Fixing** | RED -> GREEN -> REFACTOR workflow for each bug |
+| **Regression Tests** | Automatic generation and registry update |
+| **Progress Tracking** | fix-state.yaml for resume and monitoring |
+
+## 7-Phase Process
+
+```
+Recette session (.recette/sessions/{id}/)
+        |
+        v
+  Phase 1: Load session and errors
+        |
+        v
+  Phase 2: Refine error descriptions
+        |     - Reproduce via Chrome if needed
+        |     - Identify root cause
+        |     - Classify severity
+        |
+        v
+  Phase 3: Group by root cause
+        |     - Deduplication
+        |     - Prioritization
+        |
+        v
+  Phase 4: Generate BMAD documents
+        |     - Bug stories (US-XXX-bug-YYY)
+        |     - Update backlog
+        |     - Update sprint-status.yaml
+        |
+        v
+  Phase 5: TDD fix per bug
+        |     - RED: test reproducing the bug
+        |     - GREEN: minimal fix
+        |     - REFACTOR: improvement
+        |
+        v
+  Phase 6: Verification
+        |     - All tests pass
+        |     - Regression tests generated
+        |     - Regression registry updated
+        |
+        v
+  Phase 7: Summary report
+```
+
+### Phase 1: Session Loading
+
+```
+┌─────────────────────────────────────────┐
+│  1. load_session(session_id)            │
+│     - Read .recette/sessions/{id}/      │
+│     - Load state.yaml                   │
+│     - Extract errors (failed)           │
+│     - Load associated screenshots/logs  │
+└─────────────────────────────────────────┘
+```
+
+### Phase 2: Error Refinement
+
+For each detected error:
+
+1. Re-read the error screenshot/log from the session
+2. If Chrome MCP is available: reproduce the error to confirm
+3. Analyze source code to identify root cause
+4. Reformulate description with: actual behavior, expected behavior, affected files, suspected root cause
+
+**Severity Matrix:**
+
+| Error Type | User Impact | Frequency | Severity |
+|------------|-------------|-----------|----------|
+| security | Any | Any | critical |
+| logic | Blocking | Any | critical |
+| logic | Non-blocking | Frequent | high |
+| validation | Blocking | Any | high |
+| validation | Non-blocking | Rare | medium |
+| interaction | Any | Any | high |
+| visual | Major degradation | Any | medium |
+| visual | Cosmetic | Any | low |
+| api | 5xx error | Any | critical |
+| api | Unexpected 4xx | Any | high |
+
+### Phase 3: Root Cause Grouping
+
+Multiple recette errors can share the same root cause:
+
+- Form validation error + message display error = same validation component
+- API error on 3 endpoints = same authentication middleware
+
+Grouping creates **one bug story** per root cause instead of one per error.
+
+### Phase 4: BMAD Document Generation
+
+For each grouped bug:
+
+1. Generate bug story from `bug-story.md` template
+2. Add to `.bmad/sprint-status.yaml` with status `ready-for-dev`
+3. If a sprint is active: add to current sprint
+4. Otherwise: add to backlog
+
+### Phase 5: TDD Fixing
+
+For each bug story (by severity order):
+
+```
+┌──────────────────────────────────────────────┐
+│  BUG-001 (critical)                          │
+│                                              │
+│  1. RED   : Write test reproducing the bug   │
+│             → Execute → MUST fail            │
+│                                              │
+│  2. GREEN : Minimal code fix                 │
+│             → Execute → MUST pass            │
+│             → All tests → non-regression     │
+│                                              │
+│  3. REFACTOR : Improve if necessary          │
+│             → Generate regression test       │
+│             → Update registry                │
+│             → Update fix-state.yaml          │
+│                                              │
+│  4. COMMIT (if --auto-commit)                │
+│     fix({module}): {desc} [recette:{session}]│
+└──────────────────────────────────────────────┘
+```
+
+**Test types generated by classification:**
+
+| Error Type | Unit Test | Functional Test | Behat Feature |
+|------------|:---------:|:---------------:|:-------------:|
+| logic | X | | |
+| validation | X | X | |
+| api | | X | |
+| interaction | | | X |
+| visual | | | X |
+| security | X | X | |
+
+### Phase 6: Verification
+
+1. Run all project tests
+2. Verify generated regression tests are in `.recette/regression/tests/`
+3. Verify `.recette/regression/registry.yaml` is up to date
+4. Verify fix-state.yaml reflects correct state
+
+### Phase 7: Summary Report
+
+Generates a summary report with:
+
+- Total number of errors processed
+- Number of grouped bugs (after deduplication)
+- Successful / failed / skipped fixes
+- Regression tests generated
+- Commits made (if `--auto-commit`)
+
+## Progress State (fix-state.yaml)
+
+```yaml
+# .recette/sessions/{id}/fix-state.yaml
+session_id: "REC-20260130-143022"
+started_at: "2026-01-31T10:00:00"
+status: "in-progress"  # pending | in-progress | completed | paused
+
+errors:
+  total: 8
+  grouped: 5
+  refined: 5
+  fixed: 3
+  skipped: 0
+  remaining: 2
+
+bugs:
+  - id: "BUG-001"
+    error_ids: ["ERR-001", "ERR-003"]
+    severity: critical
+    title: "Authentication fails after session timeout"
+    story_id: "US-042-bug-001"
+    status: "fixed"  # pending | refining | documented | fixing | fixed | skipped
+    tdd_phase: "refactor"
+    fix_commit: "abc1234"
+    regression_test: "tests/Functional/Auth/SessionTimeoutTest.php"
+
+  - id: "BUG-002"
+    error_ids: ["ERR-002"]
+    severity: high
+    title: "Contact form does not display validation errors"
+    story_id: "US-042-bug-002"
+    status: "fixing"
+    tdd_phase: "green"
+    fix_commit: null
+    regression_test: null
+
+current_bug: "BUG-002"
+resume_from:
+  bug_id: "BUG-002"
+  phase: "green"
+```
+
+## Examples
+
+```bash
+# Fix all bugs from a recette session
+/qa:recette-fix --session=REC-20260130-143022
+
+# Dry run: refine and document without fixing
+/qa:recette-fix --session=REC-20260130-143022 --dry-run
+
+# Fix only critical and high severity bugs
+/qa:recette-fix --session=REC-20260130-143022 --severity=high
+
+# Generate BMAD documents without launching TDD
+/qa:recette-fix --session=REC-20260130-143022 --skip-fix
+
+# Fix with automatic commits
+/qa:recette-fix --session=REC-20260130-143022 --auto-commit
+```
+
+## Output Structure
+
+```
+.recette/sessions/{session-id}/
+├── state.yaml              # Recette session state
+├── fix-state.yaml          # Fix progress state
+├── screenshots/            # Error screenshots
+└── logs/                   # Detailed logs
+
+.bmad/stories/
+├── US-042-bug-001.md       # BMAD bug story
+├── US-042-bug-002.md
+└── ...
+
+.recette/regression/
+├── registry.yaml           # Updated registry
+└── tests/
+    ├── Unit/
+    ├── Functional/
+    └── Behat/
+```
+
+## Related Commands
+
+| Command | Description |
+|---------|-------------|
+| `/qa:recette` | Execute acceptance tests |
+| `/qa:recette-status` | Show session status |
+| `/qa:recette-regression` | View regression tests |
+| `/qa:recette-report` | Generate report |
+
+## Error Messages
+
+| Error | Solution |
+|-------|----------|
+| "Session not found" | Verify session ID in `.recette/sessions/` |
+| "No errors in session" | Session has no errors to fix |
+| "sprint-status.yaml not found" | Initialize BMAD with `/bmad:init` |
+| "RED test does not fail" | Bug may no longer exist, check manually |
+
+## Best Practices
+
+1. **Start with dry-run**: Verify refined errors and documents before fixing
+2. **Prioritize by severity**: Start with critical bugs
+3. **Validate groupings**: Verify grouped errors truly share the same cause
+4. **Review stories**: Check generated bug stories before launching TDD
+5. **Use auto-commit**: To keep a clean history of fixes

package/Dev/i18n/en/Common/commands/recette.md

@@ -210,6 +210,7 @@ entries:
 
 | Command | Description |
 |---------|-------------|
+| `/qa:recette-fix` | Fix bugs from a recette session |
 | `/qa:recette-status` | Show session status |
 | `/qa:recette-regression` | View regression tests |
 | `/qa:recette-report` | Generate report |