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

package/Dev/i18n/de/Workflow/commands/start.md

@@ -1,20 +1,32 @@
 ---
-description: Sprint Start Vorbereitung
-argument-hint: [arguments]
+description: "Sprint-Start-Vorbereitung: Sprint-Ordner, sprint-status.yaml-Einträge und Zerlegung in Tasks"
+argument-hint: "<N> [--tasks-only]"
 ---
 
-# Sprint Start Vorbereitung
+# Sprint-Start-Vorbereitung
 
-Sie sind ein erfahrener Scrum Master. Sie müssen den Start eines neuen Sprints vorbereiten und facilitieren, indem Sie überprüfen, dass alle Bedingungen erfüllt sind.
+Du bist ein erfahrener Scrum Master und Tech Lead. Du bereitest den Start eines neuen Sprints vor und moderierst ihn: Bedingungen prüfen, den Sprint-Ordner anlegen, den Sprint in `.bmad/sprint-status.yaml` registrieren und die Stories in Tasks zerlegen (Sprint Planning Teil 2, „Das Wie“).
+
+## Verwendung
+
+| Aufruf | Was er tut | Ersetzt |
+|--------|-----------|---------|
+| `/workflow:start <N>` | Kompletter Start: Voraussetzungen, Kapazität, Planning, `project-management/sprints/sprint-{N}-{slug}/` (sprint-goal.md, sprint-dependencies.md, board.md, `tasks/TASK-*.md`), Sprint und Stories in `.bmad/sprint-status.yaml` geschrieben, Tasks registriert | Start-Schritte von `/sprint:*` |
+| `/workflow:start <N> --tasks-only` | Zerlegt die Stories eines **bestehenden** Sprints in Tasks (nur Schritte 7 bis 9, Schritte 1 bis 6 überspringen) | `/workflow:start <N>` |
 
 ## Argumente
 $ARGUMENTS
 
 Argumente:
-- Sprint-Nummer (z.B. `5`)
+- Sprint-Nummer (z. B. `5`, `005`); falls fehlend, fragen, welcher Sprint gestartet wird
 - (Optional) Dauer in Tagen (Standard: 10 Tage = 2 Wochen)
+- `--tasks-only`: zerlegt nur die Stories eines bestehenden Sprints in Tasks
+
+Beispiele: `/workflow:start 5`, `/workflow:start 5 --tasks-only`
+
+> **Plan Mode ist für die Zerlegung Pflicht** (Schritt 7): betroffenen Code analysieren, die Task-Aufteilung vorschlagen und die Freigabe abwarten, bevor Dateien geschrieben werden.
 
-Beispiel: `/workflow:start 5`
+> **Der Status lebt in `.bmad/sprint-status.yaml`** (Schema: `.claude/templates/project/sprint-status.md`), nie im Markdown. Sprint-, Task- und Board-Dateien enthalten nur Inhalt.
 
 ## MISSION
 
@@ -136,19 +148,23 @@ Für jede ausgewählte US:
 
 ### Schritt 4: Sprint-Struktur erstellen
 
-Sprint-Ordner erstellen:
+Sprint-Ordner anlegen (Vorlagen in `.claude/templates/project/`):
 
 ```
 project-management/
-   sprints/
-       sprint-{N}-{ziel}/
-           sprint-goal.md
-           sprint-backlog.md
-           daily-notes/
-              {YYYY-MM-DD}.md
-              ...
-           sprint-review.md
-           sprint-retro.md
+└── sprints/
+    └── sprint-{N}-{slug}/
+        ├── sprint-goal.md
+        ├── sprint-dependencies.md
+        ├── board.md                  # einzige Kanban-Ansicht, nur Inhalt
+        ├── tasks/
+        │   ├── README.md             # Übersicht: Tasks nach US gruppiert
+        │   ├── TASK-001.md           # eine Datei pro Task (.claude/templates/project/task.md)
+        │   └── ...
+        ├── daily-notes/
+        │   └── {YYYY-MM-DD}.md
+        ├── sprint-review.md
+        └── sprint-retro.md
 ```
 
 ### Schritt 5: sprint-goal.md Template
@@ -226,7 +242,7 @@ Punkte |
 
 ### Schritt 6: `.bmad/sprint-status.yaml` synchronisieren
 
-`/gate:validate-sprint` und die `/sprint:*`-Befehle lesen den Sprint aus `.bmad/sprint-status.yaml`. Die Datei jetzt aus der obigen `sprint-goal.md` und den ausgewählten US-Dateien (`project-management/backlog/user-stories/US-*.md`) schreiben:
+`/gate:check sprint` und `/workflow:implement` lesen den Sprint aus `.bmad/sprint-status.yaml`. Schreibe die Datei jetzt aus dem obigen `sprint-goal.md` und den ausgewählten US-Dateien (`project-management/backlog/user-stories/US-*.md`):
 
 1. `.bmad/` anlegen, falls nicht vorhanden.
 2. `metadata`: `sprint_id` (`sprint-{N}`), `name`, `start_date`, `end_date`, `goal`, `capacity_points`, aus `sprint-goal.md` übernommen.
@@ -260,7 +276,83 @@ archived_sprints:
       US-001: { status: "done", points: 5 }
 ```
 
-### Schritt 7: Finale Checkliste
+### Schritt 7: Stories in Tasks zerlegen
+
+`sprint-goal.md`, `sprint-dependencies.md` und jede referenzierte US in `project-management/backlog/user-stories/` lesen (mit `--tasks-only` hier beginnen). Die Task-Typen an den tatsächlichen Stack des Projekts anpassen (`CLAUDE.md` / `.claude/rules/` lesen); die folgende Tabelle ist ein typisches Beispiel.
+
+| Schicht | Präfix | Typische Tasks |
+|---------|--------|----------------|
+| Datenbank | `[DB]` | Entity, Migration, Repository, Fixtures |
+| Backend | `[BE]` | Service, API-Resource, DTO, Processor, Voter |
+| Frontend Web | `[FE-WEB]` | Controller, Template, Komponente |
+| Frontend Mobile | `[FE-MOB]` | Modell, Repository, State, Screen |
+| Tests | `[TEST]` | Unit, Integration, API, E2E |
+| Dokumentation | `[DOC]` | Code-Doku, README, OpenAPI |
+| DevOps | `[OPS]` | Docker, CI/CD |
+| Review | `[REV]` | Code Review |
+
+**Guter Task (SMART)**: Spezifisch (klare Aktion), Messbar (man weiß, wann er fertig ist), Zuweisbar (ein einziger Verantwortlicher), Realistisch, Terminiert (in Stunden geschätzt, nicht in Punkten).
+
+**Größenregeln**: Minimum 30 Min., Maximum 8 h (1 Tag), ideal 2 bis 4 h. Über 8 h: in Subtasks aufteilen.
+
+**Vertikaler Schnitt**: Jede US erhält je nach Bedarf DB-, API-, Frontend-, Test-, Doku- und Review-Tasks. Typische Größe: einfaches CRUD ~15 Tasks, Business-Feature ~18, nur UI ~11.
+
+Für jede US pro Task ein `tasks/TASK-{NNN}.md` aus `.claude/templates/project/task.md` erstellen (die IDs setzen nach dem letzten vorhandenen `TASK-*` fort, wie bei `/project:backlog add task`) mit: Typ, Schätzung, `Depends on`, Beschreibung, zu erstellende oder zu ändernde Dateien, Validierungskriterien. Danach einen Abschnitt in `tasks/README.md` ergänzen:
+
+```markdown
+## US-XXX: [Titel] (Epic EPIC-XXX, [X] Punkte)
+
+| ID | Typ | Task | Schätzung | Abhängig von |
+|----|-----|------|-----------|--------------|
+| TASK-001 | [DB] | Entity [Name] erstellen | 2h | - |
+| TASK-002 | [DB] | Migration | 1h | TASK-001 |
+| TASK-003 | [BE] | API-Resource | 3h | TASK-001 |
+| TASK-004 | [TEST] | API-Tests | 2h | TASK-003 |
+
+**Geschätzt gesamt**: XXh
+```
+
+Die Abhängigkeiten als Mermaid-Graph (`TASK-001 --> TASK-002`) und eine Zusammenfassung pro Schicht (Tasks und Stunden) ergänzen. Außerdem einen Abschnitt „Übergreifende technische Tasks“ (Umgebung, Dependency-Updates, CI-Pipeline, identifiziertes Refactoring) mit je einem `tasks/TASK-{NNN}.md` (ohne US) hinzufügen.
+
+Regeln:
+1. Schätzung in Stunden (nicht in Punkten)
+2. Ein Task = ein Verantwortlicher
+3. Max. 2 Tasks in Arbeit pro Person
+4. Explizite Abhängigkeiten (Mermaid-Graph)
+
+### Schritt 8: Board und Task-Übersicht
+
+`board.md` erstellen (Vorlage `.claude/templates/project/board.md`):
+
+```markdown
+# Task Board - Sprint {N}
+
+> Generierte Ansicht: aus `.bmad/sprint-status.yaml` durch `/workflow:status --board` neu erzeugt. Nicht von Hand bearbeiten.
+
+## to-do
+| ID | US | Task | Schätzung | Zugewiesen |
+|----|-----|------|-----------|-----------|
+
+## in-progress | review | done | blocked
+(gleiches Layout, eine Tabelle pro Spalte)
+
+## Metriken
+- **Tasks**: X gesamt | X abgeschlossen (X%)
+- **Stunden**: Xh geschätzt | Xh aufgewendet | Xh verbleibend
+```
+
+`tasks/README.md` enthält außerdem die Übersichtstabelle (US, Titel, Punkte, Tasks, Stunden), die Aufteilung nach Typ und die Konventionen: ID `TASK-[NNN]`, Größe 0,5 h bis 8 h, Status in `.bmad/sprint-status.yaml` geführt (`to-do | in-progress | done | blocked`).
+
+### Schritt 9: Tasks in `.bmad/sprint-status.yaml` registrieren
+
+Für jeden erstellten Task (US-Tasks und übergreifende Tasks), gemäß `.claude/templates/project/sprint-status.md`:
+
+1. `.bmad/sprint-status.yaml` aus dem Skelett von `/workflow:init` erstellen, falls nicht vorhanden (mit `--tasks-only` existieren Sprint und Stories bereits; andernfalls das vollständige `/workflow:start <N>` ausführen)
+2. Die TASK-IDs an `stories.<US>.tasks.list` anhängen
+3. `stories.<US>.tasks.status.<TASK>: to-do` setzen
+4. `stories.<US>.tasks.total` aktualisieren (`completed` bleibt die Anzahl der `done`-Tasks)
+
+### Schritt 10: Finale Checkliste
 
 ```
 ══════════════════════════════════════════════════════════════
@@ -324,20 +416,18 @@ archived_sprints:
 
 ```
 ╔══════════════════════════════════════════════════════════╗
-║                   NÄCHSTER SCHRITT                        ║
+║                    NÄCHSTER SCHRITT                      ║
 ╠══════════════════════════════════════════════════════════╣
 ║                                                          ║
-║  → /gate:validate-sprint {N}                             ║
+║  → /gate:check sprint {N}                                ║
 ║    Prüfen, ob der Sprint bereit ist (Gate)               ║
 ║                                                          ║
-║  → /sprint:next-story                                    ║
-║    Erste Story aus dem Sprint-Backlog auswählen          ║
-║                                                          ║
-║  → /sprint:dev                                           ║
+║  → /workflow:implement {N}                               ║
 ║    TDD/BDD-Entwicklung starten                           ║
 ║                                                          ║
 ║  Siehe auch:                                             ║
-║  • /workflow:status  — Sprint-Fortschritt prüfen         ║
+║  • /project:backlog next story — Erste Story wählen      ║
+║  • /workflow:status  — Sprint-Fortschritt verfolgen      ║
 ║                                                          ║
 ╚══════════════════════════════════════════════════════════╝
 ```