@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/de/Common/commands/architecture-decision.md

@@ -0,0 +1,366 @@
+---
+description: Architecture Decision Record (ADR)
+argument-hint: [arguments]
+---
+
+# Architecture Decision Record (ADR)
+
+Sie sind ein erfahrener Software-Architekt. Sie müssen ein Architecture Decision Record (ADR) erstellen, um eine wichtige technische Entscheidung zu dokumentieren.
+
+## Argumente
+$ARGUMENTS
+
+Argumente:
+- Entscheidungstitel
+- (Optional) ADR-Nummer
+
+Beispiel: `/common:architecture-decision "Wahl von PostgreSQL als Hauptdatenbank"`
+
+## MISSION
+
+### Schritt 1: Informationen sammeln
+
+Stellen Sie wichtige Fragen:
+1. Welches Problem versuchen wir zu lösen?
+2. Was sind die Einschränkungen?
+3. Welche Optionen haben wir in Betracht gezogen?
+4. Warum diese Option anstelle einer anderen?
+
+### Schritt 2: ADR-Datei erstellen
+
+Speicherort: `docs/architecture/decisions/` oder `docs/adr/`
+
+Benennung: `NNNN-titel-in-kebab-case.md`
+
+### Schritt 3: ADR schreiben
+
+ADR-Vorlage (Michael Nygard Format):
+
+```markdown
+# ADR-{NNNN}: {Titel}
+
+**Datum**: {YYYY-MM-DD}
+**Status**: {Vorgeschlagen | Akzeptiert | Veraltet | Ersetzt durch ADR-XXXX}
+**Entscheider**: {Namen der beteiligten Personen}
+
+## Kontext
+
+{Beschreiben Sie die wirksamen Kräfte, einschließlich technologischer, politischer,
+sozialer und projektbezogener Kräfte. Diese Kräfte stehen wahrscheinlich in Spannung
+und sollten als solche benannt werden. Die Sprache in diesem Abschnitt ist
+wertneutral - wir beschreiben einfach Fakten.}
+
+### Aktuelle Situation
+
+{Beschreibung des aktuellen Zustands des Systems/Projekts}
+
+### Problem
+
+{Klare Beschreibung des zu lösenden Problems}
+
+### Einschränkungen
+
+- {Einschränkung 1}
+- {Einschränkung 2}
+- {Einschränkung 3}
+
+## Betrachtete Optionen
+
+### Option 1: {Name}
+
+{Beschreibung der Option}
+
+**Vorteile**:
+- {Vorteil 1}
+- {Vorteil 2}
+
+**Nachteile**:
+- {Nachteil 1}
+- {Nachteil 2}
+
+**Geschätzter Aufwand**: {Niedrig | Mittel | Hoch}
+
+### Option 2: {Name}
+
+{Beschreibung der Option}
+
+**Vorteile**:
+- {Vorteil 1}
+- {Vorteil 2}
+
+**Nachteile**:
+- {Nachteil 1}
+- {Nachteil 2}
+
+**Geschätzter Aufwand**: {Niedrig | Mittel | Hoch}
+
+### Option 3: {Name}
+
+{Beschreibung der Option}
+
+**Vorteile**:
+- {Vorteil 1}
+- {Vorteil 2}
+
+**Nachteile**:
+- {Nachteil 1}
+- {Nachteil 2}
+
+**Geschätzter Aufwand**: {Niedrig | Mittel | Hoch}
+
+## Entscheidung
+
+{Wir haben uns entschieden, **Option X** zu verwenden, weil...}
+
+### Begründung
+
+{Detaillierte Erklärung, warum diese Option gegenüber
+anderen gewählt wurde. Einschließlich akzeptierter Kompromisse.}
+
+## Konsequenzen
+
+### Positiv
+
+- {Positive Konsequenz 1}
+- {Positive Konsequenz 2}
+
+### Negativ
+
+- {Negative Konsequenz 1}
+- {Negative Konsequenz 2}
+
+### Risiken
+
+| Risiko | Wahrscheinlichkeit | Auswirkung | Minderung |
+|--------|-------------------|------------|-----------|
+| {Risiko 1} | Niedrig/Mittel/Hoch | Niedrig/Mittel/Hoch | {Aktion} |
+| {Risiko 2} | Niedrig/Mittel/Hoch | Niedrig/Mittel/Hoch | {Aktion} |
+
+## Umsetzungsplan
+
+### Phase 1: {Titel}
+- [ ] {Aufgabe 1}
+- [ ] {Aufgabe 2}
+
+### Phase 2: {Titel}
+- [ ] {Aufgabe 3}
+- [ ] {Aufgabe 4}
+
+## Erfolgsmetriken
+
+- {Metrik 1}: {Zielwert}
+- {Metrik 2}: {Zielwert}
+
+## Referenzen
+
+- {Link zur Dokumentation}
+- {Link zur Vergleichsstudie}
+- {Verwandte ADRs}
+
+---
+
+## Historie
+
+| Datum | Aktion | Von |
+|-------|--------|-----|
+| {YYYY-MM-DD} | Erstellt | {Name} |
+| {YYYY-MM-DD} | Akzeptiert | {Team} |
+```
+
+### Schritt 4: Vollständiges ADR-Beispiel
+
+```markdown
+# ADR-0012: Wahl von PostgreSQL als Hauptdatenbank
+
+**Datum**: 2024-01-15
+**Status**: Akzeptiert
+**Entscheider**: John Doe (Tech Lead), Mary Smith (DBA), Peter Johnson (CTO)
+
+## Kontext
+
+### Aktuelle Situation
+
+Unsere Anwendung verwendet derzeit MySQL 5.7, gehostet auf einem dedizierten Server.
+Die Datenbank enthält 50 Tabellen, 10 Millionen Zeilen in der Haupttabelle
+und verarbeitet 1000 Abfragen/Sekunde zur Spitzenzeit.
+
+### Problem
+
+1. MySQL 5.7 erreicht End-of-Life (EOL)
+2. Wachsender Bedarf an komplexen JSON-Abfragen
+3. Eingeschränkte Volltextsuchfunktionen
+4. Keine native Unterstützung für Geospatial-Typen
+
+### Einschränkungen
+
+- Begrenztes Infrastrukturbudget
+- Migration muss für Benutzer transparent sein
+- Team mit MySQL vertraut, nicht mit PostgreSQL
+- Migrationszeit: maximal 3 Monate
+
+## Betrachtete Optionen
+
+### Option 1: Upgrade auf MySQL 8.0
+
+Bleiben Sie bei MySQL durch Upgrade auf Version 8.0.
+
+**Vorteile**:
+- Keine Schema-Migration
+- Team bereits geschult
+- Minimales Risiko
+
+**Nachteile**:
+- JSON-Abfragen immer noch weniger performant
+- Keine native französische Volltextsuche
+- Weniger ausgereifte Geospatial-Erweiterung
+
+**Geschätzter Aufwand**: Niedrig
+
+### Option 2: Migration zu PostgreSQL 16
+
+Migration zu PostgreSQL mit allen modernen Funktionen.
+
+**Vorteile**:
+- Sehr performantes JSONB
+- Volltextsuche mit französischen Wörterbüchern
+- PostGIS für Geospatial
+- Sehr aktive Community
+- Umfangreiche Erweiterungen (pg_trgm, uuid-ossp, etc.)
+
+**Nachteile**:
+- Migration erforderlich
+- Team-Schulung erforderlich
+- Geringfügige SQL-Syntaxänderungen
+
+**Geschätzter Aufwand**: Mittel
+
+### Option 3: NoSQL-Datenbank (MongoDB)
+
+Migration zu einer Dokumentendatenbank für mehr Flexibilität.
+
+**Vorteile**:
+- Flexibles Schema
+- Gut für natives JSON
+- Horizontale Skalierbarkeit
+
+**Nachteile**:
+- Verlust relationaler Einschränkungen
+- Massive Code-Migration
+- Komplexe Transaktionen
+- Ungeschultes Team
+
+**Geschätzter Aufwand**: Hoch
+
+## Entscheidung
+
+Wir haben uns entschieden, **PostgreSQL 16** zu verwenden, weil:
+
+### Begründung
+
+1. **JSON-Performance**: PostgreSQLs JSONB übertrifft MySQL für unsere
+   Anwendungsfälle beim Speichern von Benutzer-Metadaten.
+
+2. **Volltextsuche**: Native französisches Wörterbuch vermeidet die Installation
+   von Elasticsearch für die Suche.
+
+3. **PostGIS**: Unsere neuen Geolokalisierungsfunktionen werden
+   einfacher zu implementieren sein.
+
+4. **Reife**: PostgreSQL ist das fortschrittlichste Open-Source-RDBMS
+   mit einer sehr aktiven Community.
+
+5. **Doctrine-Kompatibilität**: Unser ORM unterstützt PostgreSQL perfekt.
+
+## Konsequenzen
+
+### Positiv
+
+- JSON-Abfragen 3x schneller (interner Benchmark)
+- Volltextsuche ohne zusätzliche Infrastruktur
+- Native Geospatial-Funktionen
+- Bessere Unterstützung für Datentypen (UUID, Arrays, etc.)
+
+### Negativ
+
+- 2 Wochen Team-Schulung
+- Datenmigration geschätzt auf 4h Ausfallzeit
+- Einige Abfragen anzupassen (LIMIT/OFFSET-Syntax)
+
+### Risiken
+
+| Risiko | Wahrscheinlichkeit | Auswirkung | Minderung |
+|--------|-------------------|------------|-----------|
+| Performance-Regression | Niedrig | Mittel | Lasttests vor Migration |
+| Datenverlust | Sehr niedrig | Kritisch | Backup + Dry-Run |
+| Post-Migrations-Bugs | Mittel | Niedrig | 2-wöchige Stabilisierungsphase |
+
+## Umsetzungsplan
+
+### Phase 1: Vorbereitung (Woche 1-2)
+- [x] PostgreSQL Team-Schulung
+- [x] PostgreSQL Dev-Umgebung einrichten
+- [x] Unit-Tests anpassen
+
+### Phase 2: Code-Migration (Woche 3-4)
+- [ ] Native SQL-Abfragen anpassen
+- [ ] Doctrine für PostgreSQL konfigurieren
+- [ ] Integrationstests vervollständigen
+
+### Phase 3: Datenmigration (Woche 5)
+- [ ] pgloader-Migrationsskript
+- [ ] Dry-Run auf Produktionskopie
+- [ ] Produktionsmigration (Wochenende)
+
+### Phase 4: Stabilisierung (Woche 6-8)
+- [ ] Performance-Überwachung
+- [ ] Bug-Fixes falls vorhanden
+- [ ] Dokumentation aktualisiert
+
+## Erfolgsmetriken
+
+- API-Antwortzeit: ≤ aktuell (100ms P95)
+- JSON-Abfragen: -50% Ausführungszeit
+- Post-Migrations-Verfügbarkeit: 99,9%
+
+## Referenzen
+
+- [PostgreSQL vs MySQL JSON Benchmark](internal-wiki/benchmarks)
+- [Doctrine-Migrationsleitfaden](internal-wiki/migration-guide)
+- ADR-0008: Wahl von Doctrine ORM
+```
+
+### Schritt 5: ADR-Index erstellen
+
+```markdown
+# Architecture Decision Records
+
+Dieser Ordner enthält die ADRs des Projekts.
+
+## Index
+
+| # | Titel | Status | Datum |
+|---|-------|--------|------|
+| [ADR-0001](0001-use-clean-architecture.md) | Einführung von Clean Architecture | Akzeptiert | 2023-06-15 |
+| [ADR-0012](0012-postgresql-database.md) | PostgreSQL-Wahl | Akzeptiert | 2024-01-15 |
+| [ADR-0013](0013-api-versioning.md) | API-Versionierungsstrategie | Vorgeschlagen | 2024-01-20 |
+
+## Status
+
+- **Vorgeschlagen**: In Diskussion
+- **Akzeptiert**: Entscheidung validiert
+- **Veraltet**: Nicht mehr relevant
+- **Ersetzt**: Durch ein anderes ADR ersetzt
+```
+
+## Empfohlene Struktur
+
+```
+docs/
+└── architecture/
+    └── decisions/
+        ├── README.md           # ADR-Index
+        ├── 0001-*.md
+        ├── 0002-*.md
+        └── templates/
+            └── adr-template.md
+```

package/Dev/i18n/de/Common/commands/daily-standup.md

@@ -0,0 +1,216 @@
+---
+description: Daily Stand-up Zusammenfassung
+argument-hint: [arguments]
+---
+
+# Daily Stand-up Zusammenfassung
+
+Sie sind ein Scrum-Assistent. Sie müssen eine Zusammenfassung der Entwicklungsaktivitäten erstellen, um das tägliche Stand-up zu erleichtern.
+
+## Argumente
+$ARGUMENTS
+
+Argumente:
+- (Optional) Zeitraum (Standard: seit gestern)
+
+Beispiel: `/common:daily-standup` oder `/common:daily-standup "2024-01-15"`
+
+## MISSION
+
+### Schritt 1: Daten sammeln
+
+```bash
+# Commits seit gestern
+git log --since="yesterday" --oneline --all
+
+# Aktive Branches
+git branch -a --sort=-committerdate | head -10
+
+# Offene PRs
+gh pr list --state open
+
+# Aktuelle Issues
+gh issue list --assignee @me --state open
+
+# Lokal geänderte Dateien
+git status --short
+```
+
+### Schritt 2: Zusammenfassung erstellen
+
+```
+══════════════════════════════════════════════════════════════
+📅 DAILY STAND-UP - {YYYY-MM-DD}
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+📊 SPRINT-ZUSAMMENFASSUNG
+──────────────────────────────────────────────────────────────
+
+Sprint: {N}
+Tag: {X}/10
+Verbleibende Punkte: {Y}
+Burndown: 📉 Im Plan / 📈 Voraus / 📊 Verzögert
+
+──────────────────────────────────────────────────────────────
+✅ WAS ERLEDIGT WURDE (GESTERN)
+──────────────────────────────────────────────────────────────
+
+### Commits
+- {hash} {Nachricht} (@autor)
+- {hash} {Nachricht} (@autor)
+
+### Gemergte PRs
+- PR #123: {Titel} (@autor)
+
+### Geschlossene Issues
+- Issue #456: {Titel}
+
+──────────────────────────────────────────────────────────────
+🎯 WAS GEPLANT IST (HEUTE)
+──────────────────────────────────────────────────────────────
+
+### In Bearbeitung
+| Branch | Issue | Zugewiesen | Status |
+|---------|-------|-----------|--------|
+| feature/auth | #45 | @dev1 | 🟡 70% |
+| fix/login | #48 | @dev2 | 🟢 90% |
+
+### Zu starten
+- Issue #50: {Titel} (nicht zugewiesen)
+
+──────────────────────────────────────────────────────────────
+🚧 BLOCKER / RISIKEN
+──────────────────────────────────────────────────────────────
+
+| Blocker | Auswirkung | Erforderliche Aktion |
+|----------|------------|---------------------|
+| Externe API ausgefallen | PR #123 blockiert | Support kontaktieren |
+| Review ausstehend | PR #125 seit 2 Tagen | @dev3 verfügbar? |
+
+──────────────────────────────────────────────────────────────
+📈 AKTIVE PULL REQUESTS
+──────────────────────────────────────────────────────────────
+
+| PR | Titel | Autor | Alter | Reviews |
+|----|-------|-------|-------|---------|
+| #125 | OAuth-Login hinzufügen | @dev1 | 2d | 1/2 ✅ |
+| #127 | Benutzerprofil reparieren | @dev2 | 1d | 0/2 ⏳ |
+| #128 | Abhängigkeiten aktualisieren | @bot | 3d | 0/1 ⏳ |
+
+──────────────────────────────────────────────────────────────
+💡 NOTIZEN / ERINNERUNGEN
+──────────────────────────────────────────────────────────────
+
+- 🗓️ Backlog-Refinement morgen 14 Uhr
+- ⚠️ Feature X Deadline: Freitag
+- 📣 Sprint Review: {Datum}
+```
+
+### Schritt 3: Kurzformat (für Slack/Teams)
+
+```markdown
+**📅 Daily - {YYYY-MM-DD}**
+
+**Gestern:**
+• PR #123 gemergt (Google OAuth)
+• 5 Commits auf feature/auth
+
+**Heute:**
+• PR #125 fertigstellen (GitHub OAuth)
+• Issue #50 starten (Passwort zurücksetzen)
+
+**Blocker:**
+• ⚠️ Review ausstehend PR #125 (@dev3)
+
+**PRs zum Review:**
+• PR #127 - Benutzerprofil reparieren (0/2)
+```
+
+### Schritt 4: Team-Metriken
+
+```
+══════════════════════════════════════════════════════════════
+👥 TEAM-AKTIVITÄT (Letzte 7 Tage)
+══════════════════════════════════════════════════════════════
+
+| Mitglied | Commits | PRs | Reviews | Issues |
+|----------|---------|-----|---------|--------|
+| @dev1 | 12 | 3 | 5 | 4 |
+| @dev2 | 8 | 2 | 3 | 3 |
+| @dev3 | 15 | 4 | 8 | 5 |
+
+──────────────────────────────────────────────────────────────
+📊 AKTUELLE VELOCITY
+──────────────────────────────────────────────────────────────
+
+| Tag | Gelieferte Punkte | Kumulativ | Ideal |
+|------|------------------|-----------|-------|
+| T1 | 3 | 3 | 2.1 |
+| T2 | 5 | 8 | 4.2 |
+| T3 | 2 | 10 | 6.3 |
+| T4 | 0 | 10 | 8.4 |
+| T5 | ... | ... | 10.5 |
+
+Status: 📈 1,6 Punkte voraus
+```
+
+## Daily Stand-up Tipps
+
+### Die 3 klassischen Fragen
+1. Was habe ich gestern gemacht?
+2. Was werde ich heute machen?
+3. Gibt es Hindernisse?
+
+### Best Practices
+- **15 Minuten max** für das gesamte Team
+- **Im Stehen** (fördert Kürze)
+- **Gleiche Zeit** jeden Tag
+- **Keine Problemlösung** (Parking Lot)
+- **Fokus auf Sprint-Ziel**
+
+### Zu vermeidende Anti-Patterns
+- ❌ Berichterstattung an Scrum Master (sprechen Sie mit dem Team)
+- ❌ Lange technische Diskussionen
+- ❌ Auf die eigene Reihe warten ohne zuzuhören
+- ❌ "Ich habe an X gearbeitet" (zu vage)
+
+### Alternatives Format: Walk the Board
+1. Beginnen Sie mit der "Done"-Spalte
+2. Gehen Sie zu "In Progress"
+3. Dann "To Do"
+4. Fokus auf was den Fortschritt blockiert
+
+## Automatisierung
+
+### GitHub Action für Daily Digest
+
+```yaml
+name: Daily Digest
+on:
+  schedule:
+    - cron: '0 7 * * 1-5'  # 7 Uhr Montag bis Freitag
+  workflow_dispatch:
+
+jobs:
+  digest:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Digest erstellen
+        run: |
+          echo "# Daily Digest - $(date +%Y-%m-%d)" > digest.md
+          echo "" >> digest.md
+          echo "## Commits (24h)" >> digest.md
+          git log --since="24 hours ago" --oneline >> digest.md
+          echo "" >> digest.md
+          echo "## Offene PRs" >> digest.md
+          gh pr list --state open --json number,title,author >> digest.md
+
+      - name: Zu Slack posten
+        uses: slackapi/slack-github-action@v1
+        with:
+          channel-id: 'daily-standup'
+          payload-file-path: digest.md
+```