Aller au contenu
đŸ€– Consolidated, AI-optimized BMAD docs: llms-full.txt. Fetch this plain text file for complete context.

Pourquoi le Solutioning est Important

La Phase 3 (Solutioning) traduit le quoi construire (issu de la Planification) en comment le construire (conception technique). Cette phase Ă©vite les conflits entre agents dans les projets multi-epics en documentant les dĂ©cisions architecturales avant le dĂ©but de l’implĂ©mentation.

Agent 1 implémente l'Epic 1 avec une API REST
Agent 2 implémente l'Epic 2 avec GraphQL
Résultat : Conception d'API incohérente, cauchemar d'intégration

Lorsque plusieurs agents implĂ©mentent diffĂ©rentes parties d’un systĂšme sans orientation architecturale partagĂ©e, ils prennent des dĂ©cisions techniques indĂ©pendantes qui peuvent entrer en conflit.

le workflow architecture décide : "Utiliser GraphQL pour toutes les API"
Tous les agents suivent les décisions d'architecture
Résultat : Implémentation cohérente, pas de conflits

En documentant les dĂ©cisions techniques de maniĂšre explicite, tous les agents implĂ©mentent de façon cohĂ©rente et l’intĂ©gration devient simple.

AspectPlanification (Phase 2)Solutioning (Phase 3)
QuestionQuoi et Pourquoi ?Comment ? Puis Quelles unités de travail ?
SortieFRs/NFRs (Exigences)1Architecture + Epics2/Stories3
AgentPMArchitect → PM
AudienceParties prenantesDéveloppeurs
DocumentPRD4 (FRs/NFRs)Architecture + Fichiers Epics
NiveauLogique métierConception technique + Décomposition du travail

Rendre les décisions techniques explicites et documentées pour que tous les agents implémentent de maniÚre cohérente.

Cela évite :

  • Les conflits de style d’API (REST vs GraphQL)
  • Les incohĂ©rences de conception de base de donnĂ©es
  • Les dĂ©saccords sur la gestion du state
  • Les inadĂ©quations de conventions de nommage
  • Les variations d’approche de sĂ©curitĂ©
ParcoursSolutioning Requis ?
Quick DevNon - l’ignore complùtement
Méthode BMad SimpleOptionnel
Méthode BMad ComplexeOui
EnterpriseOui

Sauter le solutioning sur des projets complexes entraĂźne :

  • Des problĂšmes d’intĂ©gration dĂ©couverts en milieu de sprint5
  • Du travail rĂ©pĂ©tĂ© dĂ» Ă  des implĂ©mentations conflictuelles
  • Un temps de dĂ©veloppement plus long globalement
  • De la dette technique6 due Ă  des patterns incohĂ©rents
  1. FR / NFR (Functional / Non-Functional Requirement) : exigences dĂ©crivant respectivement ce que le systĂšme doit faire (fonctionnalitĂ©s, comportements attendus) et comment il doit le faire (contraintes de performance, sĂ©curitĂ©, fiabilitĂ©, ergonomie, etc.). ↩

  2. Epic : dans les mĂ©thodologies agiles, une unitĂ© de travail importante qui peut ĂȘtre dĂ©composĂ©e en plusieurs stories plus petites. Un epic reprĂ©sente gĂ©nĂ©ralement une fonctionnalitĂ© majeure ou un objectif mĂ©tier. ↩

  3. Story (User Story) : description courte et simple d’une fonctionnalitĂ© du point de vue de l’utilisateur, utilisĂ©e dans les mĂ©thodologies agiles pour planifier et prioriser le travail. ↩

  4. PRD (Product Requirements Document) : document de rĂ©fĂ©rence qui dĂ©crit les objectifs du produit, les besoins utilisateurs, les fonctionnalitĂ©s attendues, les contraintes et les critĂšres de succĂšs, afin d’aligner les Ă©quipes sur ce qui doit ĂȘtre construit et pourquoi. ↩

  5. Sprint : pĂ©riode de temps fixe (gĂ©nĂ©ralement 1 Ă  4 semaines) dans les mĂ©thodologies agiles durant laquelle l’équipe complĂšte un ensemble prĂ©dĂ©fini de tĂąches. ↩

  6. Dette technique : coĂ»t futur supplĂ©mentaire de travail rĂ©sultant de choix de facilitĂ© ou de raccourcis pris lors du dĂ©veloppement initial, nĂ©cessitant souvent une refonte ultĂ©rieure. ↩