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

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

@@ -1,20 +1,32 @@
 ---
-description: Préparation du Début de Sprint
-argument-hint: [arguments]
+description: "Préparation du début de sprint : dossier de sprint, entrées sprint-status.yaml et décomposition en tâches"
+argument-hint: "<N> [--tasks-only]"
 ---
 
 # Préparation du Début de Sprint
 
-Tu es un Scrum Master expérimenté. Tu dois préparer et faciliter le démarrage d'un nouveau sprint en vérifiant que toutes les conditions sont réunies.
+Tu es un Scrum Master et Tech Lead expérimenté. Tu dois préparer et faciliter le démarrage d'un nouveau sprint : vérifier les conditions, créer le dossier du sprint, enregistrer le sprint dans `.bmad/sprint-status.yaml` et décomposer les stories en tâches (Sprint Planning Partie 2, « Le Comment »).
+
+## Usage
+
+| Invocation | Ce que ça fait | Remplace |
+|------------|----------------|----------|
+| `/workflow:start <N>` | Démarrage complet : prérequis, capacité, planning, `project-management/sprints/sprint-{N}-{slug}/` (sprint-goal.md, sprint-dependencies.md, board.md, `tasks/TASK-*.md`), sprint et stories écrits dans `.bmad/sprint-status.yaml`, tâches enregistrées | étapes de démarrage `/sprint:*` |
+| `/workflow:start <N> --tasks-only` | Décompose en tâches les stories d'un sprint **existant** (Étapes 7 à 9 uniquement, sauter les Étapes 1 à 6) | `/workflow:start <N>` |
 
 ## Arguments
 $ARGUMENTS
 
 Arguments :
-- Numéro du sprint (ex: `5`)
-- (Optionnel) Durée en jours (défaut: 10 jours = 2 semaines)
+- Numéro du sprint (ex : `5`, `005`) ; s'il est absent, demander quel sprint démarrer
+- (Optionnel) Durée en jours (défaut : 10 jours = 2 semaines)
+- `--tasks-only` : décompose uniquement en tâches les stories d'un sprint existant
+
+Exemples : `/workflow:start 5`, `/workflow:start 5 --tasks-only`
 
-Exemple : `/workflow:start 5`
+> **Le Plan Mode est obligatoire pour la décomposition** (Étape 7) : analyser le code impacté, proposer le découpage en tâches et attendre la validation avant d'écrire des fichiers.
+
+> **Le statut vit dans `.bmad/sprint-status.yaml`** (schéma : `.claude/templates/project/sprint-status.md`), jamais dans le markdown. Les fichiers de sprint, de tâches et de board ne contiennent que du contenu.
 
 ## MISSION
 
@@ -136,17 +148,21 @@ Pour chaque US sélectionnée :
 
 ### Étape 4 : Créer la Structure Sprint
 
-Créer le dossier du sprint :
+Créer le dossier du sprint (templates dans `.claude/templates/project/`) :
 
 ```
 project-management/
 └── sprints/
-    └── sprint-{N}-{objectif}/
+    └── sprint-{N}-{slug}/
         ├── sprint-goal.md
-        ├── sprint-backlog.md
-        ├── daily-notes/
-        │   ├── {YYYY-MM-DD}.md
+        ├── sprint-dependencies.md
+        ├── board.md                  # vue Kanban unique, contenu seul
+        ├── tasks/
+        │   ├── README.md             # vue d'ensemble : tâches groupées par US
+        │   ├── TASK-001.md           # un fichier par tâche (.claude/templates/project/task.md)
         │   └── ...
+        ├── daily-notes/
+        │   └── {YYYY-MM-DD}.md
         ├── sprint-review.md
         └── sprint-retro.md
 ```
@@ -226,7 +242,7 @@ Points |
 
 ### Étape 6 : Synchroniser `.bmad/sprint-status.yaml`
 
-`/gate:validate-sprint` et les commandes `/sprint:*` lisent le sprint dans `.bmad/sprint-status.yaml`. L'écrire maintenant à partir du `sprint-goal.md` ci-dessus et des fiches US sélectionnées (`project-management/backlog/user-stories/US-*.md`) :
+`/gate:check sprint` et `/workflow:implement` lisent le sprint dans `.bmad/sprint-status.yaml`. L'écrire maintenant à partir du `sprint-goal.md` ci-dessus et des fiches US sélectionnées (`project-management/backlog/user-stories/US-*.md`) :
 
 1. Créer `.bmad/` s'il n'existe pas.
 2. `metadata` : `sprint_id` (`sprint-{N}`), `name`, `start_date`, `end_date`, `goal`, `capacity_points`, repris de `sprint-goal.md`.
@@ -260,7 +276,83 @@ archived_sprints:
       US-001: { status: "done", points: 5 }
 ```
 
-### Étape 7 : Checklist Finale
+### Étape 7 : Décomposer les Stories en Tâches
+
+Lire `sprint-goal.md`, `sprint-dependencies.md` et chaque US référencée dans `project-management/backlog/user-stories/` (avec `--tasks-only`, commencer ici). Adapter les types de tâches à la stack réelle du projet (lire `CLAUDE.md` / `.claude/rules/`) ; le tableau ci-dessous est un exemple typique.
+
+| Couche | Préfixe | Tâches typiques |
+|--------|---------|-----------------|
+| Base de données | `[DB]` | Entité, migration, repository, fixtures |
+| Backend | `[BE]` | Service, ressource API, DTO, processor, voter |
+| Frontend Web | `[FE-WEB]` | Contrôleur, template, composant |
+| Frontend Mobile | `[FE-MOB]` | Modèle, repository, état, écran |
+| Tests | `[TEST]` | Unitaires, intégration, API, E2E |
+| Documentation | `[DOC]` | Doc du code, README, OpenAPI |
+| DevOps | `[OPS]` | Docker, CI/CD |
+| Revue | `[REV]` | Code review |
+
+**Bonne tâche (SMART)** : Spécifique (action claire), Mesurable (on sait quand c'est fini), Assignable (un seul responsable), Réaliste, Temporellement définie (estimée en heures, pas en points).
+
+**Règles de taille** : minimum 30 min, maximum 8 h (1 jour), idéal 2 à 4 h. Au-delà de 8 h : découper en sous-tâches.
+
+**Découpage vertical** : chaque US reçoit les tâches DB + API + front + tests + doc + revue selon le besoin. Taille typique : CRUD simple ~15 tâches, fonctionnalité métier ~18, UI seule ~11.
+
+Pour chaque US, créer un `tasks/TASK-{NNN}.md` par tâche à partir de `.claude/templates/project/task.md` (les IDs continuent après le dernier `TASK-*` existant, comme le fait `/project:backlog add task`) avec : type, estimation, `Depends on`, description, fichiers à créer ou modifier, critères de validation. Puis ajouter une section dans `tasks/README.md` :
+
+```markdown
+## US-XXX : [Titre] (Epic EPIC-XXX, [X] points)
+
+| ID | Type | Tâche | Estimation | Dépend de |
+|----|------|-------|------------|-----------|
+| TASK-001 | [DB] | Créer l'entité [Nom] | 2h | - |
+| TASK-002 | [DB] | Migration | 1h | TASK-001 |
+| TASK-003 | [BE] | Ressource API | 3h | TASK-001 |
+| TASK-004 | [TEST] | Tests API | 2h | TASK-003 |
+
+**Total estimé** : XXh
+```
+
+Ajouter les dépendances sous forme de graphe Mermaid (`TASK-001 --> TASK-002`) et un récapitulatif par couche (tâches et heures). Ajouter aussi une section « Tâches techniques transverses » (environnement, mises à jour de dépendances, pipeline CI, refactoring identifié) avec un `tasks/TASK-{NNN}.md` chacune (sans US).
+
+Règles :
+1. Estimation en heures (pas en points)
+2. Une tâche = un responsable
+3. Max 2 tâches en cours par personne
+4. Dépendances explicites (graphe Mermaid)
+
+### Étape 8 : Board et Vue d'Ensemble des Tâches
+
+Créer `board.md` (template `.claude/templates/project/board.md`) :
+
+```markdown
+# Task Board - Sprint {N}
+
+> Vue générée : régénérée depuis `.bmad/sprint-status.yaml` par `/workflow:status --board`. Ne pas éditer à la main.
+
+## to-do
+| ID | US | Tâche | Estimation | Assigné |
+|----|-----|-------|------------|---------|
+
+## in-progress | review | done | blocked
+(même mise en forme, un tableau par colonne)
+
+## Métriques
+- **Tâches** : X au total | X terminées (X%)
+- **Heures** : Xh estimées | Xh passées | Xh restantes
+```
+
+`tasks/README.md` contient aussi le tableau de synthèse (US, titre, points, tâches, heures), la répartition par type et les conventions : ID `TASK-[NNN]`, taille 0,5 h à 8 h, statuts suivis dans `.bmad/sprint-status.yaml` (`to-do | in-progress | done | blocked`).
+
+### Étape 9 : Enregistrer les Tâches dans `.bmad/sprint-status.yaml`
+
+Pour chaque tâche créée (tâches d'US et tâches transverses), selon `.claude/templates/project/sprint-status.md` :
+
+1. Créer `.bmad/sprint-status.yaml` depuis le squelette de `/workflow:init` s'il n'existe pas (avec `--tasks-only`, le sprint et les stories existent déjà ; sinon, lancer le `/workflow:start <N>` complet)
+2. Ajouter les ids TASK à `stories.<US>.tasks.list`
+3. Définir `stories.<US>.tasks.status.<TASK>: to-do`
+4. Mettre à jour `stories.<US>.tasks.total` (`completed` reste le nombre de tâches `done`)
+
+### Étape 10 : Checklist Finale
 
 ```
 ══════════════════════════════════════════════════════════════
@@ -327,17 +419,15 @@ archived_sprints:
 ║                   PROCHAINE ÉTAPE                        ║
 ╠══════════════════════════════════════════════════════════╣
 ║                                                          ║
-║  → /gate:validate-sprint {N}                             ║
+║  → /gate:check sprint {N}                                ║
 ║    Vérifier que le sprint est prêt (gate)                ║
 ║                                                          ║
-║  → /sprint:next-story                                    ║
-║    Prendre la première story du sprint backlog           ║
-║                                                          ║
-║  → /sprint:dev                                           ║
+║  → /workflow:implement {N}                               ║
 ║    Démarrer le développement TDD/BDD                     ║
 ║                                                          ║
 ║  Voir aussi :                                            ║
-║  • /workflow:status  — Vérifier la progression           ║
+║  • /project:backlog next story — Prendre la 1re story    ║
+║  • /workflow:status  — Suivre l'avancement du sprint     ║
 ║                                                          ║
 ╚══════════════════════════════════════════════════════════╝
 ```