@atlashub/smartstack-cli 4.19.0 → 4.21.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.
Files changed (73) hide show
  1. package/package.json +2 -2
  2. package/templates/skills/ba-generate-html/SKILL.md +60 -0
  3. package/templates/skills/{business-analyse → ba-generate-html}/html/ba-interactive.html +3 -3
  4. package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/cadrage-risks.html +1 -1
  5. package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/02-navigation.js +1 -1
  6. package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/07-render-handoff.js +1 -1
  7. package/templates/skills/{business-analyse → ba-generate-html}/html/src/template.html +1 -1
  8. package/templates/skills/{business-analyse/references/deploy-data-build.md → ba-generate-html/references/data-build.md} +2 -2
  9. package/templates/skills/{business-analyse/references/html-data-mapping.md → ba-generate-html/references/data-mapping.md} +2 -2
  10. package/templates/skills/{business-analyse/references/deploy-modes.md → ba-generate-html/references/output-modes.md} +1 -1
  11. package/templates/skills/ba-generate-html/steps/step-01-collect.md +113 -0
  12. package/templates/skills/ba-generate-html/steps/step-02-build-data.md +237 -0
  13. package/templates/skills/ba-generate-html/steps/step-03-render.md +75 -0
  14. package/templates/skills/ba-generate-html/steps/step-04-verify.md +83 -0
  15. package/templates/skills/ba-review/SKILL.md +45 -0
  16. package/templates/skills/{business-analyse → ba-review}/references/review-data-mapping.md +2 -2
  17. package/templates/skills/{business-analyse/steps/step-06-review.md → ba-review/steps/step-01-apply.md} +7 -18
  18. package/templates/skills/business-analyse/SKILL.md +24 -59
  19. package/templates/skills/business-analyse/_shared.md +9 -14
  20. package/templates/skills/business-analyse/questionnaire/01-context.md +11 -157
  21. package/templates/skills/business-analyse/questionnaire/02-stakeholders-scope.md +9 -50
  22. package/templates/skills/business-analyse/questionnaire/03-data-ui.md +1 -3
  23. package/templates/skills/business-analyse/questionnaire/04-risks-metrics.md +4 -148
  24. package/templates/skills/business-analyse/questionnaire/05-cross-module.md +5 -5
  25. package/templates/skills/business-analyse/questionnaire.md +7 -8
  26. package/templates/skills/business-analyse/react/components.md +1 -1
  27. package/templates/skills/business-analyse/react/schema.md +1 -1
  28. package/templates/skills/business-analyse/references/acceptance-criteria.md +2 -7
  29. package/templates/skills/business-analyse/references/detection-strategies.md +3 -3
  30. package/templates/skills/business-analyse/references/naming-conventions.md +2 -2
  31. package/templates/skills/business-analyse/references/robustness-checks.md +2 -121
  32. package/templates/skills/business-analyse/references/validation-checklist.md +3 -4
  33. package/templates/skills/business-analyse/schemas/feature-schema.json +1 -1
  34. package/templates/skills/business-analyse/steps/step-00-init.md +6 -9
  35. package/templates/skills/business-analyse/steps/step-01-cadrage.md +9 -49
  36. package/templates/skills/business-analyse/steps/step-04-consolidate.md +13 -6
  37. package/templates/skills/business-analyse/templates/tpl-handoff.md +1 -1
  38. package/templates/skills/business-analyse/templates/tpl-launch-displays.md +1 -1
  39. package/templates/skills/documentation/SKILL.md +7 -0
  40. package/templates/skills/business-analyse/steps/step-05-deploy.md +0 -220
  41. /package/templates/skills/{business-analyse → ba-generate-html}/html/build-html.js +0 -0
  42. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/cadrage-context.html +0 -0
  43. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/cadrage-scope.html +0 -0
  44. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/cadrage-stakeholders.html +0 -0
  45. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/cadrage-success.html +0 -0
  46. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/consol-datamodel.html +0 -0
  47. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/consol-flows.html +0 -0
  48. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/consol-interactions.html +0 -0
  49. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/consol-permissions.html +0 -0
  50. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/decomp-dependencies.html +0 -0
  51. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/decomp-modules.html +0 -0
  52. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/handoff-summary.html +0 -0
  53. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/partials/module-spec-container.html +0 -0
  54. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/01-data-init.js +0 -0
  55. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/03-render-cadrage.js +0 -0
  56. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/04-render-modules.js +0 -0
  57. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/05-render-specs.js +0 -0
  58. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/06-render-consolidation.js +0 -0
  59. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/06-render-mockups.js +0 -0
  60. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/08-editing.js +0 -0
  61. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/09-export.js +0 -0
  62. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/10-comments.js +0 -0
  63. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/scripts/11-review-panel.js +0 -0
  64. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/01-variables.css +0 -0
  65. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/02-layout.css +0 -0
  66. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/03-navigation.css +0 -0
  67. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/04-cards.css +0 -0
  68. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/05-modules.css +0 -0
  69. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/06-wireframes.css +0 -0
  70. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/07-comments.css +0 -0
  71. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/08-review-panel.css +0 -0
  72. /package/templates/skills/{business-analyse → ba-generate-html}/html/src/styles/09-mockups-html.css +0 -0
  73. /package/templates/skills/{business-analyse → ba-generate-html}/references/wireframe-svg-style-guide.md +0 -0
@@ -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
 
@@ -1,7 +1,7 @@
1
1
  # React Components - Business Analyse Viewer
2
2
 
3
3
  > **Usage:** React component that renders index.json directly
4
- > **Loaded in:** step-05-deploy.md
4
+ > **Loaded in:** /ba-generate-html
5
5
  > **Data source (module):** `docs/{app}/{module}/business-analyse/v{X.Y}/index.json`
6
6
  > **Data source (application):** `docs/{app}/business-analyse/v{X.Y}/index.json`
7
7
  > **Related:** `react/application-viewer.md` for application-level view
@@ -1,7 +1,7 @@
1
1
  # TypeScript Schema - Feature JSON Types
2
2
 
3
3
  > **Usage:** TypeScript interfaces aligned with index.json and application-schema.json
4
- > **Loaded in:** step-05-deploy.md (for web app rendering)
4
+ > **Loaded in:** /ba-generate-html (for web app rendering)
5
5
  > **Source (module):** `docs/{app}/{module}/business-analyse/v{X.Y}/index.json`
6
6
  > **Source (application):** `docs/{app}/business-analyse/v{X.Y}/index.json`
7
7
 
@@ -1,6 +1,6 @@
1
1
  # Module Acceptance Criteria (Shared Reference)
2
2
 
3
- > **Loaded by:** step-03-specify (post-check), step-05-deploy (pre-handoff gate), ralph-loop step-01-task (input validation)
3
+ > **Loaded by:** step-03-specify (post-check), ralph-loop step-01-task (input validation)
4
4
  > **Purpose:** Define measurable, bash-verifiable acceptance criteria that a module MUST pass before being marked "specified".
5
5
  > **Key principle:** These checks read the REAL JSON files on disk — NOT in-memory data the model "thinks" it wrote.
6
6
 
@@ -137,12 +137,7 @@ console.log('PASS: All acceptance criteria met (AC-01 to AC-17)');
137
137
  After writing module JSON files, run the bash script above.
138
138
  IF FAIL → re-execute section 11 write with corrected data → re-run until PASS.
139
139
 
140
- ### 2. step-05-deploy.md (pre-handoff gate)
141
-
142
- Before writing handoff for each module, run the bash script on the module index.json.
143
- IF FAIL → STOP handoff for this module, report which criteria failed.
144
-
145
- ### 3. ralph-loop step-01-task.md (input validation)
140
+ ### 2. ralph-loop step-01-task.md (input validation)
146
141
 
147
142
  At PRD load time, run the bash script on each module index.json.
148
143
  IF FAIL → BLOCKING: "Module {name} does not meet acceptance criteria — run /business-analyse to fix".
@@ -63,7 +63,7 @@ function detectReviewMode(feature_description) {
63
63
  reviewJsonPath: reviewFilePath,
64
64
  applicationName: latestApp.metadata.application,
65
65
  docsDir: versionDir,
66
- nextStep: 'step-06-review.md'
66
+ nextStep: 'redirect-to-ba-review'
67
67
  };
68
68
  }
69
69
  ```
@@ -73,7 +73,7 @@ function detectReviewMode(feature_description) {
73
73
  | Condition | Action |
74
74
  |-----------|--------|
75
75
  | `{feature_description}` starts with `-review` | Activate review mode detection |
76
- | ba-review.json found | Skip to step-06-review.md |
76
+ | ba-review.json found | Redirect user to `/ba-review` skill |
77
77
  | ba-review.json NOT found | Display error with fix instructions, STOP |
78
78
  | No applications exist | Display error, STOP |
79
79
 
@@ -416,7 +416,7 @@ interface DetectionResult {
416
416
  **Test Case 4: Review Mode**
417
417
  - Input: `"-review"`
418
418
  - Existing: `HumanResources` with ba-review.json present
419
- - Expected: Load ba-review.json, skip to step-06-review.md
419
+ - Expected: Redirect user to `/ba-review` skill
420
420
 
421
421
  **Test Case 5: Review Mode - File Missing**
422
422
  - Input: `"-review"`
@@ -75,7 +75,7 @@ Route = ToKebabCase($"/{appCode}/{moduleCode}")
75
75
 
76
76
  ### JavaScript (BA Handoff Generation)
77
77
 
78
- **Location:** Used in step-05-deploy.md when building seedDataCore
78
+ **Location:** Used in /ba-generate-html when building seedDataCore
79
79
 
80
80
  **Usage:**
81
81
  ```javascript
@@ -240,4 +240,4 @@ src/API/Controllers/HumanResources/TimeManagementController.cs
240
240
  - **Template:** `templates/skills/ralph-loop/references/core-seed-data.md`
241
241
  - **Validation:** `src/mcp/tools/validate-frontend-routes.ts`
242
242
  - **POST-CHECK:** `templates/skills/ralph-loop/steps/step-02-execute.md` (section 5)
243
- - **Handoff:** `templates/skills/business-analyse/steps/step-05-deploy.md` (handoff section)
243
+ - **Handoff:** `/derive-prd` skill (handoff section)
@@ -264,96 +264,7 @@ DEVELOPMENT CANNOT PROCEED WITH CIRCULAR DEPENDENCIES
264
264
 
265
265
  ---
266
266
 
267
- ## Phase 3: Ralph Readiness Validation (Step-05)
268
-
269
- > **When:** After artifacts deployed (step-05), before launching /ralph-loop
270
- > **Blocking:** YES - Development blocked if critical checks fail
271
-
272
- ### Purpose
273
-
274
- Final gate to ensure business analysis is 100% ready for implementation. Catches issues before ralph-loop starts, preventing failed development attempts.
275
-
276
- ### Checks (9 categories)
277
-
278
- | # | Category | Checks | Blocking | Purpose |
279
- |---|----------|--------|----------|---------|
280
- | 1 | Module Status | All modules status = "handed-off" | YES | Incomplete modules break ralph-loop |
281
- | 2 | PRD Files | All .ralph/prd-{module}.json files exist, valid structure, file counts match index.json | YES | Ralph-loop reads PRDs for tasks |
282
- | 3 | Dependency Graph | Valid, no cycles, topological order correct | YES | Determines module implementation order |
283
- | 4 | Cross-Module References | All references resolvable | YES | Prevents FK constraint errors |
284
- | 5 | Handoff Completeness | All 8 file categories, brToCodeMapping, apiEndpointSummary | YES | Missing data breaks code generation |
285
- | 6 | i18n Keys | All keys have 4 languages | NO (WARNING) | Missing translations won't block dev |
286
- | 7 | Master Feature | Status = "handed-off", handoff complete | YES | Ralph-loop needs master handoff |
287
- | 8 | Progress Tracker | File exists, structure valid, task count matches | NO (WARNING) | Used for progress tracking |
288
- | 9 | Final Readiness | Aggregate all checks, calculate score | YES if <100% | All critical checks must pass |
289
-
290
- ### Readiness Score
291
-
292
- ```
293
- Readiness Score = (passed critical checks / total critical checks) × 100%
294
- ```
295
-
296
- **Thresholds:**
297
- - **100%** → READY FOR DEVELOPMENT ✓
298
- - **<100%** → NOT READY - FIX REQUIRED ✗
299
-
300
- ### Example Output
301
-
302
- **Ready:**
303
-
304
- ```
305
- ═══════════════════════════════════════════════════════════════
306
- RALPH READINESS CHECK - COMPLETE
307
- ═══════════════════════════════════════════════════════════════
308
-
309
- Validation Summary:
310
- ✓ Module status validation: PASS (5/5 modules)
311
- ✓ PRD files validation: PASS (5/5 files)
312
- ✓ Dependency graph validation: PASS (4 edges)
313
- ✓ Cross-module references validation: PASS (4 references)
314
- ✓ Handoff completeness check: PASS (5/5 modules)
315
- ⚠ i18n keys validation: WARNING (1 missing translation)
316
- ✓ Master feature validation: PASS
317
- ✓ Progress tracker validation: PASS
318
-
319
- Readiness Score: 100% (7/7 critical checks passed, 1 warning)
320
-
321
- Status: READY FOR DEVELOPMENT ✓
322
-
323
- Next Steps:
324
- 1. Address warnings (optional, recommended)
325
- 2. Review progress tracker: .ralph/progress.txt
326
- 3. Launch development: /ralph-loop
327
- (Use /ralph-loop -r ONLY to resume an interrupted loop)
328
- ═══════════════════════════════════════════════════════════════
329
- ```
330
-
331
- **Not Ready:**
332
-
333
- ```
334
- ═══════════════════════════════════════════════════════════════
335
- RALPH READINESS CHECK - FAILED
336
- ═══════════════════════════════════════════════════════════════
337
-
338
- Status: NOT READY FOR DEVELOPMENT ✗
339
-
340
- Critical Issues Found:
341
- ✗ Module status validation: FAIL (1/5 modules incomplete)
342
- - Reporting module status is "specified", must be "handed-off"
343
- - Fix: Return to step-05-deploy.md for Reporting module
344
-
345
- ✗ PRD files validation: FAIL (1/5 files invalid)
346
- - prd-Reporting.json has wrong structure (filesToCreate at root level)
347
- - Fix: Re-run ss derive-prd --feature {path} --output .ralph/prd-Reporting.json
348
-
349
- Required Actions:
350
- 1. Fix all critical issues listed above
351
- 2. Re-run validation: load step-05-deploy.md
352
- 3. Only proceed to /ralph-loop when all critical checks pass
353
-
354
- DO NOT PROCEED TO /RALPH-LOOP UNTIL ALL CRITICAL CHECKS PASS
355
- ═══════════════════════════════════════════════════════════════
356
- ```
267
+ > **Note:** Ralph Readiness Validation (PRD files, handoff completeness, etc.) is handled by the `/derive-prd` skill.
357
268
 
358
269
  ---
359
270
 
@@ -374,7 +285,6 @@ DO NOT PROCEED TO /RALPH-LOOP UNTIL ALL CRITICAL CHECKS PASS
374
285
  **Checkpoints:**
375
286
  - Step-03d: Module completeness (before marking "specified")
376
287
  - Step-04: Cross-module coherence (before marking "consolidated")
377
- - Step-05c: Development readiness (before /ralph-loop)
378
288
 
379
289
  ### 3. Auto-Fix vs. Manual Fix
380
290
 
@@ -486,25 +396,6 @@ WHERE: Return to step-03-specify.md for TimeTracking module
486
396
 
487
397
  ---
488
398
 
489
- ### Issue: Ralph Readiness Check Fails
490
-
491
- **Symptoms:**
492
- - Step-05c reports readiness score < 100%
493
- - Critical checks failed
494
-
495
- **Diagnosis:**
496
- 1. Review failed checks in summary
497
- 2. Identify missing/invalid artifacts
498
-
499
- **Fix:**
500
- - **Module status incomplete:** Return to step-05-deploy for affected module
501
- - **PRD files invalid:** Re-run `ss derive-prd` for affected module
502
- - **Handoff incomplete:** Return to step-05-deploy, complete handoff section
503
- - **Cross-module refs broken:** Return to step-04-consolidate, fix references
504
- - Re-run step-05-deploy after fixes
505
-
506
- ---
507
-
508
399
  ## Metrics & Success Criteria
509
400
 
510
401
  ### Module Specification Checklist
@@ -525,17 +416,7 @@ WHERE: Return to step-03-specify.md for TimeTracking module
525
416
 
526
417
  **Success:**
527
418
  - Application marked as "consolidated"
528
- - Ready for handoff
529
-
530
- ### Ralph Readiness (Step-05)
531
-
532
- **Target:**
533
- - 100% critical checks passed
534
- - Warnings addressed or documented
535
-
536
- **Success:**
537
- - Application ready for /ralph-loop
538
- - Development can proceed with full confidence
419
+ - Ready for `/ba-generate-html` and `/derive-prd`
539
420
 
540
421
  ---
541
422
 
@@ -147,18 +147,17 @@ const checklist = {
147
147
  },
148
148
 
149
149
  wireframeSchemaCompliance: {
150
- check: "All wireframes have required fields: screen, section, mockupFormat, elements[], componentMapping[], layout (object), permissionsRequired[]",
150
+ check: "All wireframes have required fields: screen, section, mockupFormat, elements[], layout (object), permissionsRequired[]",
151
151
  status: (specification.uiWireframes || specification.wireframes || []).every(wf =>
152
152
  (wf.screen || wf.title) && wf.section && (wf.mockupFormat || wf.mockup || wf.ascii) &&
153
153
  Array.isArray(wf.elements) && wf.elements.length > 0 &&
154
- Array.isArray(wf.componentMapping) && wf.componentMapping.length > 0 &&
155
154
  typeof wf.layout === 'object' && wf.layout !== null &&
156
155
  Array.isArray(wf.permissionsRequired)
157
156
  ) ? "PASS" : "FAIL",
158
157
  blocking: true,
159
- details: "Wireframes missing metadata render as empty frames in HTML documentation. " +
158
+ details: "Wireframes missing metadata render as empty frames. " +
160
159
  "Check: screen (not name/id/title), section, mockupFormat, elements[] non-empty, " +
161
- "componentMapping[] as array of {wireframeElement, reactComponent}, layout as object (not string). " +
160
+ "layout as object (not string). " +
162
161
  "Also see references/acceptance-criteria.md for bash-verifiable checks."
163
162
  },
164
163
 
@@ -43,7 +43,7 @@
43
43
  }
44
44
  },
45
45
 
46
- "$comment": "Sub-schema loading guide per BA step: step-00-init → metadata-schema.json | step-01-cadrage → discovery-schema.json (module) OR application-schema.json (master) | step-02-structure → application-schema.json (modules[], dependencyGraph) | step-03-specify → analysis-schema.json + specification-schema.json | step-04-consolidate → validation-schema.json + application-schema.json (consolidation) | step-05-deployhandoff-schema.json (filesToCreate, brToCodeMapping, apiEndpointSummary) + (prd, progress, manifest, ba-interactive.html) | step-06-reviewapplies ba-review.json corrections, creates new version",
46
+ "$comment": "Sub-schema loading guide per BA step: step-00-init → metadata-schema.json | step-01-cadrage → discovery-schema.json (module) OR application-schema.json (master) | step-02-structure → application-schema.json (modules[], dependencyGraph) | step-03-specify → analysis-schema.json + specification-schema.json | step-04-consolidate → validation-schema.json + application-schema.json (consolidation). HTML generation/ba-generate-html skill. Review corrections /ba-review skill. Handoff /derive-prd skill",
47
47
 
48
48
  "$defs": {
49
49
  "stepStatus": { "$ref": "shared/common-defs.json#/$defs/stepStatus" },