@atlashub/smartstack-cli 1.13.2 → 1.14.0

package/templates/commands/business-analyse/5-validate.md

@@ -1,132 +0,0 @@
----
-description: Phase 5 - User validation of specifications
-agent: ba-validate
-model: haiku
----
-
-# Phase 5: Validation Utilisateur
-
-> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
-
----
-
-## Prérequis
-
-```bash
-find_feature_dir "$1" || exit 1
-[ -f "$FEATURE_DIR/3-functional-specification.md" ] || { echo "❌ FRD requis"; exit 1; }
-```
-
----
-
-## GATE VALIDATION
-
-Cette phase BLOQUE le passage au handoff si non approuvé.
-
-Le stakeholder DOIT valider:
-- Cas d'utilisation complets
-- Wireframes conformes
-- Règles métier correctes
-- Permissions appropriées
-
----
-
-## Demande de validation
-
-```javascript
-AskUserQuestion({
-  questions: [
-    {
-      question: "Les cas d'utilisation couvrent-ils tous les besoins?",
-      header: "Use Cases",
-      options: [
-        { label: "Oui, complets", description: "Tous les UC validés" },
-        { label: "Partiellement", description: "UC incomplets" },
-        { label: "Non", description: "Révision majeure" }
-      ],
-      multiSelect: false
-    },
-    {
-      question: "Les wireframes correspondent aux attentes?",
-      header: "UI/UX",
-      options: [
-        { label: "Oui, validés", description: "Écrans conformes" },
-        { label: "Ajustements mineurs", description: "Modifications légères" },
-        { label: "Non", description: "Refonte nécessaire" }
-      ],
-      multiSelect: false
-    },
-    {
-      question: "Les règles métier (BR-XXX) sont correctes?",
-      header: "Règles",
-      options: [
-        { label: "Oui, correctes", description: "Toutes validées" },
-        { label: "Corrections mineures", description: "Quelques ajustements" },
-        { label: "Non", description: "Règles incorrectes" }
-      ],
-      multiSelect: false
-    },
-    {
-      question: "Les permissions sont appropriées?",
-      header: "Permissions",
-      options: [
-        { label: "Oui, validées", description: "Matrice OK" },
-        { label: "À ajuster", description: "Rôles à modifier" },
-        { label: "Non", description: "À revoir" }
-      ],
-      multiSelect: false
-    }
-  ]
-})
-```
-
----
-
-## Traitement décision
-
-### Si APPROUVÉ (toutes réponses positives)
-
-```json
-{
-  "featureId": "{FEATURE_ID}",
-  "status": "APPROVED",
-  "documents": {
-    "discovery": { "version": "1.0", "status": "approved" },
-    "brd": { "version": "1.0", "status": "approved" },
-    "frd": { "version": "1.0", "status": "approved" }
-  },
-  "nextStep": "handoff"
-}
-```
-
-### Si REJETÉ
-
-```json
-{
-  "featureId": "{FEATURE_ID}",
-  "status": "REJECTED",
-  "rejectionReasons": { "useCases": "", "wireframes": "", "businessRules": "", "permissions": "" },
-  "nextStep": "revise"
-}
-```
-
----
-
-## Versioning post-validation
-
-| Situation | Action | Nouvelle version |
-|-----------|--------|------------------|
-| Approuvé | Verrouiller | 1.0 (locked) |
-| Rejet mineur | Réviser specify | 1.1 |
-| Rejet majeur | Réviser analyse | 2.0 |
-
----
-
-## Résumé
-
-```
-VALIDATE - {FEATURE_ID}
-├── Status: {APPROVED/REJECTED}
-├── Documents: {N} validés
-└── Prochain: /business-analyse:6-handoff {FEATURE_ID}
-```

package/templates/commands/business-analyse/6-handoff.md

@@ -1,157 +0,0 @@
----
-description: Phase 6 - Development prompt generation (ULTRATHINK)
-agent: ba-handoff
-model: opus
----
-
-# Phase 6: Handoff Développement
-
-> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
-
----
-
-## Prérequis
-
-```bash
-find_feature_dir "$1" || exit 1
-STATUS=$(grep -oP '"decision":\s*"\K[^"]+' "$FEATURE_DIR/validation.json")
-[ "$STATUS" != "APPROVED" ] && { echo "❌ Validation requise"; exit 1; }
-```
-
----
-
-## Objectif
-
-Générer un prompt AUTONOME permettant d'implémenter SANS questions:
-- Instructions EXPLORE pour patterns existants
-- Specs détaillées
-- Permissions explicites
-- Checklist validation
-
-**Usage:** `/implement {FEATURE_ID}`
-
----
-
-## Template 4-development-handoff.md
-
-```markdown
-# Handoff - {FEATURE_ID}
-
-> **Module:** business/{app}/{module}
-> **Implémentation:** /implement {FEATURE_ID}
-
-## 1. Contexte
-| Feature ID | {FEATURE_ID} |
-| Permission base | business.{app}.{module} |
-| Complexité | {Simple/Moyenne/Complexe} |
-
-## 2. [EXPLORE] Patterns
-### Backend
-- src/SmartStack.Domain/Entities/
-- src/SmartStack.Application/Features/
-- src/SmartStack.Infrastructure/Persistence/Configurations/
-- src/SmartStack.Api/Controllers/
-
-### Frontend
-- web/smartstack-web/src/pages/business/
-- web/smartstack-web/src/services/api/
-- web/smartstack-web/src/i18n/locales/
-
-## 3. Entités
-| Attribut | Description | Requis | Validation | BR |
-
-## 4. Permissions
-### Paths
-business.{app}.{module}.read|create|update|delete
-
-### Matrice
-| Permission | Admin | Manager | User | ReadOnly |
-
-### Seed (PermissionConfiguration.cs)
-GUIDs aléatoires obligatoires
-
-## 5. Endpoints API
-| Endpoint | Method | Permission | Response |
-
-### DTOs
-| Champ | Type | Requis | Validation |
-
-## 6. Règles métier
-| BR-ID | Règle | Où implémenter |
-
-## 7. Pages Frontend
-### Liste - Route: /business/{app}/{module}
-Composants: Header, Filtres, DataTable, Modal
-
-### Permissions UI
-| Élément | Permission | Si absent |
-
-## 8. i18n (4 langues)
-| Fichier | Clés |
-| fr/{module}.json | title, fields.*, actions.*, messages.* |
-| en, it, de | idem |
-
-## 9. Intégrations SmartStack
-| Type | Requis | Skill | Quand |
-| Notifications | {oui/non} | /notification add | Après service |
-| Workflows | {oui/non} | /workflow create | Après triggers |
-| IA | {oui/non} | /ai-prompt create | Pendant service |
-
-## 10. Tests
-### Unitaires
-- [ ] Entity validation
-- [ ] Validators
-
-### Intégration
-- [ ] GET 200, POST 201, PUT 200, DELETE 204
-- [ ] 403 sans permission
-
-## 11. Checklist
-### Backend
-- [ ] Entity + Config EF Core + Migration
-- [ ] Commands/Queries + Validators
-- [ ] Controller + Permissions
-- [ ] Build OK
-
-### Frontend
-- [ ] Pages + Service API + i18n 4 langues
-- [ ] Routes + Build OK
-
-### Intégrations
-- [ ] Notifications/Workflows/IA si requis
-
-## 12. Commande
-/implement {FEATURE_ID}
-/implement {FEATURE_ID} --phase=1  # Backend
-/implement {FEATURE_ID} --phase=2  # Frontend
-```
-
----
-
-## Checklist complétude
-
-- [ ] Contexte complet
-- [ ] EXPLORE patterns listés
-- [ ] Entités avec attributs complets
-- [ ] Permissions paths + matrice + seed
-- [ ] Endpoints + DTOs
-- [ ] Règles métier référencées
-- [ ] Pages + permissions UI
-- [ ] i18n 4 langues
-- [ ] Intégrations Oui/Non
-- [ ] Tests listés
-- [ ] Aucun "TBD" ou "?"
-
----
-
-## Résumé
-
-```
-HANDOFF - {FEATURE_ID}
-├── Entités: {N}
-├── Endpoints: {N}
-├── Permissions: {N}
-├── Pages: {N}
-├── Intégrations: {liste}
-└── Prochain: /implement {FEATURE_ID}
-```

package/templates/commands/business-analyse/7-doc-html.md

@@ -1,103 +0,0 @@
----
-description: Phase 7 - Generate HTML documentation (React components) integrated in module
-agent: ba-doc-html
-model: sonnet
----
-
-# Phase 7: Documentation HTML (React)
-
-> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
-> **Templates React:** [templates-react.md](../skills/business-analyse/templates-react.md)
-
----
-
-## Objectif
-
-Documentation FRD intégrée comme ONGLET dans chaque module business:
-
-```
-/business/{app}/{module}/documentation → 📄 Documentation FRD
-```
-
----
-
-## Prérequis
-
-```bash
-find_feature_dir "$1" || exit 1
-[ -d "$WEB_DIR/pages/business/$APPLICATION/$MODULE" ] || {
-  echo "⚠️ Module non implémenté - /implement $FEATURE_ID d'abord"
-  exit 1
-}
-```
-
----
-
-## Context7 obligatoire
-
-```
-use context7 with /facebook/react and /i18next/react-i18next
-to generate DocumentationPage component following SmartStack patterns
-```
-
-Libraries: `/facebook/react`, `/i18next/react-i18next`, `/remix-run/react-router`, `/lucide-icons/lucide-react`
-
----
-
-## Structure DocumentationPage.tsx
-
-```tsx
-// pages/business/{app}/{module}/DocumentationPage.tsx
-const frdData = {
-  featureId: '{FEATURE_ID}',
-  version: '1.0',
-  overview: { description: '', objectives: [] },
-  useCases: [{ id: 'UC-001', title: '', actor: '', steps: [] }],
-  businessRules: [{ id: 'BR-001', title: '', category: '', priority: 'Must' }],
-  permissions: [{ key: 'business.{app}.{module}.read', roles: [] }],
-  endpoints: [{ method: 'GET', path: '/api/business/{app}/{module}', permission: '' }]
-};
-
-// Sections: Overview, Use Cases, Business Rules, Permissions, API Endpoints
-// Sidebar: Table of Contents (sticky)
-// Back link: "/business/{app}/{module}"
-```
-
----
-
-## i18n (4 langues)
-
-| Fichier | Clés |
-|---------|------|
-| `{lang}/{app}-{module}.json` | `documentation.title`, `documentation.sections.*`, `documentation.labels.*` |
-
----
-
-## Mise à jour routing
-
-```tsx
-// App.tsx - Ajouter route
-<Route path="{app}/{module}/documentation" element={<DocumentationPage />} />
-```
-
----
-
-## Checklist
-
-- [ ] DocumentationPage.tsx généré avec Context7
-- [ ] Données FRD extraites et intégrées
-- [ ] i18n 4 langues dans namespace module
-- [ ] Route ajoutée dans App.tsx
-- [ ] Onglet Documentation dans navigation module
-
----
-
-## Résumé
-
-```
-DOC-HTML - {FEATURE_ID}
-├── Page: pages/business/{app}/{module}/DocumentationPage.tsx
-├── i18n: 4 langues (fr, en, it, de)
-├── Route: /business/{app}/{module}/documentation
-└── Context7: react, react-i18next, react-router, lucide-react
-```

package/templates/commands/business-analyse/_shared.md

@@ -1,176 +0,0 @@
-# Business Analyse - Fonctions Partagées
-
-> **Ref:** Ce fichier contient les fonctions communes à toutes les phases BA.
-
----
-
-## Validation Contexte Business
-
-```bash
-validate_business_context() {
-  local CONTEXT="$1"
-  [[ "$CONTEXT" =~ ^(platform|personal|system)$ ]] && {
-    echo "❌ ERREUR: BA réservée au contexte 'business'. Contact: support@atlshub.ch"
-    return 1
-  }
-  return 0
-}
-```
-
----
-
-## Feature Directory
-
-```bash
-find_feature_dir() {
-  local FEATURE_ID="$1"
-  FEATURE_DIR=$(find .business-analyse -type d -name "${FEATURE_ID}*" 2>/dev/null | head -1)
-  [ -z "$FEATURE_DIR" ] && { echo "❌ Feature $FEATURE_ID non trouvée"; return 1; }
-  APPLICATION=$(echo "$FEATURE_DIR" | grep -oP 'business/\K[^/]+')
-  MODULE=$(echo "$FEATURE_DIR" | grep -oP 'modules/\K[^/]+')
-  export FEATURE_DIR APPLICATION MODULE
-}
-```
-
----
-
-## Génération Feature ID
-
-```bash
-generate_feature_id() {
-  local LAST_ID=$(grep -oP '"lastFeatureId":\s*\K\d+' .business-analyse/config.json 2>/dev/null || echo "0")
-  printf "FEAT-%03d" $((LAST_ID + 1))
-}
-```
-
----
-
-## Modèles par Phase
-
-| Phase | Modèle | Raison |
-|-------|--------|--------|
-| 1-init | Haiku | Setup structure |
-| 2-discover | **Opus** | Elicitation ULTRATHINK |
-| 3-analyse | Sonnet | Modélisation BRD |
-| 4-specify | Sonnet | FRD + Use Cases |
-| 5-validate | Haiku | Gate oui/non |
-| 6-handoff | **Opus** | Prompt zéro ambiguïté |
-| 7-doc-html | Sonnet | React + Context7 |
-
----
-
-## ULTRATHINK
-
-Mode comportemental pour phases critiques (2, 3, 4, 6):
-- Considérer TOUS les edge cases
-- Challenger CHAQUE hypothèse
-- Anticiper besoins NON exprimés
-- Valider complétude avant output
-
-**NE PAS appeler** comme skill/tool.
-
----
-
-## Context7 (Phase 7)
-
-```
-"use context7 with /facebook/react and /i18next/react-i18next
- to generate {component} following SmartStack patterns"
-```
-
-Libraries: `/facebook/react`, `/i18next/react-i18next`, `/remix-run/react-router`, `/lucide-icons/lucide-react`
-
----
-
-## Permission Path
-
-Format: `business.{application}.{module}.{action}`
-
-| Action | Permission |
-|--------|------------|
-| Lecture | `.read` |
-| Création | `.create` |
-| Modification | `.update` |
-| Suppression | `.delete` |
-| Export | `.export` |
-| Import | `.import` |
-| Admin | `.admin` |
-
----
-
-## i18n (4 langues obligatoires)
-
-| Langue | Fichier |
-|--------|---------|
-| FR | `fr/{app}-{module}.json` |
-| EN | `en/{app}-{module}.json` |
-| IT | `it/{app}-{module}.json` |
-| DE | `de/{app}-{module}.json` |
-
----
-
-## Output Paths
-
-| Type | Chemin |
-|------|--------|
-| Documentation | `web/smartstack-web/src/pages/business/{app}/{module}/DocumentationPage.tsx` |
-| i18n | `web/smartstack-web/src/i18n/locales/{lang}/` |
-| Route | `/business/{app}/{module}/documentation` |
-
----
-
-## Résumé Standard
-
-```
-{PHASE} - {FEATURE_ID}
-├── Status: {Complete/En cours}
-├── Output: {fichiers créés}
-└── Prochain: {commande suivante}
-```
-
----
-
-## Config Template
-
-```json
-{
-  "project": "{Name}",
-  "lastFeatureId": 0,
-  "context": "business",
-  "standards": ["BABOK-v3", "IEEE-830"],
-  "contact": "support@atlshub.ch"
-}
-```
-
----
-
-## Structure Feature
-
-```
-.business-analyse/business/{app}/modules/{module}/features/{FEAT-XXX}/
-├── 1-discovery.md
-├── 2-business-requirements.md
-├── 3-functional-specification.md
-├── 4-development-handoff.md
-├── validation.json
-└── tracking/
-    ├── changes/
-    ├── bugs/
-    └── hotfixes/
-```
-
----
-
-## Ralph Loop (optionnel)
-
-Fichiers créés par phase Ralph:
-- `prd.json` - Tracking tâches (`"passes": true/false`)
-- `progress.txt` - Mémoire inter-itérations
-
-Signal fin: `<promise>COMPLETE</promise>`
-
----
-
-## Support
-
-Contact: **support@atlshub.ch**

package/templates/commands/business-analyse/bug.md

@@ -1,118 +0,0 @@
----
-description: Bug resolution documentation and specification (ULTRATHINK)
-agent: ba-bug
-model: sonnet
----
-
-# Documentation Bug
-
-> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
-> **Output:** `.business-analyse/.../tracking/bugs/BUG-XXX.md`
-
----
-
-## Quand utiliser
-
-| ✅ Utiliser | ❌ Ne pas utiliser |
-|-------------|-------------------|
-| Bug post-implémentation | Hotfix urgent → `/business-analyse:hotfix` |
-| Analyse root cause | Changement scope → `/business-analyse:change-request` |
-| Traçabilité specs |  |
-
----
-
-## Collecte informations
-
-```javascript
-AskUserQuestion({
-  questions: [
-    {
-      question: "Quelle feature est impactée?",
-      header: "Feature",
-      options: [
-        { label: "Feature existante", description: "Bug sur feature documentée" },
-        { label: "Nouvelle", description: "Bug sur code non documenté" }
-      ],
-      multiSelect: false
-    },
-    {
-      question: "Sévérité du bug?",
-      header: "Sévérité",
-      options: [
-        { label: "Critique", description: "Bloque utilisation, perte données" },
-        { label: "Majeur", description: "Fonctionnalité principale impactée" },
-        { label: "Mineur", description: "Workaround possible" },
-        { label: "Cosmétique", description: "UI/UX, pas d'impact fonctionnel" }
-      ],
-      multiSelect: false
-    },
-    {
-      question: "Bug reproductible?",
-      header: "Repro",
-      options: [
-        { label: "Toujours", description: "100%" },
-        { label: "Souvent", description: ">50%" },
-        { label: "Parfois", description: "<50%" },
-        { label: "Rarement", description: "Difficile" }
-      ],
-      multiSelect: false
-    }
-  ]
-})
-```
-
----
-
-## Analyse Root Cause (5 Whys)
-
-| # | Question | Réponse |
-|---|----------|---------|
-| 1 | Pourquoi le bug se produit? | {réponse} |
-| 2 | Pourquoi {réponse 1}? | {réponse} |
-| 3 | Pourquoi {réponse 2}? | {réponse} |
-| 4 | Pourquoi {réponse 3}? | {réponse} |
-| 5 | Pourquoi {réponse 4}? | **ROOT CAUSE** |
-
----
-
-## Template BUG-XXX.md
-
-```markdown
-# {BUG_ID} - {Title}
-
-> **Feature:** {FEATURE_ID} | **Sévérité:** {X} | **Status:** Open
-
-## 1. Description
-### Observé vs Attendu
-
-## 2. Reproduction
-### Prérequis | Étapes | Reproductibilité
-
-## 3. Analyse
-### Root Cause (5 Whys)
-### Specs impactées (BR/FR/UC)
-### Code impacté
-
-## 4. Solution
-### Correction | Fichiers | Tests Gherkin
-
-## 5. Prompt correction
-CONTEXTE: Bug {BUG_ID}
-ROOT CAUSE: {cause}
-CORRECTION: {description}
-FICHIERS: {liste}
-VALIDATION: {scénario Gherkin}
-```
-
----
-
-## Résumé
-
-```
-BUG - {BUG_ID}
-├── Feature: {FEATURE_ID}
-├── Sévérité: {X}
-├── Root Cause: {résumé}
-├── Specs: BR-XXX, FR-XXX, UC-XXX
-└── Correction: /business-analyse:hotfix {BUG_ID}
-```