@atlashub/smartstack-cli 1.13.2 → 1.14.0

package/templates/skills/application/templates-seed.md

@@ -1,14 +1,14 @@
 # Templates DB Seed - Application Skill
 
-> Ces templates génèrent les seeds EF Core pour les entités de navigation et leurs traductions.
+> These templates generate EF Core seeds for navigation entities and their translations.
 
 ---
 
-## RÈGLES DE GÉNÉRATION GUID
+## GUID GENERATION RULES
 
 ```csharp
-// JAMAIS de GUIDs séquentiels générés par NewGuid()
-// TOUJOURS utiliser la méthode déterministe
+// NEVER generate sequential GUIDs with NewGuid()
+// ALWAYS use the deterministic method
 
 private static Guid GenerateGuid(int index)
 {
@@ -16,8 +16,8 @@ private static Guid GenerateGuid(int index)
     return Guid.Parse($"11111111-1111-1111-1111-{index:D12}");
 }
 
-// Pour les seeds existants, continuer la séquence
-// Vérifier le dernier index utilisé dans NavigationTranslationConfiguration.cs
+// For existing seeds, continue the sequence
+// Check the last index used in NavigationTranslationConfiguration.cs
 ```
 
 ---
@@ -27,25 +27,25 @@ private static Guid GenerateGuid(int index)
 ### Navigation Entity
 
 ```csharp
-// Dans NavigationContextConfiguration.cs - HasData()
+// In NavigationContextConfiguration.cs - HasData()
 new {
     Id = Guid.Parse("$CONTEXT_GUID"),
-    Code = "$CODE",           // ex: "erp"
-    Label = "$LABEL_FR",      // ex: "ERP"
-    Description = "$DESC_FR", // ex: "Gestion d'entreprise"
-    Icon = "$ICON",           // ex: "Building2"
+    Code = "$CODE",           // e.g.: "erp"
+    Label = "$LABEL_EN",      // e.g.: "ERP"
+    Description = "$DESC_EN", // e.g.: "Enterprise management"
+    Icon = "$ICON",           // e.g.: "Building2"
     IconType = IconType.Lucide,
-    Route = "/$CODE",         // ex: "/erp"
-    DisplayOrder = $ORDER,    // ex: 4
+    Route = "/$CODE",         // e.g.: "/erp"
+    DisplayOrder = $ORDER,    // e.g.: 4
     IsActive = true,
     CreatedAt = seedDate
 }
 ```
 
-### Translations (4 langues)
+### Translations (4 languages)
 
 ```csharp
-// Dans NavigationTranslationConfiguration.cs - GetSeedData()
+// In NavigationTranslationConfiguration.cs - GetSeedData()
 // Context translations
 translations.Add(new {
     Id = GenerateGuid(index++),
@@ -92,23 +92,23 @@ translations.Add(new {
 ### Navigation Entity
 
 ```csharp
-// Dans NavigationApplicationConfiguration.cs - HasData()
+// In NavigationApplicationConfiguration.cs - HasData()
 new {
     Id = Guid.Parse("$APP_GUID"),
     ContextId = Guid.Parse("$CONTEXT_GUID"),
-    Code = "$CODE",           // ex: "sales"
-    Label = "$LABEL_FR",      // ex: "Ventes"
-    Description = "$DESC_FR", // ex: "Gestion des ventes"
-    Icon = "$ICON",           // ex: "TrendingUp"
+    Code = "$CODE",           // e.g.: "sales"
+    Label = "$LABEL_EN",      // e.g.: "Sales"
+    Description = "$DESC_EN", // e.g.: "Sales management"
+    Icon = "$ICON",           // e.g.: "TrendingUp"
     IconType = IconType.Lucide,
-    Route = "/$CONTEXT/$CODE", // ex: "/erp/sales"
+    Route = "/$CONTEXT/$CODE", // e.g.: "/erp/sales"
     DisplayOrder = $ORDER,
     IsActive = true,
     CreatedAt = seedDate
 }
 ```
 
-### Translations (4 langues)
+### Translations (4 languages)
 
 ```csharp
 // Application translations
@@ -157,23 +157,23 @@ translations.Add(new {
 ### Navigation Entity
 
 ```csharp
-// Dans NavigationModuleConfiguration.cs - HasData()
+// In NavigationModuleConfiguration.cs - HasData()
 new {
     Id = Guid.Parse("$MODULE_GUID"),
     ApplicationId = Guid.Parse("$APP_GUID"),
-    Code = "$CODE",                    // ex: "products"
-    Label = "$LABEL_FR",               // ex: "Produits"
-    Description = "$DESC_FR",          // ex: "Gestion des produits"
-    Icon = "$ICON",                    // ex: "Package"
+    Code = "$CODE",                    // e.g.: "products"
+    Label = "$LABEL_EN",               // e.g.: "Products"
+    Description = "$DESC_EN",          // e.g.: "Product management"
+    Icon = "$ICON",                    // e.g.: "Package"
     IconType = IconType.Lucide,
-    Route = "/$CONTEXT/$APP/$CODE",    // ex: "/erp/sales/products"
+    Route = "/$CONTEXT/$APP/$CODE",    // e.g.: "/erp/sales/products"
     DisplayOrder = $ORDER,
     IsActive = true,
     CreatedAt = seedDate
 }
 ```
 
-### Translations (4 langues)
+### Translations (4 languages)
 
 ```csharp
 // Module translations
@@ -222,23 +222,23 @@ translations.Add(new {
 ### Navigation Entity
 
 ```csharp
-// Dans NavigationSectionConfiguration.cs - HasData()
+// In NavigationSectionConfiguration.cs - HasData()
 new {
     Id = Guid.Parse("$SECTION_GUID"),
     ModuleId = Guid.Parse("$MODULE_GUID"),
-    Code = "$CODE",                           // ex: "inventory"
-    Label = "$LABEL_FR",                      // ex: "Inventaire"
-    Description = "$DESC_FR",                 // ex: "Gestion des stocks"
-    Icon = "$ICON",                           // ex: "Warehouse"
+    Code = "$CODE",                           // e.g.: "inventory"
+    Label = "$LABEL_EN",                      // e.g.: "Inventory"
+    Description = "$DESC_EN",                 // e.g.: "Inventory management"
+    Icon = "$ICON",                           // e.g.: "Warehouse"
     IconType = IconType.Lucide,
-    Route = "/$CONTEXT/$APP/$MODULE/$CODE",   // ex: "/erp/sales/products/inventory"
+    Route = "/$CONTEXT/$APP/$MODULE/$CODE",   // e.g.: "/erp/sales/products/inventory"
     DisplayOrder = $ORDER,
     IsActive = true,
     CreatedAt = seedDate
 }
 ```
 
-### Translations (4 langues)
+### Translations (4 languages)
 
 ```csharp
 // Section translations
@@ -287,8 +287,8 @@ translations.Add(new {
 ### Permission Entity
 
 ```csharp
-// Dans PermissionConfiguration.cs - HasData()
-// Pour chaque action CRUD + assign + execute
+// In PermissionConfiguration.cs - HasData()
+// For each CRUD action + assign + execute
 
 // Read
 new {
@@ -331,7 +331,7 @@ new {
 ### RolePermission Seed (Default Roles)
 
 ```csharp
-// Dans RolePermissionConfiguration.cs - HasData()
+// In RolePermissionConfiguration.cs - HasData()
 // SuperAdmin gets all permissions automatically (wildcard)
 
 // PlatformAdmin - if platform context
@@ -348,15 +348,15 @@ new { RoleId = Guid.Parse("...StandardUserRoleId..."), PermissionId = $PERM_READ
 
 ## TEMPLATE: SECTION PERMISSIONS SEED (Level 4)
 
-> **Usage:** Quand un Module a des sous-pages avec permissions différentes
+> **Usage:** When a Module has sub-pages with different permissions
 
 ### Permission Entity - Section Level
 
 ```csharp
-// Dans PermissionConfiguration.cs - HasData()
+// In PermissionConfiguration.cs - HasData()
 // Pattern: {context}.{application}.{module}.{section}.{action}
 
-// Déclarer le SectionId (doit correspondre à NavigationSectionConfiguration.cs)
+// Declare SectionId (must match NavigationSectionConfiguration.cs)
 var {section}SectionId = Guid.Parse("$SECTION_GUID");
 
 // Wildcard Section
@@ -413,7 +413,7 @@ new {
     Description = "Delete in $SECTION_LABEL",
     CreatedAt = seedDate
 },
-// Execute (optionnel)
+// Execute (optional)
 new {
     Id = Guid.Parse("$PERM_SECTION_EXECUTE_GUID"),
     Path = "$CONTEXT.$APP.$MODULE.$SECTION.execute",
@@ -430,15 +430,15 @@ new {
 
 ## TEMPLATE: RESOURCE PERMISSIONS SEED (Level 5)
 
-> **Usage:** Niveau le plus fin - sous-ressources avec permissions distinctes (ex: Prompts → Blocks)
+> **Usage:** Finest level - sub-resources with distinct permissions (e.g.: Prompts → Blocks)
 
 ### Permission Entity - Resource Level
 
 ```csharp
-// Dans PermissionConfiguration.cs - HasData()
+// In PermissionConfiguration.cs - HasData()
 // Pattern: {context}.{application}.{module}.{section}.{resource}.{action}
 
-// Déclarer le ResourceId (doit correspondre à NavigationResourceConfiguration.cs)
+// Declare ResourceId (must match NavigationResourceConfiguration.cs)
 var {resource}ResourceId = Guid.Parse("$RESOURCE_GUID");
 
 // Wildcard Resource
@@ -501,13 +501,13 @@ new {
 
 ## TEMPLATE: BULK OPERATIONS PERMISSIONS
 
-> **OBLIGATOIRE:** Toujours prévoir pour les modules CRUD
+> **MANDATORY:** Always provide for CRUD modules
 
 ### Permission Entity - Bulk Operations
 
 ```csharp
-// Dans PermissionConfiguration.cs - HasData()
-// Ajouter après les permissions CRUD standard
+// In PermissionConfiguration.cs - HasData()
+// Add after standard CRUD permissions
 
 // Bulk Create
 new {
@@ -568,7 +568,7 @@ new {
 
 ---
 
-## EXEMPLE COMPLET: Module "Products" dans "ERP > Sales"
+## COMPLETE EXAMPLE: "Products" Module in "ERP > Sales"
 
 ### Variables
 
@@ -594,54 +594,54 @@ $ICON = Package
 $ORDER = 1
 ```
 
-### Fichiers à modifier
+### Files to modify
 
-1. `NavigationContextConfiguration.cs` - Ajouter context ERP (si nouveau)
-2. `NavigationApplicationConfiguration.cs` - Ajouter application Sales
-3. `NavigationModuleConfiguration.cs` - Ajouter module Products
-4. `NavigationTranslationConfiguration.cs` - Ajouter 4 traductions × nombre d'entités
-5. `PermissionConfiguration.cs` - Ajouter permissions CRUD
-6. `RolePermissionConfiguration.cs` - Assigner aux rôles par défaut
+1. `NavigationContextConfiguration.cs` - Add ERP context (if new)
+2. `NavigationApplicationConfiguration.cs` - Add Sales application
+3. `NavigationModuleConfiguration.cs` - Add Products module
+4. `NavigationTranslationConfiguration.cs` - Add 4 translations × number of entities
+5. `PermissionConfiguration.cs` - Add CRUD permissions
+6. `RolePermissionConfiguration.cs` - Assign to default roles
 
 ---
 
-## CHECKLIST SEED
-
-| Vérification | Status |
-|--------------|--------|
-| ☐ GUID déterministe (pas NewGuid) | |
-| ☐ 4 langues pour chaque entité | |
-| ☐ Index translations continue la séquence existante | |
-| ☐ Route alignée avec permission path | |
-| ☐ DisplayOrder cohérent | |
-| ☐ Permissions CRUD créées (Level 3 - Module) | |
-| ☐ Permissions Section si sous-pages (Level 4) | |
-| ☐ Permissions Resource si sous-ressources (Level 5) | |
-| ☐ Permissions Bulk Operations créées | |
-| ☐ RolePermissions assignés | |
+## SEED CHECKLIST
+
+| Check | Status |
+|-------|--------|
+| ☐ Deterministic GUID (not NewGuid) | |
+| ☐ 4 languages for each entity | |
+| ☐ Index translations continue existing sequence | |
+| ☐ Route aligned with permission path | |
+| ☐ DisplayOrder consistent | |
+| ☐ CRUD permissions created (Level 3 - Module) | |
+| ☐ Section permissions if sub-pages (Level 4) | |
+| ☐ Resource permissions if sub-resources (Level 5) | |
+| ☐ Bulk Operations permissions created | |
+| ☐ RolePermissions assigned | |
 
 ---
 
-## HIÉRARCHIE DES PERMISSIONS (5 Niveaux)
+## PERMISSIONS HIERARCHY (5 Levels)
 
 ```
 Level 1: CONTEXT
 └─ Path: {context}.*
-   └─ Ex: platform.* → Accès complet au context
+   └─ E.g.: platform.* → Full context access
 
 Level 2: APPLICATION
 └─ Path: {context}.{application}.*
-   └─ Ex: platform.administration.* → Accès complet à l'app
+   └─ E.g.: platform.administration.* → Full app access
 
 Level 3: MODULE
 └─ Path: {context}.{application}.{module}.{action}
-   └─ Ex: platform.administration.users.read
+   └─ E.g.: platform.administration.users.read
 
 Level 4: SECTION
 └─ Path: {context}.{application}.{module}.{section}.{action}
-   └─ Ex: platform.administration.ai.settings.update
+   └─ E.g.: platform.administration.ai.settings.update
 
 Level 5: RESOURCE (finest granularity)
 └─ Path: {context}.{application}.{module}.{section}.{resource}.{action}
-   └─ Ex: platform.administration.ai.prompts.blocks.delete
+   └─ E.g.: platform.administration.ai.prompts.blocks.delete
 ```

package/templates/skills/business-analyse/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: business-analyse
+description: Business Analysis - Complete business analysis workflow (BABOK/IEEE 830) with progressive step loading and context refresh.
+argument-hint: "[-a] [-s] [-e] [-r <task-id>] <feature description>"
+---
+
+<objective>
+Execute systematic business analysis workflows following BABOK v3 and IEEE 830 standards.
+This skill uses progressive step loading to minimize context usage and maintain fresh context throughout the workflow.
+</objective>
+
+<quick_start>
+**Basic usage:**
+
+```bash
+/business-analyse Module de gestion des clients
+```
+
+**Recommended workflow (autonomous with save):**
+
+```bash
+/business-analyse -a -s Gestion des commandes avec workflow validation
+```
+
+**Resume a previous analysis:**
+
+```bash
+/business-analyse -r FEAT-001
+```
+
+**Flags:**
+
+- `-a` (auto): Skip confirmations
+- `-s` (save): Save outputs to `.business-analyse/`
+- `-e` (economy): No subagents, direct tool usage
+- `-r` (resume): Resume from a previous FEAT-ID
+
+See `<parameters>` for complete flag list.
+</quick_start>
+
+<parameters>
+
+<flags>
+**Enable flags (turn ON):**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-a` | `--auto` | Autonomous mode: skip confirmations, auto-approve |
+| `-s` | `--save` | Save mode: output to `.business-analyse/` (default: true) |
+| `-e` | `--economy` | Economy mode: no subagents, save tokens |
+| `-r` | `--resume` | Resume mode: continue from a previous FEAT-ID |
+| `-i` | `--interactive` | Interactive mode: configure flags via AskUserQuestion |
+
+**Disable flags (turn OFF):**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-A` | `--no-auto` | Disable auto mode |
+| `-S` | `--no-save` | Disable save mode |
+| `-E` | `--no-economy` | Disable economy mode |
+</flags>
+
+<examples>
+```bash
+# Basic usage
+/business-analyse Module gestion clients
+
+# Autonomous mode (no confirmations)
+/business-analyse -a Module gestion clients
+
+# Economy mode (save tokens)
+/business-analyse -e Module gestion clients
+
+# Resume a previous feature
+/business-analyse -r FEAT-001
+/business-analyse -r 001  # Partial match supported
+
+# Combined flags
+/business-analyse -a -e Module gestion clients
+```
+</examples>
+
+<parsing_rules>
+**Flag parsing:**
+
+1. Defaults loaded from `steps/step-00-init.md` `<defaults>` section
+2. Command-line flags override defaults
+3. Flags removed from input, remainder becomes `{feature_description}`
+4. Feature ID generated as `FEAT-NNN`
+</parsing_rules>
+
+</parameters>
+
+<output_structure>
+**When `{save_mode}` = true (default):**
+
+All outputs saved to PROJECT directory:
+```
+.business-analyse/business/{app}/modules/{module}/features/{FEAT-NNN}/
+├── 00-context.md              # Params, user request, timestamp, progress
+├── 1-discovery.md             # Phase 1: Discovery findings
+├── 2-business-requirements.md # Phase 2: BRD
+├── 3-functional-specification.md # Phase 3: FRD
+├── validation.json            # Phase 4: Validation gate
+├── 4-development-handoff.md   # Phase 5: Dev prompt
+└── tracking/
+    ├── changes/
+    ├── bugs/
+    └── hotfixes/
+```
+</output_structure>
+
+<resume_workflow>
+**Resume mode (`-r {FEAT-ID}`):**
+
+When provided, step-00 will:
+
+1. Locate the feature folder in `.business-analyse/`
+2. Read `00-context.md` to restore state
+3. Find the last completed step
+4. Continue from the next step
+</resume_workflow>
+
+<workflow>
+**Standard flow:**
+1. Parse flags and feature description
+2. If `-r`: Execute resume workflow
+3. Create output folder and 00-context.md
+4. Load step-01-discover.md -> elicitation with ULTRATHINK
+5. Load step-02-analyse.md -> BRD + business rules
+6. Load step-03-specify.md -> FRD + use cases
+7. Load step-04-validate.md -> validation gate
+8. Load step-05-handoff.md -> development prompt
+9. Load step-06-doc-html.md -> React documentation (optional)
+</workflow>
+
+<state_variables>
+**Persist throughout all steps:**
+
+| Variable                | Type    | Description                                            |
+| ----------------------- | ------- | ------------------------------------------------------ |
+| `{feature_description}` | string  | What to analyze (flags removed)                        |
+| `{feature_id}`          | string  | Unique identifier (e.g., `FEAT-001`)                   |
+| `{application_name}`    | string  | Target application name                                |
+| `{module_name}`         | string  | Target module name                                     |
+| `{context}`             | string  | Always "business" for BA                               |
+| `{auto_mode}`           | boolean | Skip confirmations                                     |
+| `{save_mode}`           | boolean | Save outputs (default: true)                           |
+| `{economy_mode}`        | boolean | No subagents, direct tool usage only                   |
+| `{output_dir}`          | string  | Full path to feature output directory                  |
+
+</state_variables>
+
+<entry_point>
+
+**FIRST ACTION:** Load `steps/step-00-init.md`
+
+</entry_point>
+
+<step_files>
+**Progressive loading - only load current step:**
+
+| Step | File                         | Model  | Purpose                                              |
+| ---- | ---------------------------- | ------ | ---------------------------------------------------- |
+| 00   | `steps/step-00-init.md`      | Haiku  | Parse flags, create structure, initialize state      |
+| 01   | `steps/step-01-discover.md`  | Opus   | Elicitation with ULTRATHINK (load questionnaire)     |
+| 02   | `steps/step-02-analyse.md`   | Sonnet | BRD + business rules formalization                   |
+| 03   | `steps/step-03-specify.md`   | Sonnet | FRD + use cases + permissions                        |
+| 04   | `steps/step-04-validate.md`  | Haiku  | Validation gate (APPROVED/REJECTED)                  |
+| 05   | `steps/step-05-handoff.md`   | Opus   | Development prompt generation                        |
+| 06   | `steps/step-06-doc-html.md`  | Sonnet | React documentation (optional)                       |
+
+</step_files>
+
+<questionnaire_files>
+**Progressive questionnaire loading (step-01 only):**
+
+Load ONLY relevant categories based on feature type:
+
+| Category | File                                | When to load |
+| -------- | ----------------------------------- | ------------ |
+| 01       | `questionnaire/01-context.md`       | Always       |
+| 02       | `questionnaire/02-stakeholders.md`  | Always       |
+| 03       | `questionnaire/03-scope.md`         | Always       |
+| 04       | `questionnaire/04-data.md`          | If data-centric |
+| 05       | `questionnaire/05-integrations.md`  | If integrations |
+| 06       | `questionnaire/06-security.md`      | Always (minimal) |
+| 07       | `questionnaire/07-ui.md`            | If UI-centric |
+| 08       | `questionnaire/08-performance.md`   | If performance-critical |
+| 09       | `questionnaire/09-constraints.md`   | If constraints exist |
+| 10       | `questionnaire/10-documentation.md` | If doc required |
+
+</questionnaire_files>
+
+<template_files>
+**Progressive template loading:**
+
+| Template | File                          | Used in step |
+| -------- | ----------------------------- | ------------ |
+| discovery | `templates/frd-discovery.md` | 01           |
+| brd       | `templates/frd-brd.md`       | 02           |
+| frd       | `templates/frd-spec.md`      | 03           |
+| handoff   | `templates/frd-handoff.md`   | 05           |
+
+</template_files>
+
+<execution_rules>
+
+- **Load one step at a time** - Only load the current step file
+- **ULTRATHINK** for phases 01, 02, 03, 05 (critical thinking)
+- **Persist state variables** across all steps via 00-context.md
+- **Follow next_step directive** at end of each step
+- **Save outputs** immediately after each phase
+- **Use parallel agents** for exploration (unless economy_mode)
+- **Context: business only** - Reject platform/personal/system contexts
+</execution_rules>
+
+<success_criteria>
+
+- Each step loaded progressively (max 300-400 lines/step)
+- All outputs saved to feature folder
+- Validation gate passed (APPROVED)
+- Development handoff ready for `/implement`
+- Clear completion summary with next steps
+</success_criteria>