@atlashub/smartstack-cli 2.1.0 → 2.3.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 (38) hide show
  1. package/.documentation/business-analyse.html +1503 -1058
  2. package/dist/index.js +92 -55
  3. package/dist/index.js.map +1 -1
  4. package/package.json +10 -7
  5. package/templates/agents/ba-reader.md +250 -0
  6. package/templates/agents/ba-writer.md +210 -0
  7. package/templates/agents/docs-context-reader.md +51 -33
  8. package/templates/skills/_shared.md +2 -0
  9. package/templates/skills/business-analyse/SKILL.md +120 -108
  10. package/templates/skills/business-analyse/_shared.md +136 -146
  11. package/templates/skills/business-analyse/patterns/suggestion-catalog.md +478 -0
  12. package/templates/skills/business-analyse/questionnaire/01-context.md +3 -15
  13. package/templates/skills/business-analyse/questionnaire/03-scope.md +7 -7
  14. package/templates/skills/business-analyse/questionnaire/08-performance.md +7 -21
  15. package/templates/skills/business-analyse/questionnaire/09-constraints.md +0 -13
  16. package/templates/skills/business-analyse/questionnaire/10-documentation.md +0 -13
  17. package/templates/skills/business-analyse/questionnaire/12-migration.md +1 -1
  18. package/templates/skills/business-analyse/questionnaire.md +72 -76
  19. package/templates/skills/business-analyse/react/components.md +317 -154
  20. package/templates/skills/business-analyse/react/i18n-template.md +167 -106
  21. package/templates/skills/business-analyse/react/schema.md +474 -107
  22. package/templates/skills/business-analyse/schemas/feature-schema.json +860 -0
  23. package/templates/skills/business-analyse/steps/step-00-init.md +395 -285
  24. package/templates/skills/business-analyse/steps/step-01-analyse.md +523 -0
  25. package/templates/skills/business-analyse/steps/step-02-specify.md +899 -0
  26. package/templates/skills/business-analyse/steps/step-03-validate.md +1009 -0
  27. package/templates/skills/business-analyse/steps/step-04-handoff.md +1802 -0
  28. package/templates/skills/business-analyse/templates/tpl-handoff.md +49 -64
  29. package/templates/skills/business-analyse/steps/step-01-discover.md +0 -737
  30. package/templates/skills/business-analyse/steps/step-02-analyse.md +0 -299
  31. package/templates/skills/business-analyse/steps/step-03-specify.md +0 -472
  32. package/templates/skills/business-analyse/steps/step-04-validate.md +0 -335
  33. package/templates/skills/business-analyse/steps/step-05-handoff.md +0 -741
  34. package/templates/skills/business-analyse/steps/step-06-doc-html.md +0 -320
  35. package/templates/skills/business-analyse/templates/00-context.md +0 -105
  36. package/templates/skills/business-analyse/templates/tpl-brd.md +0 -97
  37. package/templates/skills/business-analyse/templates/tpl-discovery.md +0 -78
  38. package/templates/skills/business-analyse/tracking/change-template.md +0 -30
@@ -55,4 +55,4 @@
55
55
  | "On saisira tout à la main" | **Migration non planifiée** | Si > 100 enregistrements, l'import automatisé est indispensable |
56
56
  | Pas de validation post-migration | **Données non vérifiées** | Prévoir un rapport de migration : importés / rejetés / à corriger |
57
57
  | Aucun rollback plan | **Risque de perte de données** | Toujours faire un backup avant migration + possibilité de rollback |
58
- | "On migrera plus tard" | **Dette technique** | Si la migration est nécessaire, la planifier dès la v1 même si simplifiée |
58
+ | "On migrera plus tard" | **Dette technique** | Si la migration est nécessaire, la planifier dès le départ même si simplifiée |
@@ -1,35 +1,36 @@
1
1
  # Elicitation Questionnaire - Business Analysis
2
2
 
3
- > **Usage:** Structured questions for phase 2-discover
4
- > **Standard:** BABOK v3 - Elicitation Techniques
3
+ > **Usage:** Structured questions for step-01-analyse
4
+ > **Standard:** BABOK v3 - Elicitation Techniques (VibeCoding-focused)
5
5
  > **Model:** OPUS with ULTRATHINK
6
+ > **Total:** ~60 targeted questions (dev-relevant only)
6
7
 
7
8
  ---
8
9
 
9
10
  ## ULTRATHINK RULE
10
11
 
11
12
  ```
12
- ╔══════════════════════════════════════════════════════════════════════════════╗
13
- ULTRATHINK: Deep thinking mode for exhaustive elicitation
14
- ╠══════════════════════════════════════════════════════════════════════════════╣
15
-
16
- During the discover phase, Claude MUST:
17
- Consider ALL edge cases before formulating a question
18
- Challenge EVERY stakeholder assumption
19
- Anticipate unexpressed needs
20
- Validate completeness before moving to next question
21
-
22
- DO NOT:
23
- Accept vague answers
24
- Skip question categories
25
- Assume stakeholder has thought of everything
26
-
27
- ╚══════════════════════════════════════════════════════════════════════════════╝
13
+ +==============================================================================+
14
+ | ULTRATHINK: Deep thinking mode for exhaustive elicitation |
15
+ +==============================================================================+
16
+ | |
17
+ | During the analyse phase, Claude MUST: |
18
+ | - Consider ALL edge cases before formulating a question |
19
+ | - Challenge EVERY stakeholder assumption |
20
+ | - Anticipate unexpressed needs |
21
+ | - Validate completeness before moving to next question |
22
+ | |
23
+ | DO NOT: |
24
+ | - Accept vague answers |
25
+ | - Skip question categories |
26
+ | - Assume stakeholder has thought of everything |
27
+ | |
28
+ +==============================================================================+
28
29
  ```
29
30
 
30
31
  ---
31
32
 
32
- ## Category 1: Business Context
33
+ ## Category 1: Business Context (4 questions)
33
34
 
34
35
  ### 1.1 Fundamental Need
35
36
 
@@ -38,20 +39,13 @@
38
39
  | Q1.1 | What business problem should this module/feature solve? | Free text |
39
40
  | Q1.2 | What is the current situation (AS-IS)? | Description |
40
41
  | Q1.3 | What is the target situation (TO-BE)? | Description |
41
- | Q1.4 | What are the measurable success KPIs? | List + values |
42
+ | Q1.4 | What happens if this module is NOT developed? | Impact |
42
43
 
43
- ### 1.2 Business Value
44
-
45
- | # | Question | Answer Type |
46
- |---|----------|-------------|
47
- | Q1.5 | What ROI do you expect? (time, money, efficiency) | Quantitative |
48
- | Q1.6 | What savings or gains will this module bring? | Estimation |
49
- | Q1.7 | What happens if this module is NOT developed? | Impact |
50
- | Q1.8 | What is the priority compared to other needs? | High/Medium/Low |
44
+ > **Trimmed:** KPIs, ROI, savings, timeline (project management scope)
51
45
 
52
46
  ---
53
47
 
54
- ## Category 2: Stakeholders
48
+ ## Category 2: Stakeholders (8 questions)
55
49
 
56
50
  ### 2.1 Identification
57
51
 
@@ -73,7 +67,7 @@
73
67
 
74
68
  ---
75
69
 
76
- ## Category 3: Functional Scope
70
+ ## Category 3: Functional Scope (8 questions)
77
71
 
78
72
  ### 3.1 Functionality
79
73
 
@@ -95,7 +89,7 @@
95
89
 
96
90
  ---
97
91
 
98
- ## Category 4: Data
92
+ ## Category 4: Data (8 questions)
99
93
 
100
94
  ### 4.1 Entities
101
95
 
@@ -117,7 +111,7 @@
117
111
 
118
112
  ---
119
113
 
120
- ## Category 5: Integrations
114
+ ## Category 5: Integrations (8 questions)
121
115
 
122
116
  ### 5.1 Existing Systems
123
117
 
@@ -139,7 +133,7 @@
139
133
 
140
134
  ---
141
135
 
142
- ## Category 6: Security & Permissions
136
+ ## Category 6: Security & Permissions (8 questions)
143
137
 
144
138
  ### 6.1 Access
145
139
 
@@ -161,7 +155,7 @@
161
155
 
162
156
  ---
163
157
 
164
- ## Category 7: User Interface
158
+ ## Category 7: User Interface (8 questions)
165
159
 
166
160
  ### 7.1 Experience
167
161
 
@@ -183,29 +177,22 @@
183
177
 
184
178
  ---
185
179
 
186
- ## Category 8: Performance & Quality
180
+ ## Category 8: Performance & Quality (4 questions)
187
181
 
188
- ### 8.1 Performance
182
+ ### 8.1 Performance & Quality
189
183
 
190
184
  | # | Question | Answer Type |
191
185
  |---|----------|-------------|
192
186
  | Q8.1 | Acceptable response time? | Milliseconds |
193
- | Q8.2 | Number of concurrent users? | Estimation |
194
- | Q8.3 | Expected load peaks? | When + volume |
195
- | Q8.4 | Required availability? (SLA) | Percentage |
187
+ | Q8.2 | Expected load peaks? | When + volume |
188
+ | Q8.3 | Specific tests required? | Types |
189
+ | Q8.4 | Overall acceptance criteria? | List |
196
190
 
197
- ### 8.2 Quality
198
-
199
- | # | Question | Answer Type |
200
- |---|----------|-------------|
201
- | Q8.5 | Acceptable error rate? | Percentage |
202
- | Q8.6 | Specific tests required? | Types |
203
- | Q8.7 | Available test environments? | List |
204
- | Q8.8 | Overall acceptance criteria? | List |
191
+ > **Trimmed:** Concurrent users, SLA, error rate, test environments (ops/infra scope)
205
192
 
206
193
  ---
207
194
 
208
- ## Category 9: Constraints
195
+ ## Category 9: Constraints (4 questions)
209
196
 
210
197
  ### 9.1 Technical
211
198
 
@@ -216,18 +203,11 @@
216
203
  | Q9.3 | Technology dependencies? | List |
217
204
  | Q9.4 | Compatibility constraints? | List |
218
205
 
219
- ### 9.2 Organizational
220
-
221
- | # | Question | Answer Type |
222
- |---|----------|-------------|
223
- | Q9.5 | Available budget? | Amount |
224
- | Q9.6 | Fixed or flexible deadline? | Date + flexibility |
225
- | Q9.7 | Available resources? | Team |
226
- | Q9.8 | Approval process? | Steps |
206
+ > **Trimmed:** Budget, deadline, resources, approval process (PM scope)
227
207
 
228
208
  ---
229
209
 
230
- ## Category 10: Documentation & Support
210
+ ## Category 10: Documentation & Support (4 questions)
231
211
 
232
212
  ### 10.1 Documentation
233
213
 
@@ -238,25 +218,32 @@
238
218
  | Q10.3 | User training planned? | Plan |
239
219
  | Q10.4 | Knowledge base to create? | Scope |
240
220
 
241
- ### 10.2 Support
221
+ > **Trimmed:** Support level, L1/L2, escalation, monitoring (ops scope)
242
222
 
243
- | # | Question | Answer Type |
244
- |---|----------|-------------|
245
- | Q10.5 | Expected support level? | SLA |
246
- | Q10.6 | Who provides level 1 support? | Team |
247
- | Q10.7 | Escalation to level 2? | Process |
248
- | Q10.8 | Monitoring and alerts required? | List |
223
+ ---
224
+
225
+ ## Conditional Categories (loaded only if relevant)
226
+
227
+ ### Category 11: Data Lifecycle (questionnaire/11-data-lifecycle.md)
228
+ > Loaded if: entities have retention/archival/GDPR requirements
229
+
230
+ ### Category 12: Migration (questionnaire/12-migration.md)
231
+ > Loaded if: data migration from existing system needed
232
+
233
+ ### Category 13: Cross-Module Impact (questionnaire/13-cross-module.md)
234
+ > Loaded if: feature interacts with existing modules
249
235
 
250
236
  ---
251
237
 
252
238
  ## Questionnaire Usage
253
239
 
254
- ### Discovery Phase
240
+ ### Analyse Phase
255
241
 
256
242
  1. **Start:** Begin with Category 1 (Business Context)
257
243
  2. **Adapt:** Skip questions not relevant to the context
258
244
  3. **Deepen:** Ask follow-up questions on vague answers
259
245
  4. **Challenge:** Don't accept "we'll see later" on Must-Have
246
+ 5. **Batch:** Present 3-5 questions per interaction (AskUserQuestion)
260
247
 
261
248
  ### Follow-up Questions
262
249
 
@@ -266,18 +253,27 @@ For each vague answer, use:
266
253
  - "What happens if this rule is not respected?"
267
254
  - "Who is impacted by this decision?"
268
255
 
269
- ### Documentation
256
+ ### Dev-Relevance Filter
270
257
 
271
- Each answer should be documented with:
272
- - Source (who answered)
273
- - Date
274
- - Confidence level (Confirmed/To validate/Hypothesis)
275
- - Open follow-up questions
258
+ Each question kept passes this test:
259
+ > "Does the answer change something in the generated code?"
260
+ > Yes -> Keep | No -> Remove
276
261
 
277
262
  ---
278
263
 
279
- ## Support
280
-
281
- > **Questions about requirements elicitation?**
282
- >
283
- > 📧 **support@atlshub.ch**
264
+ ## Summary
265
+
266
+ | Category | Questions | Focus |
267
+ |----------|-----------|-------|
268
+ | 1. Business Context | 4 | Problem + AS-IS/TO-BE |
269
+ | 2. Stakeholders | 8 | Roles + needs |
270
+ | 3. Functional Scope | 8 | MoSCoW + flows |
271
+ | 4. Data | 8 | Entities + rules |
272
+ | 5. Integrations | 8 | Systems + flows |
273
+ | 6. Security | 8 | Permissions + restrictions |
274
+ | 7. UI | 8 | Screens + experience |
275
+ | 8. Performance | 4 | Response time + tests |
276
+ | 9. Constraints | 4 | Tech stack + deps |
277
+ | 10. Documentation | 4 | User + tech docs |
278
+ | **Total Core** | **64** | |
279
+ | 11-13 (conditional) | ~24 | Lifecycle, migration, cross-module |