@the-bearded-bear/claude-craft 8.23.3 → 8.26.0-next.2a54921

package/Dev/i18n/de/Common/commands/pre-merge-check.md

@@ -1,237 +1,9 @@
 ---
-description: Pre-Merge-Überprüfung
-argument-hint: [arguments]
+description: "Veraltet (Entfernung in 9.0): /gate:check merge verwenden"
+deprecated: true
+replaced-by: /gate:check
 ---
 
-# Pre-Merge-Überprüfung
+> ⚠️ `/common:pre-merge-check` ist veraltet und wird in 9.0 entfernt. Verwenden Sie `/gate:check merge`.
 
-Sie sind ein Code-Qualitäts-Assistent. Sie müssen alle notwendigen Überprüfungen VOR dem Mergen eines Branches durchführen, um Qualität sicherzustellen und Regressionen zu vermeiden.
-
-## Argumente
-$ARGUMENTS
-
-Erwartete Argumente:
-- Quell-Branch (Standard: aktueller Branch)
-- Ziel-Branch (Standard: main oder master)
-
-Beispiel: `/common:pre-merge-check feature/auth main`
-
-## MISSION
-
-### Schritt 1: Diff analysieren
-
-```bash
-# Branches identifizieren
-SOURCE_BRANCH=$(git branch --show-current)
-TARGET_BRANCH=${2:-main}
-
-# Zu mergende Commits
-git log $TARGET_BRANCH..$SOURCE_BRANCH --oneline
-
-# Geänderte Dateien
-git diff $TARGET_BRANCH...$SOURCE_BRANCH --stat
-
-# Hinzugefügte/entfernte Zeilen
-git diff $TARGET_BRANCH...$SOURCE_BRANCH --shortstat
-```
-
-### Schritt 2: Qualitätsprüfungen
-
-#### 2.1 Vollständige Tests
-```bash
-# ALLE Tests ausführen
-# Symfony
-docker compose exec php vendor/bin/phpunit --coverage-text
-
-# Flutter
-docker run --rm -v $(pwd):/app -w /app dart flutter test --coverage
-
-# Python
-docker compose exec app pytest --cov --cov-report=term
-
-# React/RN
-docker compose exec node npm run test -- --coverage
-```
-
-#### 2.2 Vollständige statische Analyse
-```bash
-# PHPStan (max Level)
-docker compose exec php vendor/bin/phpstan analyse -l max
-
-# Dart Analyzer
-docker run --rm -v $(pwd):/app -w /app dart dart analyze --fatal-infos
-
-# Mypy (strict)
-docker compose exec app mypy --strict .
-
-# TypeScript
-docker compose exec node npx tsc --noEmit
-```
-
-#### 2.3 Dependencies prüfen
-```bash
-# Sicherheits-Audit
-# PHP
-docker compose exec php composer audit
-
-# Python
-docker compose exec app pip-audit
-
-# Node
-docker compose exec node npm audit
-
-# Flutter
-docker run --rm -v $(pwd):/app -w /app dart dart pub outdated
-```
-
-### Schritt 3: Spezifische Überprüfungen
-
-#### DB-Migrationen (falls vorhanden)
-```bash
-# Doctrine-Migrationen prüfen
-git diff $TARGET_BRANCH...$SOURCE_BRANCH -- migrations/
-
-# Falls Migrationen vorhanden
-docker compose exec php php bin/console doctrine:migrations:diff --no-interaction
-docker compose exec php php bin/console doctrine:schema:validate
-```
-
-#### API Breaking Changes
-```bash
-# OpenAPI-Specs vergleichen
-git diff $TARGET_BRANCH...$SOURCE_BRANCH -- openapi.yaml docs/api/
-```
-
-#### Konfigurationsänderungen
-```bash
-# Geänderte Config-Dateien
-git diff $TARGET_BRANCH...$SOURCE_BRANCH -- config/ .env.example docker-compose*.yml
-```
-
-### Schritt 4: Commit-Analyse
-
-```bash
-# Commit-Nachrichten prüfen
-git log $TARGET_BRANCH..$SOURCE_BRANCH --pretty=format:"%s" | while read msg; do
-    # Conventional-Muster: type(scope): beschreibung
-    if ! echo "$msg" | grep -qE "^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .+"; then
-        echo "⚠️ Nicht-konventionelle Nachricht: $msg"
-    fi
-done
-```
-
-### Schritt 5: Coverage-Prüfung
-
-```bash
-# Coverage vorher/nachher vergleichen
-# Coverage sollte nicht sinken
-```
-
-### Schritt 6: Bericht generieren
-
-```
-══════════════════════════════════════════════════════════════
-🔀 PRE-MERGE-ÜBERPRÜFUNG
-══════════════════════════════════════════════════════════════
-
-📌 Quelle: feature/user-auth
-📌 Ziel: main
-📅 Datum: YYYY-MM-DD HH:MM
-
-──────────────────────────────────────────────────────────────
-📊 STATISTIKEN
-──────────────────────────────────────────────────────────────
-
-Commits: 12
-Geänderte Dateien: 45
-Hinzugefügte Zeilen: +1.234
-Entfernte Zeilen: -567
-
-──────────────────────────────────────────────────────────────
-🧪 TESTS
-──────────────────────────────────────────────────────────────
-
-| Suite | Tests | Bestanden | Fehlgeschlagen | Übersprungen |
-|-------|-------|-----------|----------------|--------------|
-| Unit  | 234   | 234       | 0              | 0            |
-| Integ | 45    | 45        | 0              | 0            |
-| E2E   | 12    | 12        | 0              | 0            |
-
-Coverage: 85.2% (vorher: 84.8%) ✅ +0.4%
-
-──────────────────────────────────────────────────────────────
-🔍 STATISCHE ANALYSE
-──────────────────────────────────────────────────────────────
-
-| Tool | Fehler | Warnungen | Status |
-|-------|---------|-----------|--------|
-| PHPStan | 0 | 2 | ✅ |
-| ESLint | 0 | 5 | ⚠️ |
-| Mypy | 0 | 0 | ✅ |
-
-──────────────────────────────────────────────────────────────
-🔒 SICHERHEIT
-──────────────────────────────────────────────────────────────
-
-Dependencies-Audit: ✅ Keine Schwachstellen
-Secrets erkannt: ✅ Keine
-Sensible Dateien: ✅ Keine
-
-──────────────────────────────────────────────────────────────
-📦 MIGRATIONEN
-──────────────────────────────────────────────────────────────
-
-Neue Migrationen: 2
-  - Version20240115_AddUserRoles.php
-  - Version20240116_CreateAuditLog.php
-
-Schema-Validierung: ✅ OK
-Rollback möglich: ✅ Ja
-
-──────────────────────────────────────────────────────────────
-⚠️ AUFMERKSAMKEITSPUNKTE
-──────────────────────────────────────────────────────────────
-
-1. [MITTEL] 5 ESLint-Warnungen zu beheben
-2. [NIEDRIG] 2 TODOs im Code hinzugefügt
-3. [INFO] 2 neue Migrationen - zuerst in Staging überprüfen
-
-──────────────────────────────────────────────────────────────
-📋 FINALE CHECKLISTE
-──────────────────────────────────────────────────────────────
-
-- [x] Alle Tests bestehen
-- [x] Coverage beibehalten oder verbessert
-- [x] Keine Fehler in statischer Analyse
-- [x] Keine Sicherheitslücken
-- [x] Keine Secrets committed
-- [ ] Code Review genehmigt (manuell prüfen)
-- [ ] In Staging getestet (manuell prüfen)
-
-──────────────────────────────────────────────────────────────
-🎯 URTEIL
-──────────────────────────────────────────────────────────────
-
-Merge autorisiert: ✅ JA
-
-Empfehlungen vor Merge:
-1. 5 ESLint-Warnungen beheben
-2. Migrationen in Staging testen
-3. Code-Review-Genehmigung einholen
-```
-
-## Blockierungsregeln
-
-### Blockierend (Merge verboten)
-- ❌ Fehlgeschlagene Tests
-- ❌ Signifikanter Coverage-Rückgang (> 2%)
-- ❌ Fehler in statischer Analyse
-- ❌ Kritische/hohe Schwachstellen
-- ❌ Secrets im Code
-- ❌ Nicht umkehrbare Migrationen
-
-### Nicht-blockierend (Warnung)
-- ⚠️ Warnungen in statischer Analyse
-- ⚠️ TODO/FIXME hinzugefügt
-- ⚠️ Niedrige/mittlere Schwachstellen
-- ⚠️ Leicht gesunkene Coverage (< 2%)
+Führen Sie `/gate:check merge $ARGUMENTS` aus: Lesen Sie `.claude/commands/gate/check.md` und folgen Sie der Datei mit diesen Argumenten. Fehlt diese Datei, installieren Sie claude-craft mit Projektmanagement neu.

package/Dev/i18n/de/Common/commands/ralph-run.md

@@ -76,6 +76,35 @@ Das DoD-System validiert den Abschluss über mehrere Kriterien:
 | `hook` | Bestehenden Claude-Hook ausführen |
 | `human` | Interaktive menschliche Validierung |
 
+#### Grenze des `command`-Validators → `type: hook` verwenden
+
+`type: command` führt nur Befehle aus, die die Allowlist in `Tools/Ralph/lib/dod-validator.sh` bestehen: Buchstaben, Ziffern, Leerzeichen und `_ . / " ' -`. Jeder Befehl mit `=`, `|`, `&` oder `:` (sowie `;`, `>`, `$` usw.) wird mit `ERROR: Invalid command` abgelehnt: Das Kriterium wird dann **nie** erfüllt und die Schleife läuft, bis der Circuit Breaker auslöst.
+
+| Abgelehnter Befehl | Problematisches Zeichen |
+|--------------------|-------------------------|
+| `dotnet build /p:TreatWarningsAsErrors=true` | `:` und `=` |
+| `npm test && npm run lint` | `&` |
+| `pytest \| tee out.log` | `\|` |
+
+In diesen Fällen den Befehl in ein Skript auslagern und als `type: hook` deklarieren:
+
+```yaml
+definition_of_done:
+  checklist:
+    - id: build
+      type: hook
+      script: ".ralph/dod/build.sh"
+      required: true
+```
+
+```bash
+#!/usr/bin/env bash
+# .ralph/dod/build.sh — erhält {"cwd": ..., "output": ...} als JSON über stdin
+dotnet build /p:TreatWarningsAsErrors=true || exit 2
+```
+
+Das Skript gibt `0` (Kriterium erfüllt) oder `2` (Kriterium fehlgeschlagen) zurück. Gelesene Schlüssel je Typ: `command` → `command:`, `output_contains` und `file_changed` → `pattern:`, `hook` → `script:`, `human` → `prompt:`.
+
 ### 4. Adaptiver Circuit Breaker (v2.0)
 
 Wählt automatisch das Profil basierend auf Aufgaben-Schlüsselwörtern:
@@ -100,6 +129,23 @@ Claude arbeitet...
 Stop → stop-dod-gate.sh → Blockieren, wenn DoD nicht erfüllt (exit 2)
 ```
 
+## /goal (interaktiv) oder Ralph (autonom/CI)?
+
+`/goal` ist ein nativer Claude-Code-Befehl, der in einer Sitzung eingegeben wird: Er ist keine Option von `ralph.sh` — `ralph.sh` bietet dafür keine an und erzeugt nie ein `/goal`. Beide Werkzeuge ergänzen sich:
+
+| Kriterium | `/goal` (nativ) | Ralph (`ralph.sh`) |
+|-----------|-----------------|--------------------|
+| Abschlussprüfung | LLM-Urteil: Ein kleines, schnelles Modell bewertet nach jedem Zug, was in der Konversation sichtbar ist — es führt keinen Befehl aus und liest keine Datei | Deterministisch: Befehle, Muster und Hooks, ausgeführt von `dod-validator.sh` |
+| Iterationsobergrenze | Keine feste Grenze: Ende, wenn die Bedingung erfüllt oder als unmöglich bewertet ist, bei `/goal clear` oder wenn Claude mehrere Züge in Folge ohne Werkzeug antwortet; eine Grenze kann in die Bedingung geschrieben werden | `max_iterations` + adaptiver Circuit Breaker |
+| Headless / CI | `claude -p "/goal ..."` läuft in einem einzigen Aufruf bis zum Ende; CI-Nutzung nicht dokumentiert | Dafür gebaut: autonome Läufe (`--autonomous`, `--overnight`), `headless`-Dashboard |
+| `disableAllHooks: true` | Nicht verfügbar: `/goal` umhüllt einen sitzungsbezogenen Stop-Hook (ebenso mit `allowManagedHooksOnly`) | Schleife und DoD laufen in `ralph.sh`; nur die Hooks-Integration (`stop-dod-gate.sh`) ist deaktiviert |
+| Konfiguration | Keine; ein Goal pro Sitzung, durch `/clear` gelöscht | `ralph.yml` |
+
+- **`/goal` wählen** für eine interaktive Aufgabe, deren Abschluss in der Konversation sichtbar wird (Testausgabe anzeigen: Der Evaluator führt die Tests nicht aus).
+- **Ralph wählen**, wenn der Abschluss durch Befehle belegt werden muss, mit Iterationsobergrenze, unbeaufsichtigt oder in CI.
+
+Referenz: [`/goal`-Dokumentation](https://code.claude.com/docs/en/goal).
+
 ## Schnellstart-Beispiele
 
 ```bash
@@ -275,4 +321,4 @@ Wenn ein Timeout ausgelöst wird:
 
 - `@ralph-conductor` - Agent für Ralph-Orchestrierung
 - `/qa:tdd` - TDD-basierte Fehlerbehebung
-- `/sprint:dev` - Sprint-Entwicklung mit TDD
+- `/workflow:implement` - Sprint-Entwicklung mit TDD

package/Dev/i18n/de/Common/commands/release-checklist.md

@@ -1,245 +1,9 @@
 ---
-description: Release-Checkliste
-argument-hint: [arguments]
+description: "Veraltet (Entfernung in 9.0): /gate:check release verwenden"
+deprecated: true
+replaced-by: /gate:check
 ---
 
-# Release-Checkliste
+> ⚠️ `/common:release-checklist` ist veraltet und wird in 9.0 entfernt. Verwenden Sie `/gate:check release`.
 
-Sie sind ein erfahrener Release Manager. Sie müssen das Team durch alle Schritte eines qualitativ hochwertigen Releases führen und jeden kritischen Punkt überprüfen.
-
-## Argumente
-$ARGUMENTS
-
-Argumente:
-- Version (z.B. `1.2.0`, `2.0.0-beta.1`)
-- Typ (patch, minor, major)
-
-Beispiel: `/common:release-checklist 1.2.0 minor`
-
-## MISSION
-
-### Schritt 1: Pre-Release-Validierung
-
-#### 1.1 Code-Zustand
-```bash
-# Auf richtigem Branch überprüfen
-git branch --show-current  # Muss main/master oder release/* sein
-
-# Auf keine uncommitted Änderungen überprüfen
-git status
-
-# Überprüfen, dass alle Tests bestehen
-# [Tests je nach Technologie ausführen]
-```
-
-#### 1.2 Changelog
-```bash
-# Überprüfen, dass CHANGELOG.md aktuell ist
-cat CHANGELOG.md | head -50
-
-# Changelog seit letztem Tag generieren
-git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"- %s"
-```
-
-#### 1.3 Versions-Dateien
-```bash
-# Versions-Dateien prüfen/aktualisieren
-# PHP: composer.json
-# Python: pyproject.toml, __version__.py
-# Node: package.json
-# Flutter: pubspec.yaml
-# iOS: Info.plist
-# Android: build.gradle
-```
-
-### Schritt 2: Umfassende Tests
-
-```bash
-# Unit Tests
-# Integrationstests
-# E2E-Tests
-# Performance-Tests
-# Sicherheitstests
-```
-
-### Schritt 3: Dokumentation
-
-```bash
-# Dokumentation überprüfen
-# - README aktuell
-# - API-Docs generiert
-# - Migrationsanleitung (bei Breaking Changes)
-```
-
-### Schritt 4: Interaktive Checkliste generieren
-
-```
-══════════════════════════════════════════════════════════════
-🚀 RELEASE-CHECKLISTE - v{VERSION}
-══════════════════════════════════════════════════════════════
-
-Typ: {TYPE} (patch/minor/major)
-Datum: YYYY-MM-DD
-Branch: main
-
-══════════════════════════════════════════════════════════════
-📋 PRE-RELEASE
-══════════════════════════════════════════════════════════════
-
-## Code-Qualität
-- [ ] Alle Tests bestehen (Unit, Integration, E2E)
-- [ ] Test-Coverage ≥ 80%
-- [ ] Statische Analyse ohne Fehler
-- [ ] Code Review auf allen PRs abgeschlossen
-- [ ] Keine blockierenden TODO/FIXME
-
-## Sicherheit
-- [ ] Dependencies-Audit (keine kritischen CVEs)
-- [ ] Keine Secrets im Code
-- [ ] Sicherheitstests bestanden (OWASP)
-- [ ] Gültige SSL-Zertifikate
-
-## Dokumentation
-- [ ] CHANGELOG.md aktualisiert
-- [ ] README.md aktuell
-- [ ] API-Dokumentation generiert
-- [ ] Migrationsanleitung (bei Breaking Changes)
-- [ ] Release Notes geschrieben
-
-## Versionierung
-- [ ] Versionsnummer erhöht
-- [ ] Git-Tags vorbereitet
-- [ ] Release-Branches erstellt (falls zutreffend)
-
-══════════════════════════════════════════════════════════════
-📦 BUILD & PACKAGE
-══════════════════════════════════════════════════════════════
-
-## Backend
-- [ ] Produktions-Build erfolgreich
-- [ ] Assets kompiliert und minifiziert
-- [ ] DB-Migrationen vorbereitet
-- [ ] Umgebungsvariablen dokumentiert
-
-## Frontend Web
-- [ ] Bundle optimiert (Code Splitting, Tree Shaking)
-- [ ] Assets CDN-bereit
-- [ ] Service Worker aktualisiert
-- [ ] Sourcemaps generiert (aber nicht in Prod deployt)
-
-## Mobile (falls zutreffend)
-- [ ] iOS-Build signiert
-- [ ] Android-Build signiert
-- [ ] Store-Screenshots aktualisiert
-- [ ] Store-Metadaten bereit
-
-══════════════════════════════════════════════════════════════
-🔧 STAGING-VALIDIERUNG
-══════════════════════════════════════════════════════════════
-
-- [ ] Staging-Deployment erfolgreich
-- [ ] DB-Migrationen erfolgreich ausgeführt
-- [ ] Manuelle Smoke-Tests OK
-- [ ] Regressionstests bestanden
-- [ ] Akzeptable Performance (< definierte Schwellenwerte)
-- [ ] Monitoring funktioniert (Logs, Metriken)
-- [ ] Rollback getestet
-
-══════════════════════════════════════════════════════════════
-🚀 PRODUKTIONS-DEPLOYMENT
-══════════════════════════════════════════════════════════════
-
-## Pre-Deploy
-- [ ] Wartungsmodus aktiviert (falls notwendig)
-- [ ] Datenbank-Backup durchgeführt
-- [ ] Support-Team-Kommunikation
-- [ ] Deployment-Fenster validiert
-
-## Deploy
-- [ ] Produktions-Deployment gestartet
-- [ ] DB-Migrationen ausgeführt
-- [ ] Health Checks bestehen
-- [ ] Wartungsmodus deaktiviert
-
-## Post-Deploy
-- [ ] Produktions-Smoke-Tests OK
-- [ ] Monitoring überprüft (keine Fehler)
-- [ ] Nominale Performance
-- [ ] Git-Tag erstellt und gepusht
-- [ ] GitHub/GitLab Release erstellt
-
-══════════════════════════════════════════════════════════════
-📢 KOMMUNIKATION
-══════════════════════════════════════════════════════════════
-
-- [ ] Release Notes veröffentlicht
-- [ ] Support-Team informiert
-- [ ] Kunden benachrichtigt (falls zutreffend)
-- [ ] Öffentliche Dokumentation aktualisiert
-- [ ] Blog/Social-Media-Ankündigung (falls zutreffend)
-
-══════════════════════════════════════════════════════════════
-🔙 ROLLBACK-PLAN
-══════════════════════════════════════════════════════════════
-
-Bei kritischem Problem:
-
-1. Problem identifizieren
-   - Logs: [Monitoring-URL]
-   - Alerts: [Alerting-URL]
-
-2. Rollback-Entscheidung
-   - Schwellenwert: > 5% 5xx Fehler für 5 Min
-   - Entscheidungsträger: [Name]
-
-3. Rollback ausführen
-   ```bash
-   # Rollback-Befehl
-   [An Infrastruktur anpassen]
-   ```
-
-4. DB-Rollback (falls notwendig)
-   ```bash
-   # Migrationen down
-   [An ORM anpassen]
-   ```
-
-5. Kommunikation
-   - Team benachrichtigen
-   - Vorfall öffnen
-   - Post-Mortem
-
-══════════════════════════════════════════════════════════════
-✅ FINALE VALIDIERUNG
-══════════════════════════════════════════════════════════════
-
-[ ] Alle Kästchen angekreuzt
-[ ] Release validiert von: _______________
-[ ] Release-Datum/-Zeit: _______________
-
-Notizen:
-_________________________________________________
-_________________________________________________
-```
-
-## Nützliche Befehle
-
-```bash
-# Tag erstellen
-git tag -a v{VERSION} -m "Release v{VERSION}"
-git push origin v{VERSION}
-
-# GitHub Release erstellen
-gh release create v{VERSION} --title "v{VERSION}" --notes-file RELEASE_NOTES.md
-
-# Automatisches Changelog generieren
-git-cliff --unreleased --tag v{VERSION} > CHANGELOG.md
-```
-
-## Erinnerung an Semantic Versioning
-
-| Typ | Wann | Beispiel |
-|------|-------|---------|
-| MAJOR | Breaking Changes | 1.0.0 → 2.0.0 |
-| MINOR | Neue Funktion | 1.0.0 → 1.1.0 |
-| PATCH | Bugfix | 1.0.0 → 1.0.1 |
+Führen Sie `/gate:check release $ARGUMENTS` aus: Lesen Sie `.claude/commands/gate/check.md` und folgen Sie der Datei mit diesen Argumenten. Fehlt diese Datei, installieren Sie claude-craft mit Projektmanagement neu.