@atlashub/smartstack-cli 3.4.0 → 3.4.1

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.
@@ -60,22 +60,14 @@ IF mcp_available:
60
60
  Store findings in {codebase_context}
61
61
  ```
62
62
 
63
- **Phase 2b: Parallel Agents (unless economy_mode)**
63
+ **Phase 2b: Parallel Codebase Agents**
64
64
  ```
65
- IF NOT economy_mode:
66
- Launch 3 agents in parallel:
67
- Agent 1: Search for existing domain entities (Glob: **/Domain/**/*.cs)
68
- Agent 2: Search for existing services/integrations (Grep: IService, IRepository)
69
- Agent 3: Search for existing page patterns (Glob: **/pages/business/**/*.tsx)
65
+ Launch 3 agents in parallel:
66
+ Agent 1: Search for existing domain entities (Glob: **/Domain/**/*.cs)
67
+ Agent 2: Search for existing services/integrations (Grep: IService, IRepository)
68
+ Agent 3: Search for existing page patterns (Glob: **/pages/business/**/*.tsx)
70
69
 
71
- Merge findings into {codebase_context}
72
- ```
73
-
74
- **Phase 2c: Economy Mode**
75
- ```
76
- IF economy_mode:
77
- Use Glob/Grep directly (no subagents)
78
- Quick scan of Domain/, Application/, pages/ directories
70
+ Merge findings into {codebase_context}
79
71
  ```
80
72
 
81
73
  ### 3. Application-Level Questionnaire (application mode)
@@ -224,13 +224,15 @@ prd.json generated for module {moduleCode}:
224
224
 
225
225
  ---
226
226
 
227
- ### 5. User Choice: Next Agent
227
+ ### 5. Completion Summary
228
228
 
229
- Present development options after successful handoff:
229
+ Display the completion summary after successful handoff:
230
+
231
+ > **Reference:** Read `templates/tpl-launch-displays.md` for user-facing display templates.
230
232
 
231
233
  ```
232
234
  ═══════════════════════════════════════════════════════════════
233
- HANDOFF COMPLETE - {application_name}
235
+ [OK] BUSINESS ANALYSE TERMINEE - {application_name}
234
236
  ═══════════════════════════════════════════════════════════════
235
237
 
236
238
  Modules: {count} ({names})
@@ -240,82 +242,37 @@ Tasks: {total tasks} ({core_count} CORE + {biz_count} business + {dev_count}
240
242
  Complexity: {complexity}
241
243
  Effort: {total_days} days ({total_hours} hours)
242
244
 
243
- Generated Artifacts:
244
- ✓ feature.json (master + per-module) - enhanced with handoff section
245
- ✓ .ralph/prd.json or .ralph/prd-{module}.json - derived from feature.json
246
- ✓ .ralph/progress.txt - comprehensive task tracker
247
- ✓ ba-interactive.html - client-facing interactive review document
248
- ✓ Implementation strategy selected: {strategy}
249
-
250
- Next: Choose development approach
251
- ═══════════════════════════════════════════════════════════════
252
- ```
253
-
254
- Ask via AskUserQuestion:
245
+ [DIR] Artefacts generés:
246
+ ✓ feature.json (master + per-module) - spécification complète
247
+ ✓ .ralph/prd.json or .ralph/prd-{module}.json - task breakdown
248
+ ✓ .ralph/progress.txt - tracker de progression
249
+ ✓ ba-interactive.html - document de revue interactif
255
250
 
256
- ```
257
- question: "Quelle approche de développement souhaitez-vous utiliser ?"
258
- header: "Approche de développement"
259
- options:
260
- - label: "Feature Full (Recommandé)"
261
- description: "Génération parallèle rapide (code + tests). Couverture 70-80%. ~{hours/3} heures."
262
- - label: "Ralph Loop"
263
- description: "Développement itératif task-par-task avec cycle : Analyse → Dev (backend + tests unitaires + tests non-régression + frontend + tests + documentation) → Validation → Correction → Test ... jusqu'à 100% tests pass. Couverture 95-100%. ~{hours} heures."
264
- - label: "Terminer le BA"
265
- description: "Finir l'analyse, développement manuel par l'équipe."
266
- ```
267
-
268
- **Recommendations by complexity:**
269
- - **Simple:** Feature Full (1-3 days) or Ralph Loop (2-4 days)
270
- - **Medium:** Ralph Loop recommended (5-10 days), Feature Full possible (3-6 days)
271
- - **Complex:** Ralph Loop strongly recommended (10-20 days), Feature Full (8-12 days)
272
-
273
- ---
251
+ [TARGET] Prochaines étapes:
252
+ 1. Ouvrir ba-interactive.html dans le navigateur
253
+ 2. Partager avec les stakeholders pour validation
254
+ 3. Si retours --> relancer /business-analyse pour une nouvelle itération
255
+ 4. Une fois validé, lancer le développement:
274
256
 
275
- ### 5-bis. Execute User Choice (Automatic Skill Launch)
257
+ /ralph-loop -r
276
258
 
277
- > Automatically launch the chosen development approach for seamless transition.
278
-
279
- **After receiving AskUserQuestion response:**
280
-
281
- > **Reference:** Read `templates/tpl-launch-displays.md` for user-facing display templates.
282
-
283
- **Implementation:**
284
-
285
- ```javascript
286
- const choice = userAnswer; // "Feature Full (Recommandé)" | "Ralph Loop" | "Terminer le BA"
287
- const choiceLabel = choice.replace(/\s*\(.*?\)\s*$/g, '').trim();
288
-
289
- if (choiceLabel === "Ralph Loop") {
290
- // Display: Ralph Loop explanation and configuration (from tpl-launch-displays.md)
291
- // Then launch: Skill({ skill: "ralph-loop" });
292
- // EXIT - ralph-loop takes over
293
-
294
- } else if (choiceLabel === "Feature Full") {
295
- // Display: Feature Full configuration summary (from tpl-launch-displays.md)
296
- // Then launch: Skill({ skill: "feature-full" });
297
- // EXIT
298
-
299
- } else {
300
- // Display: BA completion summary and next steps (from tpl-launch-displays.md)
301
- // EXIT gracefully
302
- }
259
+ ═══════════════════════════════════════════════════════════════
303
260
  ```
304
261
 
305
- **Error handling:** If Skill() call fails, display manual launch instructions (see tpl-launch-displays.md).
262
+ **No AskUserQuestion here.** The BA ends after displaying the summary. The user will manually launch `/ralph-loop -r` when ready (typically after stakeholder validation).
306
263
 
307
264
  ---
308
265
 
309
266
  ## SELF-VERIFICATION (FINAL)
310
267
 
311
- Before presenting user choice, VERIFY:
268
+ Before presenting completion summary, VERIFY:
312
269
 
313
270
  1. **`.ralph/prd-{module}.json`** exists for ALL modules (file size > 100 bytes each)
314
271
  2. **`.ralph/progress.txt`** exists (file size > 500 bytes)
315
272
  3. **`ba-interactive.html`** exists at `docs/business/{app}/business-analyse/v{version}/` and file size > 100KB (pre-populated, not empty template)
316
273
  4. **`docs/business/index.json`** exists with correct entry count (1 app + N modules)
317
274
 
318
- **IF any check fails → GENERATE the missing artifact before presenting user choice.**
275
+ **IF any check fails → GENERATE the missing artifact before presenting completion summary.**
319
276
 
320
277
  ---
321
278
 
@@ -337,7 +294,7 @@ Simplified handoff with minimal scope:
337
294
  - 3 core SeedData entries (omit some optional ones)
338
295
  - Basic prd.json with simplified sections
339
296
  - Lightweight progress.txt
340
- - Auto-suggest Feature Full for rapid development
297
+ - Display `/ralph-loop -r` command for later use
341
298
 
342
299
  ### Delta Mode (use_case = refactoring)
343
300
 
@@ -381,10 +338,7 @@ Also generates working files and updates the manifest:
381
338
  - Effort estimates per module
382
339
  - Cross-module integration tasks (if multi-module)
383
340
 
384
- Next agent selection via user question:
385
- 1. **Feature Full** - Parallel rapid code generation (70-80% coverage)
386
- 2. **Ralph Loop** - Sequential task-driven development (95-100% coverage)
387
- 3. **End BA** - Manual development by team
341
+ Completion: Display summary with `/ralph-loop -r` command for later execution after stakeholder validation.
388
342
 
389
343
  ---
390
344
 
@@ -471,7 +425,6 @@ Before presenting handoff to user:
471
425
  | progress.txt incomplete | Ensure all 5 CORE SeedData entries are present per module. Check topological order. |
472
426
  | ba-interactive.html deployment failed | Verify output directory exists. Check file permissions. Ensure HTML template is readable. |
473
427
  | BA manifest not found | Create docs/business/index.json if missing. Use schema provided in section 4. |
474
- | User choice question failed | Catch AskUserQuestion error and display manual instructions for skill launch. |
475
428
  | HTML pre-populated but empty | Verify FEATURE_DATA and EMBEDDED_ARTIFACTS objects are serialized correctly. Check JSON syntax. |
476
429
 
477
430
  ---
@@ -12,23 +12,18 @@
12
12
  > **Version:** {version}
13
13
  > **Validated Specs:** feature.json (validation.decision = APPROVED)
14
14
  > **Source:** `docs/business/{app}/{module}/business-analyse/v{version}/feature.json`
15
- > **Implementation:** `/ralph-loop -r` (iterative) | `/feature-full business/{app}/{module}` (one-shot)
15
+ > **Implementation:** `/ralph-loop -r`
16
16
 
17
17
  ## DEVELOPER INSTRUCTIONS
18
18
 
19
19
  This document is a self-contained prompt for Claude Code.
20
20
 
21
- **Option 1 - Iterative (recommended):**
21
+ **Lancement:**
22
22
  ```
23
23
  /ralph-loop -r
24
24
  ```
25
25
  > Pre-generated `.ralph/prd.json` with atomic task breakdown.
26
26
 
27
- **Option 2 - One-shot:**
28
- ```
29
- /feature-full business/{app}/{module}
30
- ```
31
-
32
27
  ---
33
28
 
34
29
  ## 1. QUICK CONTEXT
@@ -181,13 +176,8 @@ From: `feature.specification.seedDataCore` (5 core files), `feature.specificatio
181
176
 
182
177
  ## EXECUTION
183
178
 
184
- **Iterative (recommended):**
179
+ **Lancement:**
185
180
  ```bash
186
181
  /ralph-loop -r
187
182
  ```
188
-
189
- **One-shot:**
190
- ```bash
191
- /feature-full business/{app}/{module}
192
- ```
193
183
  ```
@@ -1,158 +1,53 @@
1
1
  # Skill Launch Display Templates (templates/tpl-launch-displays.md)
2
2
 
3
- > **Used by:** step-05b-deploy (section 5-bis: Execute User Choice)
4
- > **Purpose:** User-facing display templates for development approach choices
3
+ > **Used by:** step-05b-deploy (section 5: Completion Summary)
4
+ > **Purpose:** User-facing display templates for BA completion
5
5
  > **Note:** No emojis - uses text markers per Claude Code conventions
6
6
 
7
7
  ---
8
8
 
9
- ## 1. Ralph Loop Launch Display
9
+ ## 1. BA Completion Display
10
10
 
11
- Display when user selects "Ralph Loop" development approach:
11
+ Display at the end of the business analysis:
12
12
 
13
13
  ```
14
- [LAUNCH] Lancement de Ralph Loop - Développement itératif automatique
15
-
16
- ╔══════════════════════════════════════════════════════════════╗
17
- ║ CYCLE RALPH LOOP - Comment ça fonctionne ? ║
18
- ╠══════════════════════════════════════════════════════════════╣
19
- ║ ║
20
- ║ Ralph Loop exécute un cycle itératif jusqu'à 100% tests: ║
21
- ║ ║
22
- ║ 1. ANALYSE --> Charger task suivante du prd.json ║
23
- ║ 2. DÉVELOPPEMENT --> Générer le code demandé ║
24
- ║ • Backend (Entities, Services, Controllers, Repos) ║
25
- ║ • Tests unitaires (xUnit) + non-régression ║
26
- ║ • Frontend (Pages, Components, Hooks) ║
27
- ║ • Tests frontend (React Testing Library) ║
28
- ║ • SeedData (Core RBAC + business data) ║
29
- ║ • Documentation utilisateur (inline + tooltips) ║
30
- ║ 3. VALIDATION --> Commit + MCP conventions check ║
31
- ║ 4. TEST --> Exécuter dotnet test + npm test ║
32
- ║ 5. CORRECTION --> Si échec, analyser et corriger ║
33
- ║ 6. BOUCLE --> Répéter 4-5 jusqu'à 100% tests pass ║
34
- ║ 7. NEXT TASK --> Passer à la task suivante (retour à 1) ║
35
- ║ ║
36
- ║ [TARGET] Objectif: ZÉRO ERREUR avant de passer à la task suivante║
37
- ║ [STATS] Couverture: 95-100% (tests générés automatiquement) ║
38
- ║ ║
39
- ╚══════════════════════════════════════════════════════════════╝
40
-
41
- Configuration du projet:
42
- ┌────────────────────────────────────────────────────────────┐
43
- │ Modules: {modules_list}
44
- │ Stratégie: {implementation_strategy}
45
- │ PRD: {prd_file_path}
46
- │ Progress: .ralph/progress.txt
47
- │ Ordre: {module_order}
48
- │ └────────────────────────────────────────────────────────────┘
49
-
50
- Modules à traiter (dans l'ordre):
51
- {modules_numbered_list}
52
-
53
- [DIR] Fichiers générés par le BA (inputs pour Ralph):
54
- ├─ feature.json (master + modules) --> Spécification source
55
- ├─ prd.json (ou prd-{module}.json) --> Task breakdown avec UC/FR/BR
56
- ├─ progress.txt --> Tracker hiérarchique (module --> layer --> tasks)
57
- └─ ba-interactive.html --> Revue client (mockups, wireframes)
58
-
59
- [LOOP] Ralph Loop va maintenant:
60
- 1. Détecter les prd-*.json par module (si multi-module)
61
- 2. Créer modules-queue.json avec l'ordre de traitement
62
- 3. Traiter module par module dans l'ordre topologique
63
- 4. Pour chaque module: parcourir les tasks (domain --> seeddata --> application --> infrastructure --> api --> frontend --> i18n --> tests)
64
- 5. Pour chaque task: générer code --> commit --> tests --> correction si échec --> re-test --> next task
65
- 6. Passer au module suivant quand 100% tasks du module actuel = completed
66
- 7. Générer rapport final avec métriques de couverture
67
-
68
14
  ═══════════════════════════════════════════════════════════════
69
-
70
- --> Transition vers Ralph Loop...
71
- ```
72
-
73
- ---
74
-
75
- ## 2. Feature Full Launch Display
76
-
77
- Display when user selects "Feature Full" development approach:
78
-
79
- ```
80
- [LAUNCH] Lancement de Feature Full...
81
-
82
- Configuration:
83
- - Mode: Parallel generation
84
- - Couverture: 70-80%
85
- - Durée estimée: ~{estimated_hours} heures
86
-
15
+ [OK] BUSINESS ANALYSE TERMINEE - {application_name}
87
16
  ═══════════════════════════════════════════════════════════════
88
- ```
89
17
 
90
- ---
91
-
92
- ## 3. Manual Development Complete Display
93
-
94
- Display when user selects "Terminer le BA" (end Business Analysis):
95
-
96
- ```
97
- [OK] Business Analysis terminée.
98
-
99
- Les équipes peuvent commencer le développement manuel.
100
- Tous les artefacts sont prêts pour l'implémentation.
18
+ Modules: {count} ({names})
19
+ Strategy: {strategy}
20
+ Files: {total files across all modules}
21
+ Tasks: {total tasks} ({core_count} CORE + {biz_count} business + {dev_count} development)
22
+ Complexity: {complexity}
23
+ Effort: {total_days} days ({total_hours} hours)
101
24
 
102
- [DIR] Fichiers générés:
103
- - feature.json (master + modules) - Spécification complète
104
- - .ralph/prd.json (ou prd-{module}.json) - Task breakdown
105
- - .ralph/progress.txt - Tracker de progression
106
- - ba-interactive.html - Document de revue client
25
+ [DIR] Artefacts générés:
26
+ feature.json (master + per-module) - spécification complète
27
+ .ralph/prd.json or .ralph/prd-{module}.json - task breakdown
28
+ .ralph/progress.txt - tracker de progression
29
+ ba-interactive.html - document de revue interactif
107
30
 
108
- [STATS] Métriques:
109
- - Modules: {modules_count}
110
- - Entités: {total_entities}
111
- - Use cases: {total_use_cases}
112
- - Business rules: {total_business_rules}
113
- - Fichiers à créer: {total_files}
31
+ [TARGET] Prochaines étapes:
32
+ 1. Ouvrir ba-interactive.html dans le navigateur
33
+ 2. Partager avec les stakeholders pour validation
34
+ 3. Si retours --> relancer /business-analyse pour une nouvelle itération
35
+ 4. Une fois validé, lancer le développement:
114
36
 
115
- [TARGET] Prochaines étapes recommandées:
116
- 1. Ouvrir ba-interactive.html dans le navigateur
117
- 2. Partager avec les stakeholders pour validation finale
118
- 3. Utiliser progress.txt comme guide de développement
119
- 4. Implémenter module par module selon l'ordre topologique
120
-
121
- [TIP] Pour lancer le développement assisté plus tard:
122
- - Ralph Loop: /ralph-loop (détecte automatiquement .ralph/prd.json)
123
- - Feature Full: /feature-full
37
+ /ralph-loop -r
124
38
 
125
39
  ═══════════════════════════════════════════════════════════════
126
40
  ```
127
41
 
128
42
  ---
129
43
 
130
- ## 4. Error Handling Display
131
-
132
- Display when skill launch fails:
133
-
134
- ```
135
- [!] Échec du lancement automatique de Ralph Loop
136
-
137
- Veuillez lancer manuellement:
138
- /ralph-loop
139
-
140
- Si le problème persiste:
141
- 1. Vérifier que la skill ralph-loop est installée
142
- 2. Vérifier les permissions Claude Code
143
- 3. Consulter les logs: .ralph/logs/
144
- ```
145
-
146
- ---
147
-
148
44
  ## Text Marker Legend
149
45
 
150
46
  | Marker | Replaces | Usage |
151
47
  |--------|----------|-------|
152
- | `-->` | `➡️` or `→` | Directional flow, transitions |
48
+ | `-->` | `->` or `→` | Directional flow, transitions |
153
49
  | `[OK]` | `✅` | Success, completion |
154
50
  | `[!]` | `⚠️` | Warning, caution |
155
- | `[LAUNCH]` | `🚀` | Skill launch, startup |
156
51
  | `[DIR]` | `📂` | Files, directories, structure |
157
52
  | `[STATS]` | `📊` | Metrics, statistics, coverage |
158
53
  | `[TIP]` | `💡` | Advice, suggestions |
@@ -353,23 +353,18 @@ Feature: {FEAT-XXX} {Feature Name}
353
353
  > **Module:** business/{application}/{module}
354
354
  > **Version:** 1.0
355
355
  > **Validated Specs:** Specification v1.0 (validation.json)
356
- > **Implementation:** `/ralph-loop -r` (iterative) | `/feature-full business/{app}/{module}` (one-shot)
356
+ > **Implementation:** `/ralph-loop -r`
357
357
 
358
358
  ## DEVELOPER INSTRUCTIONS
359
359
 
360
360
  This document is a self-contained prompt for Claude Code.
361
361
 
362
- **Option 1 - Iterative (recommended):**
362
+ **Lancement:**
363
363
  ```
364
364
  /ralph-loop -r
365
365
  ```
366
366
  > Pre-generated `.ralph/prd.json` with atomic task breakdown.
367
367
 
368
- **Option 2 - One-shot:**
369
- ```
370
- /feature-full business/{app}/{module}
371
- ```
372
-
373
368
  ---
374
369
 
375
370
  ## 1. QUICK CONTEXT
@@ -462,21 +457,10 @@ FRONTEND:
462
457
 
463
458
  ## EXECUTION
464
459
 
465
- **Iterative (recommended):**
460
+ **Lancement:**
466
461
  ```bash
467
462
  /ralph-loop -r
468
463
  ```
469
-
470
- **One-shot:**
471
- ```bash
472
- /feature-full business/{app}/{module}
473
- ```
474
-
475
- Options (one-shot only):
476
- - `--phase=1` : Backend only
477
- - `--phase=2` : Frontend only
478
- - `--phase=3` : Tests only
479
- - `--phase=4` : Documentation only
480
464
  ```
481
465
 
482
466
  ---