La spirale herméneutique¶
L'image¶
Un projet produit n'est compris ni par le haut (la vision abstraite, les KPI sponsors) ni par le bas (les tickets, les user stories, le backlog). Il se comprend par va-et-vient entre les deux — et chaque passage enrichit les deux bouts.
flowchart TB
V[Vision systémique<br/>JTBD, problème structurel]
BE[Business Epic<br/>hypothèse]
FE[Feature<br/>capacité]
US[Récit<br/>interaction concrète]
T[Test, feedback<br/>utilisateur réel]
V -->|hypothèse| BE
BE -->|découpage| FE
FE -->|scénario| US
US -->|exécution| T
T -.->|remonte| US
US -.->|clarifie| FE
FE -.->|révise| BE
BE -.->|affine| V
style V fill:#00acc1,stroke:#006064,color:#fff
style T fill:#546e7a,stroke:#263238,color:#fff
Chaque flèche pleine est une descente : on matérialise l'ambition dans un grain plus concret. Chaque flèche pointillée est une remontée : le réel rencontré au grain concret remonte et corrige l'abstraction.
Le terme emprunté à la philosophie¶
En herméneutique philosophique (Gadamer, Ricœur), on parle du cercle herméneutique : pour comprendre un texte, il faut déjà avoir une pré-compréhension du tout ; mais cette pré-compréhension ne devient fiable qu'en s'affrontant aux détails. On ne sort pas du cercle — on le parcourt mieux à chaque tour.
Transposé au produit : comprendre un Business Epic exige une vision ; mais la vision ne devient vraie qu'en rencontrant la Feature qu'elle décline ; et la Feature n'est vraie qu'en rencontrant le Récit utilisateur. À chaque descente, on découvre un détail qui oblige à rectifier l'abstraction supérieure.
Ce n'est pas une boucle. C'est une spirale : on revient, mais à un niveau de compréhension supérieur.
Pourquoi la cascade échoue¶
La planification en cascade postule que :
- La vision est complète avant le cadrage.
- Le cadrage est complet avant le découpage.
- Le découpage est complet avant l'implémentation.
- L'implémentation est complète avant le test.
Chaque étape livre son artefact à la suivante et ne revient plus. Cela marche pour un pont : la portée est connue, les matériaux aussi, les conditions de charge sont mesurées.
Cela échoue pour un produit : la valeur vraie n'est jamais connue avant d'être rencontrée. La vision « évidente » en comité s'effondre au premier test utilisateur. La Feature « simple » révèle une complexité systémique au moment du découpage. Le Récit « clair » se heurte à une contrainte technique qui force à réviser la Feature — et parfois le Business Epic.
Pourquoi le bottom-up naïf échoue aussi¶
À l'inverse, certaines équipes refusent toute vision et accumulent des user stories en espérant que « le produit émerge du backlog ». C'est une illusion : sans ambition globale, les Récits s'additionnent sans composer. On livre 100 features cohérentes individuellement, qui ne forment pas un produit.
Ce que fait le kit¶
Le kit ne prescrit pas la spirale — il la rend visible et traçable.
- Chaque niveau a ses objets : Business Epic, Feature, Récit. Chacun a son cycle de vie propre.
- Chaque transition entre niveaux passe par une porte : G1 (Vision arrêtée sur la BE) → G2 (Plan de dév BE arrêté) → G3 (Plan de fab FE arrêté) → G4 (Incrément US livré) descendent la spirale. La revue MVP remonte, avec un verdict
PERSEVERE/PIVOTED/TERMINEqui peut faire revenir au cadrage via la boucleMVP→G1. - La remontée est explicite : quand la revue MVP renvoie
PIVOTED, la Feature concernée n'est pas abandonnée — son Business Epic est reinterrogé. L'étatPIVOTEDest un état terminal du bas qui nourrit une nouvelle ambition en haut. Quand elle renvoiePERSEVERE, la BE retourne explicitement enVISION_EN_COURSpour un nouveau cycle (Re-G1). - L'agent orchestrateur (« Coach Développement Émergent ») est explicitement un guide de la spirale : il demande où nous sommes, propose la descente ou la remontée, appelle les skills appropriés.
Signes que la spirale est respectée¶
- Un Business Epic se raffine au fil des vagues, pas en une passe.
- Le backlog de User Stories ne grossit pas linéairement — il se restructure parfois (remontées qui archivent des US devenues caduques).
- Les décisions de pivot sont tracées comme des réussites de la spirale (on a appris), pas comme des échecs.
- Les sessions IA commencent par relire
spiral-state.md— pas par attaquer la première tâche du backlog.
Signes que la spirale est court-circuitée¶
- On rédige 50 User Stories avant d'avoir validé une Feature.
- On fige un Business Epic au début du projet et on ne le rouvre jamais.
- Un bilan MVP conclut
TERMINEouPERSEVEREsans que personne ne remonte vers la Feature pour tirer les leçons. spiral-state.mdn'est plus à jour — personne ne sait où on est.
Voir aussi : LIVING / COLD · Juste assez · Les 4 portes · Agent Coach Émergent.