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

package/Project/i18n/de/commands/trace.md

@@ -1,104 +1,96 @@
 ---
 name: trace
-description: Display bidirectional traceability matrix from requirements to code and tests
-arguments:
-  - name: scope
-    description: Scope of tracing (all, requirement, story, code)
-    required: false
-  - name: id
-    description: Specific ID to trace (e.g., FR-001, US-001)
-    required: false
-  - name: format
-    description: Output format (table, mermaid, json)
-    required: false
+description: "Bidirektionale Traceability-Matrix (Anforderung → Story → Code → Tests); --gaps listet nicht abgedeckte Anforderungen, --by-priority gruppiert nach MoSCoW-Priorität"
+argument-hint: "[all|requirement|story|code] [ID] [--gaps] [--by-priority] [--level=story|code|test|all] [--format=table|mermaid|json]"
 ---
 
 # /project:trace
 
-## Mission
+## Auftrag
 
-Generate a bidirectional traceability matrix that maps every requirement from the PRD through user stories, code implementation, and test coverage. This provides full visibility into what is implemented, what is tested, and what gaps exist.
+Jede Anforderung des PRD mit User Stories, Code und Tests verknüpfen. Die Standardansicht ist die vollständige bidirektionale Matrix; `--gaps` wandelt sie in einen Abdeckungsbericht um, der nur auflistet, was nicht abgedeckt ist (das ehemalige `/project:trace --gaps`); `--by-priority` gruppiert das Ergebnis nach MoSCoW-Priorität.
 
-## Prerequisites
+## Verwendung
 
-- `project-management/prd.md` exists with FR-xxx requirement IDs
-- `project-management/backlog/` contains user stories with `Implements:` references
-- Codebase with `// Story: US-xxx` or `# Story: US-xxx` comments
-- Test files with story/requirement references
+| Aufruf | Wirkung | Ersetzt |
+|--------|---------|---------|
+| `/project:trace` oder `/project:trace all` | Vollständige Matrix: Anforderung → Story → Code → Tests | `/project:trace` |
+| `/project:trace requirement FR-001` | Eine Anforderung abwärts verfolgen | `/project:trace --scope requirement --id FR-001` |
+| `/project:trace story US-001` | Eine Story aufwärts (Anforderungen) und abwärts (Code, Tests) verfolgen | `/project:trace --scope story` |
+| `/project:trace code` | Code-Dateien mit und ohne Story-Referenz | `/project:trace --scope code` |
+| `/project:trace --gaps` | Abdeckungsbericht: Anforderungen, die weder durch Stories, Code noch Tests abgedeckt sind, mit empfohlenen Maßnahmen | `/project:trace --gaps` |
+| `/project:trace --gaps --level test` | Wie oben, begrenzt auf eine Abdeckungsebene (`story`, `code`, `test`, `all`; Standard `all`) | `/project:trace --gaps --level test` |
+| `/project:trace --by-priority` | Anforderungen und Abdeckungsquoten nach MoSCoW-Priorität gruppieren | neu (zuvor ein Abschnitt von coverage-map) |
 
-## Plan-Modus
+Die Optionen lassen sich kombinieren: `/project:trace --gaps --by-priority` liefert den Abdeckungsbericht mit Aufschlüsselung nach Priorität.
 
-> **Der Plan-Modus ist obligatorisch.** Vor der Ausführung aktiviert Claude den Plan-Modus, um betroffenen Code zu analysieren, einen Implementierungsplan vorzuschlagen und auf Ihre Validierung zu warten, bevor Änderungen vorgenommen werden.
+## Argumente
 
-## Workflow
+`$ARGUMENTS` auswerten:
+- Erstes Positionsargument aus `all|requirement|story|code` → Umfang (Standard `all`).
+- Nächstes Positionsargument, das auf `FR-\d+` oder `US-\d+` passt → zu verfolgende ID (für `requirement` und `story` erforderlich).
+- `--gaps` → Abdeckungsmodus. `--level` wird nur in diesem Modus gelesen.
+- `--by-priority` → nach Priorität gruppieren: P0 = Must have, P1 = Should have, P2 = Could have / Nice to have.
+- `--format` → `table` (Standard), `mermaid`, `json`.
 
-### Step 1: Scan PRD Requirements
+## Voraussetzungen
 
-```
-╔══════════════════════════════════════════════════════════╗
-║              TRACEABILITY SCAN - REQUIREMENTS             ║
-╠══════════════════════════════════════════════════════════╣
-║ Scanning project-management/prd.md...                     ║
-╚══════════════════════════════════════════════════════════╝
-```
+- `project-management/prd.md` existiert mit Anforderungs-IDs FR-xxx
+- `project-management/backlog/` enthält User Stories mit `Implements:`-Referenzen
+- Codebasis mit Kommentaren `// Story: US-xxx` oder `# Story: US-xxx` (optional für `--gaps --level story`)
+- Testdateien mit Story-/Anforderungsreferenzen
+
+## Plan Mode
+
+> **Der Plan Mode ist verpflichtend.** Vor der Ausführung aktiviert Claude den Plan Mode, um den betroffenen Code zu analysieren, einen Umsetzungsplan vorzuschlagen und auf Ihre Freigabe zu warten, bevor Änderungen vorgenommen werden.
 
-Parse the PRD for all functional requirements:
-1. Read `project-management/prd.md`
-2. Extract all FR-xxx IDs from section 5 (Functional Requirements)
-3. Record requirement text, priority (P0/P1/P2), and acceptance criteria
-4. Build a requirements registry: `{FR-001: {text, priority, status}}`
+## Gemeinsame Scans
 
-### Step 2: Scan User Stories
+Beide Modi führen dieselben vier Scans nur einmal aus; die Ergebnisse speisen entweder die Matrix oder den Abdeckungsbericht. Der **Status** einer Story stammt immer aus `.bmad/sprint-status.yaml` (Single Source of Truth); Markdown-Dateien liefern nur den Inhalt.
 
-Search for user stories referencing requirements:
-1. Scan `project-management/backlog/` for `US-*.md` or `user-stories/` files
-2. In each story, look for `Implements:` or `Traceability` section
-3. Extract mappings: `{US-001: [FR-001, FR-003]}`
-4. Record story status, sprint, and acceptance criteria count
+### Scan 1: Anforderungen
 
-### Step 3: Scan Codebase
+1. `project-management/prd.md` lesen
+2. Alle FR-xxx-IDs aus dem Abschnitt der funktionalen Anforderungen extrahieren
+3. Text, Priorität (P0/P1/P2) und Akzeptanzkriterien erfassen
+4. Register: `{FR-001: {text, priority}}`; Anforderungen pro Priorität zählen
 
-Search for code files referencing stories:
-1. Grep codebase for patterns: `// Story: US-xxx`, `# Story: US-xxx`, `@story US-xxx`
-2. Record file paths and line numbers for each reference
-3. Build mapping: `{US-001: [src/Service/OrderService.php:42, src/Controller/OrderController.php:15]}`
-4. Identify code files with no story reference
+### Scan 2: User Stories
 
-### Step 4: Scan Tests
+1. `project-management/backlog/` nach `US-*.md` (oder `user-stories/`-Dateien) durchsuchen
+2. In jeder Story die Zeile `Implements:` oder den Abschnitt `Traceability` lesen
+3. Zuordnung: `{US-001: [FR-001, FR-003]}`; Status und Sprint aus `.bmad/sprint-status.yaml` lesen
+4. Eine Anforderung, auf die keine Story verweist, ist „No Story“
 
-Search for test files referencing stories or requirements:
-1. Grep test directories for `US-xxx` or `FR-xxx` references
-2. Check test names for story/requirement patterns
-3. Build mapping: `{US-001: [tests/OrderServiceTest.php, tests/OrderControllerTest.php]}`
-4. Identify stories with no test coverage
+### Scan 3: Code
 
-### Step 5: Generate Traceability Matrix
+1. Den Code nach `// Story: US-xxx`, `# Story: US-xxx`, `@story US-xxx` durchsuchen
+2. Zuordnung mit Datei und Zeile: `{US-001: [src/Service/OrderService.php:42]}`
+3. Eine Story ohne Referenz ist „No Code“; Code-Dateien ohne Story-Referenz auflisten
 
-Combine all mappings into a comprehensive matrix:
+### Scan 4: Tests
+
+1. Testverzeichnisse nach Referenzen auf `US-xxx` / `FR-xxx` durchsuchen und Testnamen prüfen
+2. Zuordnung: `{US-001: [tests/OrderServiceTest.php]}`
+3. Eine Story mit Code, aber ohne Testreferenz ist „No Tests“
 
 ```
 ╔══════════════════════════════════════════════════════════╗
-║              TRACEABILITY MATRIX GENERATED                ║
-╠══════════════════════════════════════════════════════════╣
 ║ Requirements: {n} | Stories: {n} | Files: {n} | Tests: {n}║
 ╚══════════════════════════════════════════════════════════╝
 ```
 
-## Output Format
+## Matrixmodus (Standard)
 
-### Table Format (default)
+Die vier Zuordnungen kombinieren. Ausgabe (Format table):
 
 ```
 Bidirectional Traceability Matrix
 =================================
 
-Requirement → Story → Code → Tests
-─────────────────────────────────────────────────────
-
 FR-001 (P0) User Authentication
   ├── US-001: Login with email/password
   │   ├── src/Service/AuthService.php:25
-  │   ├── src/Controller/AuthController.php:18
   │   ├── tests/AuthServiceTest.php ✅
   │   └── tests/AuthControllerTest.php ✅
   └── US-002: Password reset flow
@@ -115,7 +107,6 @@ FR-010 (P1) Export to CSV
 
 Coverage Summary
 ================
-
 | Level | Covered | Total | Percentage |
 |-------|---------|-------|------------|
 | Requirements → Stories | 8 | 10 | 80% |
@@ -125,145 +116,106 @@ Coverage Summary
 
 Gaps Identified
 ===============
-
 | Type | ID | Description | Action Needed |
 |------|----|-------------|---------------|
 | No Stories | FR-010 | Export to CSV | Create user story |
 | No Tests | US-003 | Register with email | Add test coverage |
-| No Code | US-005 | Bulk import | Implement feature |
 ```
 
-### Mermaid Format (--format mermaid)
-
-```mermaid
-graph LR
-    subgraph Requirements
-        FR001[FR-001 Auth]
-        FR002[FR-002 Registration]
-        FR010[FR-010 Export]
-    end
-
-    subgraph Stories
-        US001[US-001 Login]
-        US002[US-002 Password Reset]
-        US003[US-003 Register]
-    end
-
-    subgraph Code
-        AUTH[AuthService]
-        PWD[PasswordResetService]
-        REG[RegistrationService]
-    end
-
-    subgraph Tests
-        T1[AuthServiceTest ✅]
-        T2[PasswordResetTest ✅]
-        T3[❌ Missing]
-    end
-
-    FR001 --> US001
-    FR001 --> US002
-    FR002 --> US003
-    FR010 -.->|NO STORY| X1[Gap]
-
-    US001 --> AUTH
-    US002 --> PWD
-    US003 --> REG
-
-    AUTH --> T1
-    PWD --> T2
-    REG -.-> T3
-
-    style FR010 fill:#ff6b6b
-    style X1 fill:#ff6b6b
-    style T3 fill:#ff6b6b
-```
+Mit einer ID wird nur dieser Zweig ausgegeben, mit Story-Status und Testanzahl (z. B. `US-001: Login [Done]`, `tests/AuthServiceTest.php ✅ (12 tests)`), danach `Status: Fully covered (2/2 stories, 3/3 code files, 3/3 test files)`.
+
+### Mermaid (`--format mermaid`)
 
-### JSON Format (--format json)
+`graph LR` mit vier Subgraphen (Requirements, Stories, Code, Tests); durchgezogene Pfeile für Verknüpfungen, gepunktete Pfeile (`-.->|NO STORY|`) zu einem Lückenknoten für fehlende Verknüpfungen; Lücken mit Stil `fill:#ff6b6b`.
+
+### JSON (`--format json`)
 
 ```json
 {
   "generated_at": "2026-02-19T10:00:00Z",
-  "requirements": {
-    "FR-001": {
-      "text": "User Authentication",
-      "priority": "P0",
-      "stories": ["US-001", "US-002"],
-      "covered": true
-    }
-  },
-  "stories": {
-    "US-001": {
-      "title": "Login with email/password",
-      "implements": ["FR-001"],
-      "code_files": ["src/Service/AuthService.php"],
-      "test_files": ["tests/AuthServiceTest.php"],
-      "covered": true
-    }
-  },
-  "coverage": {
-    "requirements_to_stories": 0.80,
-    "stories_to_code": 0.87,
-    "stories_to_tests": 0.75,
-    "end_to_end": 0.60
-  },
-  "gaps": [
-    {"type": "no_stories", "id": "FR-010", "description": "Export to CSV"},
-    {"type": "no_tests", "id": "US-003", "description": "Register with email"}
-  ]
+  "requirements": {"FR-001": {"text": "User Authentication", "priority": "P0", "stories": ["US-001"], "covered": true}},
+  "stories": {"US-001": {"title": "Login", "implements": ["FR-001"], "code_files": ["src/Service/AuthService.php"], "test_files": ["tests/AuthServiceTest.php"], "covered": true}},
+  "coverage": {"requirements_to_stories": 0.80, "stories_to_code": 0.87, "stories_to_tests": 0.75, "end_to_end": 0.60},
+  "gaps": [{"type": "no_stories", "id": "FR-010", "description": "Export to CSV"}]
 }
 ```
 
-## Example Session
+## Lückenmodus (`--gaps`)
 
-```
-User: /project:trace
+Nutzt die gemeinsamen Scans, berechnet die Abdeckung pro Schicht und listet nur auf, was fehlt. `--level` schränkt die berechneten Schichten ein: `story` (Scans 1-2), `code` (1-3), `test` (1-4), `all` (Standard).
 
-Claude: Starting traceability scan...
+```
+Requirement Coverage Map
+========================
+| Layer | Covered | Total | Coverage | Status |
+|-------|---------|-------|----------|--------|
+| Stories | 8 | 10 | 80% | ⚠️ |
+| Code | 7 | 8 | 87% | ⚠️ |
+| Tests | 6 | 8 | 75% | ❌ |
+| End-to-End | 6 | 10 | 60% | ❌ |
+
+Uncovered Requirements
+| ID | Requirement | Priority | Missing |
+|----|-------------|----------|---------|
+| FR-005 | Bulk export | P0 | Tests |
+| FR-010 | CSV import | P1 | Story, Code, Tests |
+
+Recommended Actions
+1. 🔴 CRITICAL: FR-005 (P0) hat Code, aber keine Tests — Testabdeckung ergänzen
+2. ⚠️ HIGH: FR-010 (P1) hat keine Story — User Story erstellen
+3. 📝 LOW: FR-020 (P2) nicht begonnen — für künftige Sprints einplanen
+
+Next Commands
+- /project:trace requirement FR-005   → detaillierte Verfolgung einer Anforderung
+- /project:backlog add story         → fehlende User Stories erstellen
+- /workflow:plan --only=backlog          → Backlog mit den Lücken neu generieren
+```
 
-📋 Scanning PRD requirements...
-Found 10 requirements (5 P0, 3 P1, 2 P2)
+Mit `--level test` eine Zeile pro Story ausgeben: `US-003 | ❌ | 0 files | 0 tests` und die Maßnahme (z. B. „tests/RegistrationServiceTest.php erstellen“).
 
-📖 Scanning user stories...
-Found 8 stories with requirement references
+Mermaid (`--format mermaid`): `graph TD` mit einem Subgraphen pro Priorität; Knoten `FR-001 ✅`, `FR-005 ⚠️ No Tests`, `FR-010 ❌ No Story`; Stile `#4caf50` (abgedeckt), `#ff9800` (teilweise), `#f44336` (fehlend).
 
-💻 Scanning codebase...
-Found 24 code files with story references
+### Abdeckungsschwellen
 
-🧪 Scanning tests...
-Found 18 test files with story references
+| Schwelle | Status | Maßnahme |
+|----------|--------|----------|
+| >= 90% | ✅ Ausgezeichnet | Beibehalten |
+| 80-89% | ⚠️ Gut | Lücken prüfen |
+| 60-79% | ⚠️ Verbesserungsbedarf | Abdeckung priorisieren |
+| < 60% | ❌ Kritisch | Sofortiges Handeln erforderlich |
 
-Bidirectional Traceability Matrix
-=================================
-[... full matrix output ...]
+## Gruppierung nach Priorität (`--by-priority`)
 
-Coverage: 60% end-to-end
-Gaps: 2 requirements without stories, 1 story without tests
+Funktioniert in beiden Modi. Im Matrixmodus werden die Anforderungen unter den Überschriften `P0 Must have`, `P1 Should have`, `P2 Could have` aufgelistet. Im Lückenmodus ergänzen:
 
-User: /project:trace --scope requirement --id FR-001
+```
+Coverage by Priority
+| Priority | Requirements | Story Coverage | Code Coverage | Test Coverage |
+|----------|-------------|----------------|---------------|---------------|
+| P0 (Must Have) | 5 | 100% ✅ | 100% ✅ | 80% ⚠️ |
+| P1 (Should Have) | 3 | 66% ⚠️ | 50% ❌ | 33% ❌ |
+| P2 (Could Have) | 2 | 0% ❌ | 0% ❌ | 0% ❌ |
+```
 
-Claude: Tracing FR-001: User Authentication
+Die empfohlenen Maßnahmen werden dann mit P0 beginnend sortiert.
 
-FR-001 (P0) User Authentication
-├── US-001: Login with email/password [Done]
-│   ├── src/Service/AuthService.php:25
-│   ├── src/Controller/AuthController.php:18
-│   ├── tests/AuthServiceTest.php ✅ (12 tests)
-│   └── tests/AuthControllerTest.php ✅ (8 tests)
-└── US-002: Password reset flow [In Progress]
-    ├── src/Service/PasswordResetService.php:10
-    └── tests/PasswordResetServiceTest.php ✅ (6 tests)
+## Beispielsitzung
 
-Status: Fully covered (2/2 stories, 3/3 code files, 3/3 test files)
+```
+User: /project:trace
+Claude: 10 Anforderungen gefunden (5 P0, 3 P1, 2 P2), 8 Stories, 24 Code-Dateien, 18 Testdateien.
+        [vollständige Matrix] Abdeckung: 60% Ende-zu-Ende
 
-User: /project:trace --format mermaid
+User: /project:trace requirement FR-001
+Claude: [nur der Zweig FR-001]
 
-Claude: [generates Mermaid diagram]
+User: /project:trace --gaps --by-priority
+Claude: [Abdeckungsbericht mit Tabelle pro Priorität, 2 P0-Anforderungen benötigen Aufmerksamkeit]
 ```
 
-## Related Commands
+## Verwandte Befehle
 
-- `/project:coverage-map` - Identify uncovered requirements
-- `/project:generate-prd` - Generate PRD with requirement IDs
-- `/project:generate-backlog` - Create backlog from PRD
-- `/project:generate-tech-spec` - Generate technical specification
+- `/workflow:plan --only=prd` - PRD mit Anforderungs-IDs generieren
+- `/workflow:plan --only=backlog` - Backlog aus dem PRD erstellen
+- `/workflow:design` - Technische Spezifikation generieren
+- `/project:migrate --stories` - Fehlende Felder (wie `Implements:`) zu Stories hinzufügen

package/Project/i18n/de/commands/update-epic.md

@@ -1,105 +1,9 @@
 ---
-description: Ein EPIC aktualisieren
-argument-hint: [arguments]
+description: "Veraltet (Entfernung in 9.0): /project:backlog edit epic verwenden"
+deprecated: true
+replaced-by: /project:backlog
 ---
 
-# Ein EPIC aktualisieren
+> ⚠️ `/project:update-epic` ist veraltet und wird in 9.0 entfernt. Verwenden Sie `/project:backlog edit epic`.
 
-Informationen eines bestehenden EPICs ändern.
-
-## Argumente
-
-$ARGUMENTS (Format: EPIC-XXX [Feld] [Wert])
-- **EPIC-ID** (erforderlich): EPIC-ID (z.B. EPIC-001)
-- **Feld** (optional): Zu änderndes Feld
-- **Wert** (optional): Neuer Wert
-
-## Plan-Modus
-
-> **Der Plan-Modus ist obligatorisch.** Vor der Ausführung aktiviert Claude den Plan-Modus, um betroffenen Code zu analysieren, einen Implementierungsplan vorzuschlagen und auf Ihre Validierung zu warten, bevor Änderungen vorgenommen werden.
-
-## Änderbare Felder
-
-| Feld | Beschreibung | Beispiel |
-|-------|-------------|---------|
-| `name` | EPIC-Name | "Neuer Name" |
-| `priority` | Priorität | High, Medium, Low |
-| `mmf` | Minimum Marketable Feature | "MMF-Beschreibung" |
-| `description` | Beschreibung | "Neue Beschreibung" |
-
-## Prozess
-
-### Interaktiver Modus (ohne Feld-Argumente)
-
-Falls nur ID angegeben:
-
-```
-/project:update-epic EPIC-001
-```
-
-Aktuelle Informationen anzeigen und Änderungen anbieten:
-
-```
-📋 EPIC-001: Authentifizierungssystem
-
-Aktuelle Felder:
-1. Name: Authentifizierungssystem
-2. Priorität: High
-3. MMF: Benutzern ermöglichen, sich anzumelden
-4. Beschreibung: [...]
-
-Welches Feld ändern? (1-4, oder 'q' zum Beenden)
->
-```
-
-### Direkter Modus (mit Argumenten)
-
-```
-/project:update-epic EPIC-001 priority Medium
-```
-
-Das angegebene Feld direkt ändern.
-
-### Schritte
-
-1. Validieren, dass EPIC existiert
-2. Aktuelle Datei lesen
-3. Angefordertes Feld ändern
-4. Änderungsdatum aktualisieren
-5. Datei speichern
-6. Index aktualisieren, falls erforderlich
-
-## Ausgabeformat
-
-```
-✅ EPIC aktualisiert!
-
-📋 EPIC-001: Authentifizierungssystem
-
-Änderung:
-  Priorität: High → Medium
-
-Datei: project-management/backlog/epics/EPIC-001-authentication-system.md
-```
-
-## Beispiele
-
-```
-# Interaktiver Modus
-/project:update-epic EPIC-001
-
-# Name ändern
-/project:update-epic EPIC-001 name "Authentifizierung und Autorisierung"
-
-# Priorität ändern
-/project:update-epic EPIC-001 priority Low
-
-# MMF ändern
-/project:update-epic EPIC-001 mmf "SSO und 2FA ermöglichen"
-```
-
-## Validierung
-
-- Feld muss änderbar sein
-- Priorität muss High, Medium oder Low sein
-- Name darf nicht leer sein
+Führen Sie `/project:backlog edit epic $ARGUMENTS` aus: Lesen Sie `.claude/commands/project/backlog.md` und folgen Sie der Datei mit diesen Argumenten.