@atlashub/smartstack-cli 4.19.0 → 4.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atlashub/smartstack-cli",
3
- "version": "4.19.0",
3
+ "version": "4.20.0",
4
4
  "description": "SmartStack Claude Code automation toolkit - GitFlow, EF Core migrations, prompts and more",
5
5
  "author": {
6
6
  "name": "SmartStack",
@@ -197,11 +197,11 @@ STEP 06 (review) — CLIENT LOOP ENTRY
197
197
 
198
198
  | File | Questions | Focus |
199
199
  |------|-----------|-------|
200
- | `questionnaire/01-context.md` | ~20 | Problem, current state, vision, triggers |
201
- | `questionnaire/02-stakeholders-scope.md` | ~25 | User profiles, priorities, scope boundaries |
202
- | `questionnaire/03-data-ui.md` | ~20 | Data entities, UI expectations, integrations |
203
- | `questionnaire/04-risks-metrics.md` | ~15 | Risks, success criteria, constraints |
204
- | `questionnaire/05-cross-module.md` | ~10 | Cross-module dependencies, shared data |
200
+ | `questionnaire/01-context.md` | 3 | Business process, friction points, vision |
201
+ | `questionnaire/02-stakeholders-scope.md` | 10 | User profiles, access levels, scope boundaries |
202
+ | `questionnaire/03-data-ui.md` | ~15 | Data entities, UI expectations, dashboards |
203
+ | `questionnaire/04-risks-metrics.md` | | NOT USED (risks/metrics out of BA scope) |
204
+ | `questionnaire/05-cross-module.md` | ~8 | Cross-module dependencies, integration impact |
205
205
 
206
206
  ## Entry Point
207
207
 
@@ -1960,7 +1960,7 @@ body {
1960
1960
  </div>
1961
1961
 
1962
1962
  <!-- SECTION: Risques et hypotheses -->
1963
- <div class="section" id="cadrage-risks" style="display:none;">
1963
+ <div class="section" id="cadrage-risks" style="display:none;" data-vibe-hide>
1964
1964
  <h2 class="section-title">Risques et hypotheses</h2>
1965
1965
  <p class="section-subtitle">Ce qui pourrait mal tourner et les certitudes non verifiees.</p>
1966
1966
 
@@ -2562,7 +2562,7 @@ function buildCadrageItems() {
2562
2562
  return renderNavItem('cadrage-context', 'Contexte') +
2563
2563
  renderNavItem('cadrage-stakeholders', 'Parties prenantes', data.cadrage.stakeholders.length) +
2564
2564
  renderNavItem('cadrage-scope', 'Perimetre fonctionnel') +
2565
- renderNavItem('cadrage-risks', 'Risques et hypotheses', data.cadrage.risks.length) +
2565
+ (isVibeCoding ? '' : renderNavItem('cadrage-risks', 'Risques et hypotheses', data.cadrage.risks.length)) +
2566
2566
  renderNavItem('cadrage-success', 'Criteres de reussite');
2567
2567
  }
2568
2568
 
@@ -4399,7 +4399,7 @@ function renderHandoffStats() {
4399
4399
  <div class="stat-card"><div class="stat-value">${totalStakeholders}</div><div class="stat-label">Profils utilisateurs</div></div>
4400
4400
  <div class="stat-card"><div class="stat-value">${data.dependencies.length}</div><div class="stat-label">Dependances</div></div>
4401
4401
  <div class="stat-card"><div class="stat-value">${data.consolidation.e2eFlows.length}</div><div class="stat-label">Parcours bout en bout</div></div>
4402
- <div class="stat-card"><div class="stat-value">${data.cadrage.risks.length}</div><div class="stat-label">Risques identifies</div></div>
4402
+ ${isVibeCoding ? '' : `<div class="stat-card"><div class="stat-value">${data.cadrage.risks.length}</div><div class="stat-label">Risques identifies</div></div>`}
4403
4403
  `;
4404
4404
  }
4405
4405
 
@@ -1,5 +1,5 @@
1
1
  <!-- SECTION: Risques et hypotheses -->
2
- <div class="section" id="cadrage-risks" style="display:none;">
2
+ <div class="section" id="cadrage-risks" style="display:none;" data-vibe-hide>
3
3
  <h2 class="section-title">Risques et hypotheses</h2>
4
4
  <p class="section-subtitle">Ce qui pourrait mal tourner et les certitudes non verifiees.</p>
5
5
 
@@ -113,7 +113,7 @@ function buildCadrageItems() {
113
113
  return renderNavItem('cadrage-context', 'Contexte') +
114
114
  renderNavItem('cadrage-stakeholders', 'Parties prenantes', data.cadrage.stakeholders.length) +
115
115
  renderNavItem('cadrage-scope', 'Perimetre fonctionnel') +
116
- renderNavItem('cadrage-risks', 'Risques et hypotheses', data.cadrage.risks.length) +
116
+ (isVibeCoding ? '' : renderNavItem('cadrage-risks', 'Risques et hypotheses', data.cadrage.risks.length)) +
117
117
  renderNavItem('cadrage-success', 'Criteres de reussite');
118
118
  }
119
119
 
@@ -24,7 +24,7 @@ function renderHandoffStats() {
24
24
  <div class="stat-card"><div class="stat-value">${totalStakeholders}</div><div class="stat-label">Profils utilisateurs</div></div>
25
25
  <div class="stat-card"><div class="stat-value">${data.dependencies.length}</div><div class="stat-label">Dependances</div></div>
26
26
  <div class="stat-card"><div class="stat-value">${data.consolidation.e2eFlows.length}</div><div class="stat-label">Parcours bout en bout</div></div>
27
- <div class="stat-card"><div class="stat-value">${data.cadrage.risks.length}</div><div class="stat-label">Risques identifies</div></div>
27
+ ${isVibeCoding ? '' : `<div class="stat-card"><div class="stat-value">${data.cadrage.risks.length}</div><div class="stat-label">Risques identifies</div></div>`}
28
28
  `;
29
29
  }
30
30
 
@@ -193,7 +193,7 @@
193
193
  </div>
194
194
 
195
195
  <!-- SECTION: Risques et hypotheses -->
196
- <div class="section" id="cadrage-risks" style="display:none;">
196
+ <div class="section" id="cadrage-risks" style="display:none;" data-vibe-hide>
197
197
  <h2 class="section-title">Risques et hypotheses</h2>
198
198
  <p class="section-subtitle">Ce qui pourrait mal tourner et les certitudes non verifiees.</p>
199
199
 
@@ -1,157 +1,32 @@
1
1
  # Categorie 1 : Contexte metier
2
2
 
3
- > **Usage :** Questions fondamentales pour comprendre le besoin metier en profondeur
3
+ > **Usage :** Questions fondamentales pour comprendre le besoin metier
4
4
  > **Quand charger :** TOUJOURS (noyau)
5
- > **Objectif :** Comprendre le POURQUOI avant de parler du QUOI
5
+ > **Objectif :** Comprendre le processus metier, les frictions, et la vision cible
6
6
 
7
7
  ---
8
8
 
9
- ## 1.1 Le probleme a resoudre
10
-
11
- > **But :** Identifier la douleur reelle, pas la solution imaginee.
9
+ ## 1.1 Le processus metier
12
10
 
13
11
  | # | Question | Type de reponse |
14
12
  |---|----------|-----------------|
15
- | Q1.1 | Decrivez en quelques phrases le probleme que vous rencontrez aujourd'hui. Qu'est-ce qui ne fonctionne pas, ou pas assez bien ? | Texte libre |
16
- | Q1.2 | Qui souffre le plus de ce probleme au quotidien ? Quel impact a-t-il sur leur travail ? | Description des personnes impactees |
17
- | Q1.3 | Depuis combien de temps ce probleme existe-t-il ? A-t-il empire recemment ? | Historique et evolution |
18
-
19
- **Reformulation guidee pour Q1.1 :**
20
- ```
21
- question: "Decrivez le probleme que vous rencontrez aujourd'hui"
22
- header: "Probleme"
23
- options:
24
- - label: "Processus trop lent"
25
- description: "Des taches repetitives prennent trop de temps et ralentissent le travail quotidien"
26
- - label: "Informations dispersees"
27
- description: "Les donnees sont eparpillees entre plusieurs outils, fichiers ou personnes"
28
- - label: "Manque de visibilite"
29
- description: "Impossible de suivre l'avancement, les chiffres ou l'etat d'une situation en temps reel"
30
- - label: "Erreurs frequentes"
31
- description: "Des erreurs humaines se produisent regulierement par manque d'outil adapte"
32
- ```
13
+ | Q1.1 | Decrivez en quelques phrases le processus metier que cette application doit gerer. Qu'est-ce qui se passe, qui intervient, et quel est le resultat attendu ? | Texte libre |
33
14
 
34
15
  ---
35
16
 
36
- ## 1.2 La situation actuelle
37
-
38
- > **But :** Comprendre comment les choses se passent AUJOURD'HUI, concretement.
17
+ ## 1.2 Les points de friction
39
18
 
40
19
  | # | Question | Type de reponse |
41
20
  |---|----------|-----------------|
42
- | Q1.4 | Comment gerez-vous ce sujet aujourd'hui ? Avec quels outils (tableur, email, papier, logiciel) ? | Description des outils et methodes actuels |
43
- | Q1.5 | Decrivez les etapes principales de votre processus actuel, du debut a la fin. | Liste d'etapes ordonnees |
44
- | Q1.6 | Quelles sont les etapes les plus penibles ou les plus longues dans ce processus ? | Points de douleur precis |
45
- | Q1.7 | Quelles erreurs ou problemes reviennent regulierement ? Donnez 2 a 3 exemples concrets. | Exemples de dysfonctionnements |
46
-
47
- **Reformulation guidee pour Q1.4 :**
48
- ```
49
- question: "Comment gerez-vous ce sujet aujourd'hui ?"
50
- header: "Outils"
51
- options:
52
- - label: "Tableur (Excel, Sheets)"
53
- description: "Fichiers Excel ou Google Sheets partages ou individuels"
54
- - label: "Email et documents"
55
- description: "Echanges par email avec pieces jointes, documents Word ou PDF"
56
- - label: "Logiciel existant"
57
- description: "Un logiciel est deja en place mais ne repond plus aux besoins"
58
- - label: "Processus manuel"
59
- description: "Papier, appels telephoniques, reunions en personne"
60
- ```
21
+ | Q1.4 | Quels sont les points de friction actuels ? Qu'est-ce qui bloque, ralentit, ou genere des erreurs dans ce processus ? | Description des frictions |
61
22
 
62
23
  ---
63
24
 
64
- ## 1.3 La situation souhaitee
65
-
66
- > **But :** Definir clairement ce que le client veut OBTENIR, pas ce qu'il veut CONSTRUIRE.
25
+ ## 1.3 La vision souhaitee
67
26
 
68
27
  | # | Question | Type de reponse |
69
28
  |---|----------|-----------------|
70
- | Q1.8 | Si le probleme etait resolu demain, que feriez-vous differemment dans votre journee de travail ? | Description du changement concret |
71
- | Q1.9 | Quels resultats concrets attendez-vous ? Citez 2 a 3 ameliorations mesurables (gain de temps, reduction d'erreurs, meilleure visibilite...). | Liste de resultats attendus |
72
- | Q1.10 | Comment saurez-vous que le projet est un succes ? Quel est le signe visible qui montrera que le probleme est resolu ? | Critere de succes observable |
73
-
74
- **Reformulation guidee pour Q1.8 :**
75
- ```
76
- question: "Si le probleme etait resolu demain, que changeriez-vous dans votre journee ?"
77
- header: "Vision"
78
- options:
79
- - label: "Gain de temps"
80
- description: "Des taches qui prennent des heures se feraient en quelques minutes"
81
- - label: "Decisions plus rapides"
82
- description: "Les informations seraient disponibles immediatement pour decider"
83
- - label: "Moins d'erreurs"
84
- description: "Les controles automatiques empecheraient les erreurs courantes"
85
- - label: "Meilleure collaboration"
86
- description: "Tout le monde verrait les memes informations a jour en temps reel"
87
- ```
88
-
89
- ---
90
-
91
- ## 1.4 Le declencheur et l'urgence
92
-
93
- > **But :** Comprendre pourquoi MAINTENANT et calibrer les attentes.
94
-
95
- | # | Question | Type de reponse |
96
- |---|----------|-----------------|
97
- | Q1.11 | Qu'est-ce qui a declenche cette demande ? Pourquoi maintenant et pas il y a 6 mois ? | Evenement declencheur |
98
- | Q1.12 | Que se passerait-il si ce projet n'etait PAS realise ? Quelles consequences a court et moyen terme ? | Impact de l'inaction |
99
-
100
- **Reformulation guidee pour Q1.11 :**
101
- ```
102
- question: "Qu'est-ce qui a declenche cette demande maintenant ?"
103
- header: "Declencheur"
104
- options:
105
- - label: "Croissance de l'activite"
106
- description: "Le volume de travail a augmente et les outils actuels ne suivent plus"
107
- - label: "Obligation reglementaire"
108
- description: "Une nouvelle regle ou loi impose de changer la facon de travailler"
109
- - label: "Probleme critique"
110
- description: "Un incident recent a mis en lumiere un dysfonctionnement grave"
111
- - label: "Opportunite strategique"
112
- description: "Un changement d'organisation ou de strategie ouvre une fenetre d'action"
113
- ```
114
-
115
- ---
116
-
117
- ## Guide d'elicitation approfondi
118
-
119
- ### Techniques de relance par question
120
-
121
- | Question | Si la reponse est vague ou insuffisante | Relance recommandee |
122
- |----------|----------------------------------------|---------------------|
123
- | Q1.1 (probleme) | Le client decrit une solution au lieu d'un probleme | "Oublions la solution un instant. Fermez les yeux et pensez a un moment recent ou ce probleme vous a frustre. Racontez-moi cette situation." |
124
- | Q1.2 (qui souffre) | Reponse generique "tout le monde" | "Prenons une personne precise, celle qui est la plus impactee. Quel est son poste ? Que fait-elle quand elle est bloquee par ce probleme ?" |
125
- | Q1.4 (outils actuels) | "On se debrouille" sans details | "Prenons un exemple concret : la derniere fois que ce probleme s'est presente, qu'avez-vous fait exactement, etape par etape ?" |
126
- | Q1.5 (processus actuel) | Moins de 3 etapes decrites | "Reprenons depuis le debut : quelqu'un a besoin de faire cette tache. Qu'est-ce qu'il fait en premier ? Puis ensuite ? Qui d'autre intervient ? Quand considere-t-on que c'est termine ?" |
127
- | Q1.6 (etapes penibles) | "Tout va bien sauf..." (minimisation) | "Si je chronometrais chaque etape de votre processus, laquelle prendrait le plus de temps ? Laquelle fait le plus soupirer vos equipes ?" |
128
- | Q1.7 (erreurs frequentes) | "Ca arrive rarement" | "La derniere fois qu'une erreur s'est produite, quel a ete l'impact ? Combien de temps pour la corriger ? Qui a du intervenir ?" |
129
- | Q1.8 (vision) | Reponse vague "ca irait mieux" | "Concretement, imaginez que vous arrivez lundi matin et que tout fonctionne parfaitement. Quelle est la premiere chose que vous faites differemment de d'habitude ?" |
130
- | Q1.9 (resultats) | Pas de chiffres ni de mesures | "Aujourd'hui, combien de temps prend ce processus ? Combien d'erreurs par mois ? Si on divisait par deux, est-ce que ca suffirait ?" |
131
- | Q1.10 (critere succes) | "Que les utilisateurs soient contents" | "Imaginons que 3 mois apres le lancement, je vous demande si le projet est un succes. Que me montrez-vous concretement comme preuve ?" |
132
- | Q1.12 (consequences inaction) | "Ca continuera comme avant" | "Et si ca continue encore 1 an comme ca ? 2 ans ? Quels risques voyez-vous : perte de clients, surcharge des equipes, non-conformite ?" |
133
-
134
- ### Signaux d'alerte a detecter
135
-
136
- | Signal du client | Probleme sous-jacent | Action de l'analyste |
137
- |------------------|---------------------|----------------------|
138
- | "Il faudrait un bouton pour..." ou "On a besoin d'un ecran qui..." | **Le client decrit une solution, pas un besoin** | Reformuler : "Quel probleme ce bouton/ecran resoudrait-il ? Qu'est-ce qui est difficile aujourd'hui sans lui ?" |
139
- | "C'est evident" ou "Tout le monde le sait" | **Hypothese implicite non validee** | "Pouvez-vous me l'expliquer comme si c'etait ma premiere journee dans votre entreprise ? Je veux etre sur de bien comprendre." |
140
- | "On verra plus tard" ou "C'est pas prioritaire" | **Sujet potentiellement critique esquive** | "Je comprends. Pouvez-vous quand meme me donner un exemple pour que je le note ? On decidera ensemble de la priorite." |
141
- | Mots vagues : "optimiser", "ameliorer", "moderniser" | **Besoin non concretise** | "Quand vous dites 'optimiser', pouvez-vous me donner un exemple precis de ce qui serait different ?" |
142
- | "On fait comme le concurrent X" | **Besoin copie sans reflexion** | "Qu'est-ce qui fonctionne bien chez le concurrent X selon vous ? Et qu'est-ce qui ne vous conviendrait pas dans leur approche ?" |
143
- | Pas de reponse a Q1.12 (consequences inaction) | **Besoin possiblement artificiel** | Approfondir : si l'absence de solution n'a pas de consequence, le besoin est-il reel ? |
144
-
145
- ### Regles d'enchainement
146
-
147
- | Apres | Si la reponse indique... | Alors |
148
- |-------|-------------------------|-------|
149
- | Q1.1 | Le client decrit un besoin technique | Poser Q1.2 pour recentrer sur les personnes impactees |
150
- | Q1.4 | Aucun outil existant | Sauter Q1.7 (pas d'erreurs a corriger dans un processus inexistant) |
151
- | Q1.5 | Processus tres simple (< 3 etapes) | Reduire la profondeur sur Q1.6, accelerer vers la vision (Q1.8) |
152
- | Q1.9 | Resultats non mesurables | Revenir a Q1.10 et insister sur le critere de succes observable |
153
- | Q1.11 | Obligation reglementaire | Charger le questionnaire de securite (categorie 06) en priorite |
154
- | Q1.12 | Consequences graves | Marquer le projet comme priorite haute, insister sur les risques dans le cadrage |
29
+ | Q1.8 | Qu'est-ce qui doit changer ? Si le probleme etait resolu demain, que feriez-vous differemment dans votre journee de travail ? | Description du changement concret |
155
30
 
156
31
  ---
157
32
 
@@ -159,27 +34,6 @@ options:
159
34
 
160
35
  | Reponse | Alimente |
161
36
  |---------|----------|
162
- | Q1.1, Q1.2, Q1.3 | `cadrage.problem` |
163
- | Q1.4, Q1.5, Q1.6, Q1.7 | `cadrage.asIs` |
164
- | Q1.8, Q1.9, Q1.10 | `cadrage.toBe` + `cadrage.acceptanceCriteria` |
165
- | Q1.11, Q1.12 | `cadrage.trigger` + `cadrage.risks` |
166
-
167
- ---
168
-
169
- ## Strategie de questionnement
170
-
171
- ### Ordre des questions en 3 lots
172
-
173
- **Lot 1 (Q1.1, Q1.2, Q1.3, Q1.4) : Comprendre le probleme**
174
- - Commencer par le probleme et les personnes impactees
175
- - Poser ensuite la question des outils actuels pour ancrer dans le concret
176
-
177
- **Lot 2 (Q1.5, Q1.6, Q1.7) : Cartographier le processus actuel**
178
- - Detailler les etapes du processus existant
179
- - Identifier les points de friction et les erreurs recurrentes
180
- - Ce lot peut etre raccourci si le processus est simple
181
-
182
- **Lot 3 (Q1.8, Q1.9, Q1.10, Q1.11, Q1.12) : Definir la vision et l'urgence**
183
- - Projeter le client dans l'avenir : que changerait une solution ?
184
- - Quantifier les attentes : resultats mesurables
185
- - Comprendre le declencheur et les consequences de l'inaction
37
+ | Q1.1 | `cadrage.problem` |
38
+ | Q1.4 | `cadrage.asIs` |
39
+ | Q1.8 | `cadrage.toBe` |
@@ -1,40 +1,34 @@
1
1
  # Categorie 2 : Parties prenantes et perimetre
2
2
 
3
- > **Usage :** Identifier les acteurs, leurs besoins, et delimiter le perimetre fonctionnel
3
+ > **Usage :** Identifier les profils utilisateurs, leurs droits, et delimiter le perimetre fonctionnel
4
4
  > **Quand charger :** TOUJOURS (noyau)
5
- > **Objectif :** Comprendre QUI utilise le systeme, COMMENT, et QUOI il doit faire
5
+ > **Objectif :** Comprendre QUI utilise le systeme, avec quels DROITS, et QUOI il doit faire
6
6
 
7
7
  ---
8
8
 
9
9
  ## 2.1 Identification des utilisateurs
10
10
 
11
- > **But :** Dresser la carte complete de toutes les personnes qui interagiront avec le systeme.
11
+ > **But :** Identifier les types de profils/roles qui interagiront avec le systeme.
12
12
 
13
13
  | # | Question | Type de reponse |
14
14
  |---|----------|-----------------|
15
- | Q2.1 | Qui sont les personnes qui utiliseront ce systeme au quotidien ? Decrivez leurs postes et ce qu'ils font dans l'entreprise. | Liste de profils utilisateurs |
16
- | Q2.2 | Y a-t-il des personnes qui ne l'utiliseront pas directement mais qui beneficieront des resultats (rapports, donnees, decisions) ? | Liste de beneficiaires indirects |
17
- | Q2.3 | Qui est le decideur final sur ce projet ? Qui peut dire "oui, on lance" ou "non, on arrete" ? | Nom et role du decideur |
18
- | Q2.4 | Y a-t-il des personnes ou des services qui pourraient s'opposer a ce projet ou le freiner ? Pourquoi ? | Liste de resistances potentielles |
15
+ | Q2.1 | Qui sont les types de profils qui utiliseront ce systeme ? Decrivez leurs roles et ce qu'ils font. | Liste de profils utilisateurs |
19
16
 
20
17
  ---
21
18
 
22
- ## 2.2 Le quotidien de chaque utilisateur
19
+ ## 2.2 Taches par profil
23
20
 
24
- > **But :** Comprendre concretement ce que chaque type d'utilisateur fait et a besoin de faire.
21
+ > **But :** Comprendre concretement ce que chaque type d'utilisateur fait.
25
22
 
26
23
  | # | Question | Type de reponse |
27
24
  |---|----------|-----------------|
28
25
  | Q2.5 | Pour chaque type d'utilisateur : quelles sont les 3 a 5 taches principales qu'il doit accomplir avec ce systeme ? | Taches par profil utilisateur |
29
- | Q2.6 | A quelle frequence chaque utilisateur se servira-t-il du systeme ? Tous les jours ? Plusieurs fois par jour ? Une fois par semaine ? | Frequence d'utilisation par profil |
30
- | Q2.7 | Quel est le niveau de confort de chaque utilisateur avec les outils informatiques ? | Niveau d'aisance par profil |
31
- | Q2.8 | Pour chaque utilisateur : quelles sont ses 2 a 3 plus grandes frustrations avec la facon de travailler actuelle ? | Frustrations par profil |
32
26
 
33
27
  ---
34
28
 
35
29
  ## 2.3 Les niveaux d'acces
36
30
 
37
- > **But :** Definir qui peut voir quoi et faire quoi, en langage simple.
31
+ > **But :** Definir qui peut voir quoi et faire quoi.
38
32
 
39
33
  | # | Question | Type de reponse |
40
34
  |---|----------|-----------------|
@@ -52,7 +46,6 @@
52
46
  |---|----------|-----------------|
53
47
  | Q2.12 | Listez toutes les fonctionnalites que vous souhaitez dans ce systeme. Ne vous censurez pas. | Liste libre de fonctionnalites |
54
48
  | Q2.13 | Parmi cette liste, quelles sont les fonctionnalites INDISPENSABLES ? Celles sans lesquelles le systeme n'a aucun interet ? | Liste de fonctionnalites vitales |
55
- | Q2.14 | Quelles fonctionnalites seraient tres utiles mais pourraient attendre une deuxieme version ? | Liste de fonctionnalites importantes |
56
49
  | Q2.15 | Y a-t-il des choses que le systeme ne doit explicitement PAS faire ? Des limites claires a poser ? | Liste d'exclusions |
57
50
 
58
51
  **Test de priorite :**
@@ -73,19 +66,6 @@
73
66
 
74
67
  ---
75
68
 
76
- ## 2.6 Besoins transversaux
77
-
78
- > **But :** Identifier les fonctionnalites qui traversent tout le systeme.
79
-
80
- | # | Question | Type de reponse |
81
- |---|----------|-----------------|
82
- | Q2.19 | Les utilisateurs ont-ils besoin de recevoir des notifications ou des alertes ? Si oui, dans quelles situations ? | Liste de situations de notification |
83
- | Q2.20 | Faut-il pouvoir exporter des donnees du systeme (rapports, fichiers, impressions) ? Dans quel format et pour qui ? | Besoins d'export |
84
- | Q2.21 | Faut-il pouvoir importer des donnees dans le systeme depuis une source externe ? | Besoins d'import |
85
- | Q2.22 | Faut-il garder un historique de qui a fait quoi et quand ? Pour quelles actions ? | Besoins de tracabilite |
86
-
87
- ---
88
-
89
69
  ## Guide d'elicitation approfondi
90
70
 
91
71
  ### Techniques de relance
@@ -93,7 +73,6 @@
93
73
  | Question | Si la reponse est vague | Relance recommandee |
94
74
  |----------|------------------------|---------------------|
95
75
  | Q2.1 (utilisateurs) | Un seul type mentionne | "Pensez aux differents moments de la journee : qui saisit ? Qui consulte les rapports ? Qui gere les cas particuliers ?" |
96
- | Q2.4 (oppositions) | "Personne ne s'opposera" | "Quand un nouvel outil est introduit, qui doit changer ses habitudes le plus ?" |
97
76
  | Q2.5 (taches) | Taches generiques | "Quand il arrive le matin et ouvre le systeme, quelle est sa premiere action ?" |
98
77
  | Q2.9 (visibilite) | Reponse ambigue | "Un employe du service A peut-il voir les donnees du service B ? Un stagiaire voit-il la meme chose qu'un directeur ?" |
99
78
  | Q2.13 (indispensable) | Tout est indispensable | "Si vous ne pouviez garder que 3 fonctionnalites pour un premier lancement, lesquelles ?" |
@@ -116,27 +95,7 @@
116
95
 
117
96
  | Reponse | Alimente |
118
97
  |---------|----------|
119
- | Q2.1-Q2.4 | `cadrage.stakeholders[]` |
120
- | Q2.5-Q2.8 | `cadrage.stakeholders[].tasks`, `.frequency`, `.painPoints` |
98
+ | Q2.1, Q2.5 | `cadrage.stakeholders[]` |
121
99
  | Q2.9-Q2.11 | `cadrage.applicationRoles[]` |
122
- | Q2.12-Q2.15 | `cadrage.globalScope` (vital, important, optional, excluded) |
100
+ | Q2.12-Q2.13, Q2.15 | `cadrage.globalScope` (vital, important, excluded) |
123
101
  | Q2.16-Q2.18 | `cadrage.coverageMatrix` + base pour les cas d'utilisation |
124
- | Q2.19-Q2.22 | `cadrage.coverageMatrix` + detection de modules transversaux |
125
-
126
- ---
127
-
128
- ## Strategie de questionnement
129
-
130
- ### Ordre des questions en 4 lots
131
-
132
- **Lot 1 (Q2.1-Q2.4) : Qui est concerne ?**
133
- - Identifier tous les acteurs du projet
134
-
135
- **Lot 2 (Q2.5-Q2.11) : Que font-ils et quels droits ?**
136
- - Detailler les taches, frequences et niveaux d'acces par profil
137
-
138
- **Lot 3 (Q2.12-Q2.15) : Quel perimetre ?**
139
- - Lister et hierarchiser les fonctionnalites
140
-
141
- **Lot 4 (Q2.16-Q2.22) : Comment ca se deroule ?**
142
- - Cartographier le parcours principal et les besoins transversaux
@@ -13,7 +13,6 @@
13
13
  | Q3.1 | Quelles sont les entites principales gerees par ce module ? | Liste d'entites |
14
14
  | Q3.2 | Pour chaque entite : quels sont les attributs importants ? | Par entite |
15
15
  | Q3.3 | Quelles relations existent entre les entites ? (appartient a, contient, reference) | Schema relationnel |
16
- | Q3.4 | Volume de donnees attendu ? (dizaines, centaines, milliers, millions) | Estimation par entite |
17
16
  | Q3.5 | Pour chaque entite : le Code doit-il etre auto-genere ou saisi par l'utilisateur ? | Par entite |
18
17
  | Q3.6 | Si auto-genere : quelle strategie ? (sequentiel, timestamp, annee, UUID court) | Par entite |
19
18
 
@@ -56,7 +55,6 @@
56
55
  | Q3.1 (entites) | Mention de "User" | "L'utilisateur est gere par la plateforme. Decrivez l'entite METIER (Client, Employee, Contact...)" |
57
56
  | Q3.2 (attributs) | Champs techniques (ID, CreatedDate) | "Les champs techniques sont auto-geres. Quels sont les attributs METIER ?" |
58
57
  | Q3.3 (relations) | "1:N" sans detail | "Un {Parent} peut avoir combien de {Children} max ? Un {Child} peut-il exister sans {Parent} ?" |
59
- | Q3.4 (volume) | "Beaucoup" | "Ordre de grandeur : dizaines, centaines, milliers, millions ? Croissance par mois ?" |
60
58
  | Q3.11 (ecrans) | "Un ecran de liste" | "Avec pages dediees pour creation et edition ? Detail en page avec onglets ?" |
61
59
  | Q3.13 (actions) | "CRUD classique" | "Actions metier specifiques ? (valider, dupliquer, archiver, changer statut, assigner)" |
62
60
  | Q3.14 (dashboards) | "Juste des chiffres" | "Les tendances ne seraient-elles pas plus lisibles en graphique ?" |
@@ -88,7 +86,7 @@
88
86
 
89
87
  | Reponse | Alimente |
90
88
  |---------|----------|
91
- | Q3.1-Q3.6 | `entities.json` (entites, attributs, relations, codePattern) |
89
+ | Q3.1-Q3.3, Q3.5-Q3.6 | `entities.json` (entites, attributs, relations, codePattern) |
92
90
  | Q3.7-Q3.9 | `rules.json` (regles metier de validation et securite) |
93
91
  | Q3.10-Q3.13 | `screens.json` (sections, resources, colonnes, actions) |
94
92
  | Q3.14-Q3.16 | `screens.json` (sections dashboard, KPI resources) |
@@ -1,150 +1,6 @@
1
1
  # Categorie 4 : Risques et criteres de reussite
2
2
 
3
- > **Usage :** Identifier les risques et definir comment mesurer le succes
4
- > **Quand charger :** TOUJOURS (noyau, charge dans le cadrage)
5
- > **Objectif :** Anticiper les problemes et etablir des criteres observables
6
-
7
- ---
8
-
9
- ## 4.1 Les risques identifies
10
-
11
- > **But :** Lister tout ce qui pourrait empecher le projet de reussir.
12
-
13
- | # | Question | Type de reponse |
14
- |---|----------|-----------------|
15
- | Q4.1 | Quels sont les principaux risques que vous voyez pour ce projet ? Qu'est-ce qui pourrait mal tourner ? | Liste de risques |
16
- | Q4.2 | Parmi ces risques, lesquels auraient les consequences les plus graves ? | Hierarchisation par gravite |
17
- | Q4.3 | Pour chaque risque grave : avez-vous une idee de comment le prevenir ou le reduire ? | Mesures de mitigation |
18
-
19
- **Reformulation guidee pour Q4.1 :**
20
- ```
21
- question: "Quels sont les principaux risques que vous voyez pour ce projet ?"
22
- header: "Risques"
23
- multiSelect: true
24
- options:
25
- - label: "Adoption par les utilisateurs"
26
- description: "Les utilisateurs pourraient ne pas vouloir changer leurs habitudes"
27
- - label: "Qualite des donnees existantes"
28
- description: "Les donnees actuelles sont incompletes, incorrectes ou dispersees"
29
- - label: "Complexite des regles metier"
30
- description: "Certaines regles sont mal documentees ou connues uniquement par quelques personnes"
31
- - label: "Dependances externes"
32
- description: "Le projet depend de systemes ou decisions externes qui pourraient retarder"
33
- ```
34
-
35
- ---
36
-
37
- ## 4.2 Les hypotheses a valider
38
-
39
- > **But :** Rendre explicites les certitudes non verifiees.
40
-
41
- | # | Question | Type de reponse |
42
- |---|----------|-----------------|
43
- | Q4.4 | Quelles hypotheses faites-vous sur le projet ? Qu'est-ce que vous tenez pour acquis sans l'avoir verifie ? | Liste d'hypotheses |
44
- | Q4.5 | Parmi ces hypotheses, lesquelles seraient les plus graves si elles se revelaient fausses ? | Hierarchisation par impact |
45
- | Q4.6 | Comment pourriez-vous verifier ces hypotheses avant que le projet avance trop loin ? | Methodes de validation |
46
-
47
- ---
48
-
49
- ## 4.3 Les lecons du passe
50
-
51
- | # | Question | Type de reponse |
52
- |---|----------|-----------------|
53
- | Q4.7 | Y a-t-il eu des projets similaires dans l'entreprise ? Qu'est-ce qui a fonctionne ou echoue ? | Retour d'experience |
54
- | Q4.8 | Si ce projet devait echouer, quelle serait la raison la plus probable ? | Cause d'echec anticipee |
55
-
56
- ---
57
-
58
- ## 4.4 La definition du succes
59
-
60
- > **But :** Determiner concretement ce qui fera dire "ce projet est un succes".
61
-
62
- | # | Question | Type de reponse |
63
- |---|----------|-----------------|
64
- | Q4.9 | Quand le systeme sera en place, comment saurez-vous que le projet est un succes ? Quel changement concret observerez-vous ? | Description du succes observable |
65
- | Q4.10 | Si vous deviez convaincre votre direction que le projet a reussi, quels chiffres presenteriez-vous ? | Metriques de succes |
66
- | Q4.11 | Au bout de combien de temps apres le lancement pourrez-vous juger si ca fonctionne ? | Delai d'evaluation |
67
-
68
- **Reformulation guidee pour Q4.9 :**
69
- ```
70
- question: "Comment saurez-vous que le projet est un succes ?"
71
- header: "Succes"
72
- options:
73
- - label: "Gain de temps mesurable"
74
- description: "Un processus qui prenait X heures ne prend plus que Y minutes"
75
- - label: "Reduction des erreurs"
76
- description: "Le nombre d'erreurs a diminue de maniere significative"
77
- - label: "Meilleure satisfaction"
78
- description: "Les utilisateurs expriment que leur quotidien s'est ameliore"
79
- - label: "Indicateurs en hausse"
80
- description: "Des chiffres cles se sont ameliores"
81
- ```
82
-
83
- ---
84
-
85
- ## 4.5 Les objectifs mesurables
86
-
87
- | # | Question | Type de reponse |
88
- |---|----------|-----------------|
89
- | Q4.12 | Pour chaque amelioration attendue, pouvez-vous donner un objectif chiffre ? | Objectifs quantifies |
90
- | Q4.13 | Quels indicateurs suivez-vous deja aujourd'hui qui pourraient servir de reference ? | Indicateurs existants |
91
-
92
- ---
93
-
94
- ## 4.6 Les criteres d'acceptation
95
-
96
- | # | Question | Type de reponse |
97
- |---|----------|-----------------|
98
- | Q4.14 | Quelles sont les conditions minimales pour que vous acceptiez de mettre le systeme en service ? | Liste de conditions obligatoires |
99
- | Q4.15 | Qui decide officiellement que le systeme est pret a etre utilise ? | Processus de validation |
100
-
101
- ---
102
-
103
- ## Guide d'elicitation approfondi
104
-
105
- ### Techniques de relance
106
-
107
- | Question | Si la reponse est vague | Relance recommandee |
108
- |----------|------------------------|---------------------|
109
- | Q4.1 (risques) | "Je ne vois pas de risque" | "Pensez aux projets passes : qu'est-ce qui a coince ? Les delais ? L'adoption ? La qualite des donnees ?" |
110
- | Q4.4 (hypotheses) | "On ne fait pas d'hypotheses" | "Est-on certain que tous les utilisateurs ont un ordinateur ? Que les donnees actuelles sont completes ?" |
111
- | Q4.8 (echec) | Refuse de repondre | "C'est une question difficile mais importante. Imaginons le pire scenario : cela nous aide a le prevenir." |
112
- | Q4.9 (succes) | "Que tout fonctionne bien" | "Imaginons que je visite votre bureau 3 mois apres le lancement. Qu'est-ce que je verrais de different ?" |
113
- | Q4.12 (objectifs) | "Difficile a chiffrer" | "Meme approximativement : le processus prend combien de temps aujourd'hui ? Quel serait un temps acceptable ?" |
114
- | Q4.14 (conditions) | "Il faut que tout soit parfait" | "Si vous deviez lancer avec seulement 80% des fonctionnalites, lesquelles seraient dans ces 80% ?" |
115
-
116
- ### Signaux d'alerte
117
-
118
- | Signal du client | Probleme sous-jacent | Action |
119
- |------------------|---------------------|--------|
120
- | "Il n'y a aucun risque" | Manque de recul | Proposer des risques standards |
121
- | Risques uniquement techniques | Vision incomplete | Ajouter dimensions humaines et organisationnelles |
122
- | Aucun critere mesurable | Succes non defini | Proposer metriques standards : temps, erreurs, adoption, satisfaction |
123
- | "Ca doit etre parfait" | Attentes irrealistes | "Quel est le niveau minimum acceptable pour un premier lancement ?" |
124
-
125
- ---
126
-
127
- ## Mapping vers le cadrage
128
-
129
- | Reponse | Alimente |
130
- |---------|----------|
131
- | Q4.1-Q4.3 | `cadrage.risks[]` |
132
- | Q4.4-Q4.6 | `cadrage.risks[]` (type: "assumption") |
133
- | Q4.7-Q4.8 | `cadrage.risks[]` (enrichissement contexte historique) |
134
- | Q4.9-Q4.13 | `cadrage.acceptanceCriteria[]` |
135
- | Q4.14-Q4.15 | `cadrage.acceptanceCriteria[]` (conditions de livraison) |
136
-
137
- ---
138
-
139
- ## Strategie de questionnement
140
-
141
- ### Ordre en 3 lots
142
-
143
- **Lot 1 (Q4.1-Q4.6) : Risques et hypotheses**
144
- - Commencer par les risques visibles puis les hypotheses implicites
145
-
146
- **Lot 2 (Q4.7-Q4.8) : Lecons du passe**
147
- - Tirer les lecons des experiences precedentes
148
-
149
- **Lot 3 (Q4.9-Q4.15) : Succes et acceptation**
150
- - Definir le succes, quantifier, etablir les conditions de livraison
3
+ > **NOT USED** Les risques projet, hypotheses, lecons du passe, metriques de succes et conditions de livraison
4
+ > ne sont pas du scope de la BA en vibe coding.
5
+ >
6
+ > La documentation technique est generee automatiquement par `/documentation` apres `/ralph-loop`.
@@ -2,7 +2,7 @@
2
2
 
3
3
  > **Usage :** Analyser l'impact sur les modules existants et les dependances partagees
4
4
  > **Quand charger :** TOUJOURS pour les nouveaux modules (pas les ameliorations)
5
- > **Objectif :** Detecter les interactions, les entites partagees et les risques de conflit
5
+ > **Objectif :** Detecter les interactions, les entites partagees et les impacts d'integration
6
6
 
7
7
  ---
8
8
 
@@ -21,8 +21,8 @@
21
21
  |---|----------|-----------------|
22
22
  | Q5.5 | Les modules existants doivent-ils etre modifies pour supporter ce nouveau module ? | Liste de changements |
23
23
  | Q5.6 | Y a-t-il des composants UI ou des changements de navigation partages ? | Liste |
24
- | Q5.7 | Ce module affectera-t-il les permissions ou roles existants ? | Oui/Non + detail |
25
- | Q5.8 | Y a-t-il un risque de conflit de modele de donnees ? (meme entite modifiee par 2 modules) | Evaluation du risque |
24
+ | Q5.7 | Ce module affectera-t-il les permissions ou roles existants ? Quel impact sur l'integration ? | Oui/Non + detail |
25
+ | Q5.8 | Y a-t-il des entites partagees modifiees par plusieurs modules ? Quel impact sur l'integration ? | Evaluation de l'impact |
26
26
 
27
27
  ---
28
28
 
@@ -49,7 +49,7 @@
49
49
  | Q5.2 (donnees partagees) | "Je ne sais pas" | Utiliser le `{codebase_context}` : "J'ai trouve les entites {list}. Ce module a-t-il besoin de les referencer ?" |
50
50
  | Q5.3 (FK references) | Vague | "Une {entity} de ce module appartient-elle a un {existing_entity} ?" |
51
51
  | Q5.4 (evenements) | "Non" | "Quand un {entity} est cree/modifie/supprime, faut-il notifier un autre module ?" |
52
- | Q5.8 (conflits) | "Pas de risque" | "Deux modules modifient-ils la meme entite ?" |
52
+ | Q5.8 (impact) | "Pas d'impact" | "Deux modules modifient-ils la meme entite ? Quel est l'impact sur l'integration ?" |
53
53
 
54
54
  ### Anti-patterns a detecter
55
55
 
@@ -66,4 +66,4 @@
66
66
  | Reponse | Alimente |
67
67
  |---------|----------|
68
68
  | Q5.1-Q5.4 | `consolidation.crossModuleInteractions[]`, `consolidation.sharedEntities[]` |
69
- | Q5.5-Q5.8 | `consolidation.globalRiskAssessment[]`, `consolidation.permissionCoherence` |
69
+ | Q5.5-Q5.8 | `consolidation.impactAssessment[]`, `consolidation.permissionCoherence` |
@@ -3,7 +3,7 @@
3
3
  > **Usage:** Structured questions for step-01-cadrage and step-03-specify
4
4
  > **Standard:** BABOK v3 - Elicitation Techniques (Interactive analysis)
5
5
  > **Model:** OPUS with ULTRATHINK
6
- > **Total:** ~90 targeted questions across 5 questionnaire files
6
+ > **Total:** ~20 targeted questions across 4 active questionnaire files
7
7
 
8
8
  ---
9
9
 
@@ -34,11 +34,11 @@
34
34
 
35
35
  | File | Questions | Phase | Focus |
36
36
  |------|-----------|-------|-------|
37
- | `questionnaire/01-context.md` | ~20 | step-01-cadrage | Problem, current state, vision, triggers, application identity |
38
- | `questionnaire/02-stakeholders-scope.md` | ~25 | step-01-cadrage | User profiles, priorities, scope boundaries, MoSCoW |
39
- | `questionnaire/03-data-ui.md` | ~20 | step-03-specify (per module) | Data entities, UI expectations, integrations |
40
- | `questionnaire/04-risks-metrics.md` | ~15 | step-01-cadrage | Risks, success criteria, constraints, performance |
41
- | `questionnaire/05-cross-module.md` | ~10 | step-03-specify (conditional) | Cross-module dependencies, shared data, E2E flows |
37
+ | `questionnaire/01-context.md` | 3 | step-01-cadrage | Business process, friction points, vision |
38
+ | `questionnaire/02-stakeholders-scope.md` | 10 | step-01-cadrage | User profiles, access levels, scope boundaries, MoSCoW |
39
+ | `questionnaire/03-data-ui.md` | ~15 | step-03-specify (per module) | Data entities, UI expectations, dashboards |
40
+ | `questionnaire/04-risks-metrics.md` | | NOT USED | Risks/metrics out of BA scope |
41
+ | `questionnaire/05-cross-module.md` | ~8 | step-03-specify (conditional) | Cross-module dependencies, integration impact |
42
42
 
43
43
  ---
44
44
 
@@ -48,7 +48,7 @@
48
48
 
49
49
  | Phase | Questionnaires charges |
50
50
  |-------|----------------------|
51
- | step-01-cadrage | 01-context, 02-stakeholders-scope, 04-risks-metrics |
51
+ | step-01-cadrage | 01-context, 02-stakeholders-scope |
52
52
  | step-03-specify (par module) | 03-data-ui, conditionnellement 05-cross-module |
53
53
 
54
54
  ### Phase de cadrage (step-01)
@@ -58,7 +58,6 @@
58
58
  3. **Approfondir :** Poser des questions de relance sur les reponses vagues
59
59
  4. **Challenger :** Ne pas accepter "on verra plus tard" sur les fonctionnalites indispensables
60
60
  5. **Par lots :** Presenter 3 a 4 questions par interaction (AskUserQuestion)
61
- 6. **Risques et succes :** Charger 04-risks-metrics en fin de cadrage
62
61
 
63
62
  ### Phase de specification (step-03)
64
63
 
@@ -209,13 +209,11 @@ options:
209
209
  #### 4a. Business Context (ALWAYS — from `questionnaire/01-context.md`)
210
210
 
211
211
  > Load the full questionnaire reference for elicitation guides and alert signals.
212
+ > The questionnaire contains 3 targeted questions: Q1.1 (business process), Q1.4 (friction points), Q1.8 (vision).
212
213
 
213
- Select the most relevant questions from Q1.1-Q1.12.
214
- **Mandatory minimum:** Q1.1 (problem), Q1.4 (current tools), Q1.8 (vision), Q1.11 (trigger).
214
+ Ask all 3 questions in 1 batch via AskUserQuestion.
215
215
 
216
- Ask in 1-2 batches via AskUserQuestion (max 4 questions per batch).
217
-
218
- Apply ULTRATHINK after each batch:
216
+ Apply ULTRATHINK after the batch:
219
217
  - If answer is vague → probe deeper using the elicitation guide from 01-context.md
220
218
  - If answer is solution-oriented → apply Technique 1 (reformulate as need)
221
219
  - If answer is superficial → apply Technique 2 (chain of whys)
@@ -223,7 +221,9 @@ Apply ULTRATHINK after each batch:
223
221
 
224
222
  #### 4b. Stakeholders (ALWAYS — from `questionnaire/02-stakeholders-scope.md`)
225
223
 
226
- **Mandatory minimum:** Q2.1 (users), Q2.5 (tasks per profile), Q2.9 (access levels).
224
+ > The questionnaire contains 10 targeted questions covering profiles, tasks, access levels, scope, and user journey.
225
+
226
+ **Mandatory minimum:** Q2.1 (users), Q2.5 (tasks per profile), Q2.9-Q2.11 (access levels).
227
227
 
228
228
  Ask in 1-2 batches. After each batch:
229
229
  - If only 1 user type mentioned → probe: "Who else interacts? Managers? Admins? External users?"
@@ -232,7 +232,7 @@ Ask in 1-2 batches. After each batch:
232
232
 
233
233
  #### 4c. Functional Scope (ALWAYS — from `questionnaire/02-stakeholders-scope.md`)
234
234
 
235
- **Mandatory minimum:** Q3.2 (must-have), Q3.4 (exclusions), Q3.5 (main journey).
235
+ **Mandatory minimum:** Q2.13 (must-have), Q2.15 (exclusions), Q2.16 (main journey).
236
236
 
237
237
  Ask in 1-2 batches. After each batch:
238
238
  - If everything is "must-have" → **BLOCKING**: apply MoSCoW prioritization question
@@ -441,15 +441,7 @@ options:
441
441
 
442
442
  > **CRITICAL:** The intelligence of this step is in the ULTRATHINK analysis. The AI must REASON about domain coherence, score the entity, and recommend — not just present 4 neutral options. The client can always override the recommendation, but they should benefit from expert architectural guidance.
443
443
 
444
- #### 4e. Risks & Success Criteria (ALWAYS — from `questionnaire/04-risks-metrics.md`)
445
-
446
- Select the most pertinent questions:
447
- - **04-risks-metrics.md:** Risk identification, assumptions validation
448
- - **04-risks-metrics.md:** Success definition, measurable objectives
449
-
450
- Ask in 1 batch via AskUserQuestion.
451
-
452
- #### 4f. Conditional Deep-Dives
444
+ #### 4e. Conditional Deep-Dives
453
445
 
454
446
  Based on brief analysis, load additional materials if relevant:
455
447
 
@@ -460,33 +452,6 @@ Based on brief analysis, load additional materials if relevant:
460
452
  | Performance requirements | Additional probing on non-functional needs |
461
453
  | Technical constraints | Additional probing on platform constraints |
462
454
 
463
- #### 4g. Documentation Needs (ALWAYS — from `questionnaire/03-data-ui.md`)
464
-
465
- > **Every application requires documentation decisions made upfront, not as an afterthought.**
466
- > Load relevant documentation section from questionnaire/03-data-ui.md
467
-
468
- Ask in 1 batch via AskUserQuestion (max 3 questions):
469
- - Will users need documentation (guide, FAQ, in-app tooltips)?
470
- - Is technical documentation required (API docs, ERD, developer guide)?
471
- - Who is responsible for maintaining documentation after delivery?
472
-
473
- After the batch:
474
- - If "Non" to both → probe: "Pas même les docs API ou un guide d'accueil pour les nouveaux utilisateurs ?"
475
- - If "Oui" without detail → ask format: "Tooltips intégrés ? Guide PDF ? Wiki ? Portail dédié ?"
476
- - If "La doc se fera après" → challenge: "La documentation est planifiée maintenant et générée par `/documentation` après `/ralph-loop`. Quel niveau souhaitez-vous ?"
477
-
478
- **Store in `cadrage.documentation`:**
479
- ```json
480
- {
481
- "userDocumentation": { "needed": true, "format": "tooltips|guide|wiki|pdf|portal", "audience": "..." },
482
- "technicalDocumentation": { "needed": true, "format": "swagger|erd|developer-guide", "generated": true },
483
- "owner": "who maintains it",
484
- "skill": "/documentation — runs after /ralph-loop"
485
- }
486
- ```
487
-
488
- This feeds directly into handoff step-05 category `documentation` in `filesToCreate`.
489
-
490
455
  ---
491
456
 
492
457
  ## PHASE 4: ANTICIPATION (Suggest Unexpressed Needs)
@@ -677,20 +642,16 @@ ba-writer.enrichSection({
677
642
  problem: {from Phase 3, section 4a — Q1.1 answer or refined problem},
678
643
  asIs: {from Phase 3, section 4a — Q1.4 answer},
679
644
  toBe: {from Phase 3, section 4a — Q1.8 answer},
680
- trigger: {from Phase 3, section 4a — Q1.11 answer},
681
645
  stakeholders: [{from Phase 3, section 4b}],
682
646
  globalScope: {
683
647
  mustHave: [{from Phase 3, section 4c + Phase 4 accepted suggestions}],
684
648
  shouldHave: [{from coverage matrix}],
685
649
  couldHave: [{from coverage matrix}],
686
- outOfScope: [{from Phase 3, section 4c — Q3.4 exclusions}]
650
+ outOfScope: [{from Phase 3, section 4c — Q2.15 exclusions}]
687
651
  },
688
652
  applicationRoles: [{from Phase 5, section 6}],
689
653
  errorFlows: [{from Phase 3, section 4c}],
690
- risks: [{from Phase 3, section 4e}],
691
- acceptanceCriteria: [{from Phase 3, section 4e}],
692
654
  coverageMatrix: [{from Phase 5, section 7 — with anticipatedSections and anticipatedResources}],
693
- documentation: {from Phase 3, section 4g},
694
655
  codebaseContext: "{string summary of codebase findings}"
695
656
  }
696
657
  })
@@ -708,7 +669,6 @@ ba-writer.updateStatus({feature_id}, "framed")
708
669
  | Stakeholders | {count} |
709
670
  | Must-have scope items | {count} |
710
671
  | Application roles | {count} |
711
- | Risks identified | {count} |
712
672
  | Suggestions accepted | {count} |
713
673
  | Anticipated sections | {total across all modules} |
714
674
 
@@ -22,10 +22,17 @@ Works in synergy with the `/documentation module` command.
22
22
  <quick_start>
23
23
  ## WHEN THIS SKILL ACTIVATES
24
24
 
25
+ ### PREREQUISITE — ONLY post-implementation
26
+ This skill requires the feature page to already exist (generated by /ralph-loop).
27
+ It reads real TSX pages, controllers, and entities. Without them, nothing to document.
28
+
29
+ → For reviewing/editing the analysis BEFORE implementation: use ba-interactive.html (/business-analyse step-05)
30
+
25
31
  Claude automatically invokes this skill when it detects:
26
32
 
27
33
  | Trigger | Example |
28
34
  |---------|---------|
35
+ | ❌ NEVER during BA | Before /ralph-loop — feature page does not exist yet |
29
36
  | Explicit request | "Document the SLA module" |
30
37
  | Documentation mention | "We should create the doc for..." |
31
38
  | After implementation | "The feature is done, generate the doc" |