Skip to content

Guide de Gestion du Backlog ​

Workflow complet pour créer et gérer un backlog SCRUM avec Bear-Craft.


Vue d'ensemble ​

Bear-Craft fournit un ensemble complet de commandes pour gérer votre product backlog selon la méthodologie SCRUM :

  • Une commande /bear-project:backlog (add, list, edit, move, plus next story et move story --auto pour le routage des stories) ainsi que /bear-workflow:plan --only=backlog, /bear-workflow:start, /bear-workflow:status --board, /bear-project:reverse, /bear-project:trace, /bear-project:report et /bear-project:migrate pour le backlog et la gestion de projet ; les anciennes commandes par entité (add-, list-, update-*, move-task, generate-backlog, decompose-tasks, board) et le namespace sprint ont été retirées en 9.0 (voir MIGRATION-v9)
  • Le chemin /workflow: (init, plan, design, start, implement, review, retro, status) pour le cycle de sprint
  • Une commande /bear-gate:check (prd, spec, backlog, sprint, story, alignment, all, commit, merge, release) pour la validation qualité
  • Vertical slicing obligatoire sur toutes les couches tech
  • Validation INVEST pour les User Stories

Philosophie ​

Basé sur :

  • Les principes du Manifeste Agile
  • Les 12 Principes Agile
  • Les fondamentaux SCRUM
  • Le vertical slicing (chaque US traverse toutes les couches)

Génération Initiale du Backlog ​

Depuis les Spécifications ​

Placez vos spécifications projet dans ./docs/ puis exécutez :

bash
/bear-workflow:plan --only=backlog symfony+flutter

Structure Générée ​

project-management/
├── README.md                    # Vue d'ensemble du projet
├── personas.md                  # Personas utilisateurs (min. 3)
├── definition-of-done.md        # Niveaux DoD progressifs
├── dependencies-matrix.md       # Dépendances Epic et US
├── backlog/
│   ├── epics/                   # Fichiers EPIC-XXX-nom.md
│   └── user-stories/            # Fichiers US-XXX-nom.md
└── sprints/
    └── sprint-XXX-objectif/     # Plans de sprint

Structure SCRUM ​

Personas ​

Minimum 3 personas requis, chacun avec :

  • Identité : Nom, rôle, démographiques
  • Objectifs : Ce qu'ils veulent accomplir
  • Frustrations : Points de douleur à résoudre

Format : P-001, P-002, P-003...

EPICs ​

Grandes fonctionnalités contenant plusieurs User Stories :

ChampDescription
IDIdentifiant unique (EPIC-001, EPIC-002...)
MMFMinimum Marketable Feature
StatutDraft, Ready, In Progress, Done
Objectifs BusinessPourquoi cet EPIC est important
Critères de SuccèsComment mesurer le succès

User Stories ​

Suivent le modèle INVEST :

LettreSignificationValidation
IIndependentPas de dépendances avec d'autres US
NNégociableLes détails peuvent être discutés
VValuableApporte de la valeur utilisateur
EEstimablePeut être dimensionnée en points
SSizedMax 8 story points
TTestableA des critères d'acceptation clairs

Les 3 Cs ​

  1. Card : Description breve
  2. Conversation : Détails de discussion
  3. Confirmation : Critères d'acceptation

Critères d'Acceptation (Gherkin) ​

Chaque US requiert :

  • 1 scenario nominal (happy path)
  • 2 scenarios alternatifs
  • 2 scenarios d'erreur
gherkin
Scenario: L'utilisateur se connecte avec succès
  Given un utilisateur enregistré avec des identifiants valides
  When il soumet le formulaire de connexion
  Then il devrait voir son tableau de bord
  And une session devrait être créée

Tasks (Tâches) ​

Éléments de travail technique dans une User Story :

TypeDescriptionDurée Typique
[DB]Base de données (entités, migrations)1-3h
[BE]Backend (services, APIs)2-4h
[FE-WEB]Frontend Web (contrôleurs, templates)2-4h
[FE-MOB]Frontend Mobile (écrans, blocs)3-5h
[TEST]Tests (unitaires, intégration, E2E)2-4h
[DOC]Documentation0.5-1h
[OPS]DevOps (CI/CD, déploiement)1-2h
[REV]Revue de code1-2h

Règles d'estimation :

  • Durée de tâche : 0.5h - 8h max
  • Story points (Fibonacci) : 1, 2, 3, 5, 8, 13, 21
  • Taille max US : 8 points (découper si plus)

Workflow ​

Flux de Statuts ​

┌─────────┐     ┌─────────────┐     ┌──────┐
│  To Do  │ ──→ │ In Progress │ ──→ │ Done │
└─────────┘     └─────────────┘     └──────┘
     │                │
     │                ↓
     └────────→ ┌─────────┐
                │ Blocked │
                └─────────┘
                     │
                     ↓
              ┌─────────────┐
              │ In Progress │
              └─────────────┘

Transitions interdites :

  • To Do → Done (doit passer par In Progress)
  • Any → To Do (sauf réouverture manuelle)

Référence des Commandes ​

Commandes de Création ​

CommandeDescription
/bear-workflow:plan --only=backlog [stack]Générer le backlog complet depuis les specs
/bear-project:backlog add epicCréer un nouvel EPIC
/bear-project:backlog add storyAjouter une User Story à un EPIC
/bear-project:backlog add taskCréer une tâche technique pour une US

Commandes de Visualisation ​

CommandeDescription
/bear-project:backlog list epicAfficher tous les EPICs avec statut
/bear-project:backlog list story [filtre]Lister les User Stories (par EPIC, Sprint, Statut)
/bear-project:backlog list task [filtre]Lister les tâches (par US, Sprint, Type, Statut)
/bear-workflow:status --board [sprint]Afficher le tableau Kanban
/bear-workflow:status [sprint]Rapport détaillé de progression du sprint

Commandes de Mise à Jour ​

CommandeDescription
/bear-project:backlog move story [id] [statut/sprint]Changer le statut de l'US ou assigner au sprint
/bear-project:backlog move task [id] [statut]Changer le statut de la tâche
/bear-project:backlog edit epic [id]Modifier un EPIC existant
/bear-project:backlog edit story [id]Modifier une User Story existante

Commandes Avancées ​

CommandeDescription
/bear-workflow:start [sprint]Décomposer les US du sprint en tâches
/bear-gate:check backlogAuditer la qualité du backlog (conformite SCRUM)

Exemple Complet : Nouveau Projet ​

Étape 1 : Générer le Backlog Initial ​

bash
# S'assurer que les specs sont dans ./docs/
/bear-workflow:plan --only=backlog symfony+flutter

Étape 2 : Valider la Qualité ​

bash
/bear-gate:check backlog

Cela génère scrum-validation-report.md avec :

  • Score de conformité INVEST
  • Vérification des 3 Cs
  • Analyse des critères SMART
  • Cohérence des estimations

Étape 3 : Examiner le Sprint 1 ​

bash
/bear-workflow:status --board 1

Affiche le tableau Kanban avec les colonnes :

  • To Do | In Progress | In Review | Done | Blocked

On peut aussi gérer le backlog depuis l'interface web Kanban (npx @the-bearded-bear/bear-craft kanban) : créer, modifier et supprimer des stories, les planifier dans un sprint, créer, démarrer et clôturer des sprints. Elle complète les commandes /bear-workflow:* et /bear-project:*, qui restent valables et écrivent le même fichier (.bmad/sprint-status.yaml).

Étape 4 : Décomposer en Tâches ​

bash
/bear-workflow:start 1

Crée une décomposition détaillée des tâches :

  • Tâches groupées par US
  • Graphe de dépendances (Mermaid)
  • Estimations de temps par couche

Étape 5 : Commencer le Travail ​

bash
# Déplacer la première tâche en cours
/bear-project:backlog move task TASK-001 in-progress

# Plus tard, marquer comme terminée
/bear-project:backlog move task TASK-001 done

# Si bloquée
/bear-project:backlog move task TASK-002 blocked "En attente des specs API"

Étape 6 : Suivre la Progression ​

bash
/bear-workflow:status 1

Affiche :

  • Progression globale et burndown
  • Métriques par User Story
  • Bloqueurs et risques
  • Actions recommandees

Templates ​

Bear-Craft fournit 5 templates pour une structure de backlog cohérente :

TemplateObjectif
epic.mdStructure de fichier EPIC avec métadonnées, objectifs, liste US
user-story.mdStructure US avec criteres Gherkin, tableau de tâches
task.mdStructure de tâche avec checklist DoD
board.mdTableau Kanban avec calcul de métriques
index.mdIndex du backlog avec résumé global

Règles SCRUM Appliquées ​

RègleValeur
Durée du sprint2 semaines (fixe)
Vélocité20-40 points/sprint
Taille max US8 points (découper si plus)
Échelle d'estimationFibonacci (1, 2, 3, 5, 8, 13, 21)
Durée des tâches0.5h - 8h max

Sprint 1 : Walking Skeleton ​

Le premier sprint doit inclure :

  • Setup complet de l'infrastructure
  • 1 fonctionnalité de bout en bout (pas juste du setup)
  • Testable sur Web et Mobile

Vertical Slicing ​

Chaque User Story DOIT traverser toutes les couches :

UI (Web/Mobile) → API → Logique Métier → Base de Données

Pas de User Stories "Backend uniquement", "Frontend uniquement" ou "Mobile uniquement" autorisées.


Checklist : Backlog Prêt ​

  • [ ] Minimum 3 personas définis
  • [ ] EPICs ont MMF et critères de succès
  • [ ] User Stories suivent le modele INVEST
  • [ ] Critères d'acceptation au format Gherkin
  • [ ] Stories estimées en points Fibonacci
  • [ ] Sprint 1 = Walking Skeleton
  • [ ] Definition of Done documentée
  • [ ] Backlog validé (/bear-gate:check backlog)

← Résolution de Problèmes | Suivant : Installation Nouveau Projet →