@atlashub/smartstack-cli 1.13.1 → 1.14.0

package/templates/commands/business-analyse/change-request.md

@@ -1,144 +0,0 @@
----
-description: Phase 10 - Change Request - Formal specification change during development
-agent: ba-change-request
-model: sonnet
----
-
-# Change Request - Modification Post-Handoff
-
-> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
-> **Output:** `.business-analyse/.../tracking/changes/CR-FEAT-XXX-NNN.md`
-
----
-
-## Quand utiliser
-
-Utiliser APRÈS validation (phase 5) ou handoff (phase 6) quand:
-- Modification scope demandée par stakeholder
-- Nouvelle exigence découverte
-- Cas d'usage manquant identifié
-- Règle métier à modifier
-
----
-
-## Collecte changement
-
-```javascript
-AskUserQuestion({
-  questions: [
-    {
-      question: "Type de changement?",
-      header: "Type",
-      options: [
-        { label: "Nouvelle fonctionnalité", description: "Ajouter nouveau" },
-        { label: "Modification existant", description: "Changer comportement" },
-        { label: "Suppression", description: "Retirer fonctionnalité" },
-        { label: "Clarification", description: "Préciser spec ambiguë" }
-      ],
-      multiSelect: false
-    },
-    {
-      question: "Priorité?",
-      header: "Priorité",
-      options: [
-        { label: "Critique", description: "Bloque release" },
-        { label: "Haute", description: "Important MVP" },
-        { label: "Moyenne", description: "Souhaitable" },
-        { label: "Basse", description: "Nice-to-have" }
-      ],
-      multiSelect: false
-    },
-    {
-      question: "Approuvé par sponsor?",
-      header: "Approbation",
-      options: [
-        { label: "Oui", description: "Sponsor validé" },
-        { label: "En attente", description: "Discussion en cours" },
-        { label: "À soumettre", description: "Pas encore discuté" }
-      ],
-      multiSelect: false
-    }
-  ]
-})
-```
-
----
-
-## Analyse d'impact
-
-### Matrice documents
-
-| Document | Impact | Modification |
-|----------|--------|--------------|
-| Discovery | {Aucun/Mineur/Majeur} | {description} |
-| BRD | {Aucun/Mineur/Majeur} | {description} |
-| FRD | {Aucun/Mineur/Majeur} | {description} |
-| Handoff | {Aucun/Mineur/Majeur} | {description} |
-
-### Impact code (si implémenté)
-
-| Couche | Fichiers | Modification |
-|--------|----------|--------------|
-| Domain | {fichiers} | {ajouter/modifier/supprimer} |
-| Application | {fichiers} | {ajouter/modifier/supprimer} |
-| API | {fichiers} | {ajouter/modifier/supprimer} |
-| Frontend | {fichiers} | {ajouter/modifier/supprimer} |
-
----
-
-## Template CR-FEAT-XXX-NNN.md
-
-```markdown
-# {CR_ID} - Change Request
-
-> **Feature:** {FEATURE_ID} | **Type:** {X} | **Priorité:** {X} | **Status:** {X}
-
-## 1. Changement
-### Description | Justification | Demandeur
-
-## 2. Impact
-### Documents impactés | Specs (BR/FR/UC) | Code
-
-## 3. Effort
-| Composant | Effort | Risque |
-| Specs | {h} | {X} |
-| Backend | {h} | {X} |
-| Frontend | {h} | {X} |
-
-## 4. Décision
-### Recommandation | Justification | Conditions
-
-## 5. Approbation
-| Rôle | Décision | Date |
-
-## 6. Prompt modification (si approuvé)
-CHANGE REQUEST: {CR_ID}
-CHANGEMENT: {description}
-FICHIERS: {liste}
-VALIDATION: {critères}
-```
-
----
-
-## Actions post-approbation
-
-| Action | Commande |
-|--------|----------|
-| Implémentation immédiate | Générer prompt |
-| Planifier | Ajouter backlog |
-| Specs seulement | Modifier documents |
-
-**Versioning:** 1.0 → 1.1 (mineur) / 1.0 → 2.0 (majeur)
-
----
-
-## Résumé
-
-```
-CR - {CR_ID}
-├── Feature: {FEATURE_ID}
-├── Type: {X}
-├── Impact: {N} documents, {N} fichiers
-├── Effort: {N} heures
-└── Status: {En attente/Approuvé/Rejeté}
-```

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

@@ -1,116 +0,0 @@
----
-description: Phase 9 - Hotfix/Bugfix - Lightweight urgent fix documentation
-agent: ba-hotfix
-model: haiku
----
-
-# Hotfix - Correction Urgente
-
-> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
-> **Output:** `.business-analyse/tracking/hotfixes/HF-YYYYMMDD-NNN.md`
-
----
-
-## Quand utiliser
-
-| ✅ Utiliser | ❌ Ne pas utiliser |
-|-------------|-------------------|
-| Bug bloquant production | Bug complexe → `/business-analyse:bug` |
-| Correction simple, évidente | Changement fonctionnalité → `/business-analyse:change-request` |
-| Pas de changement scope | Nouvelle feature → workflow complet |
-
----
-
-## Collecte rapide
-
-```javascript
-AskUserQuestion({
-  questions: [
-    {
-      question: "Quel est le problème?",
-      header: "Bug",
-      options: [
-        { label: "Crash/Erreur 500", description: "Application plante" },
-        { label: "Données incorrectes", description: "Calcul ou affichage erroné" },
-        { label: "Permission/Accès", description: "Problème autorisation" },
-        { label: "UI bloquée", description: "Interface non responsive" }
-      ],
-      multiSelect: false
-    },
-    {
-      question: "Où se trouve le bug?",
-      header: "Location",
-      options: [
-        { label: "Backend API", description: "Controller, Service" },
-        { label: "Frontend", description: "Page, Composant" },
-        { label: "Database", description: "Migration, Query" },
-        { label: "Config", description: "appsettings, env" }
-      ],
-      multiSelect: false
-    }
-  ]
-})
-```
-
----
-
-## Template HF-YYYYMMDD-NNN.md
-
-```markdown
-# {HF_ID} - Hotfix
-
-> **Date:** {YYYY-MM-DD HH:MM} | **Sévérité:** Critique | **Status:** En cours
-
-## Bug
-**Symptôme:** {description courte}
-**Impact:** {qui est bloqué}
-
-## Cause
-**Fichier:** `{path}` | **Ligne:** ~{N}
-**Problème:** {description technique}
-
-## Correction
-```{language}
-// AVANT
-{code incorrect}
-// APRÈS
-{code corrigé}
-```
-
-## Validation
-- [ ] Fix appliqué
-- [ ] Test manuel OK
-- [ ] Déployé
-```
-
----
-
-## Prompt correction
-
-```
-HOTFIX URGENT - {HF_ID}
-PROBLÈME: {symptôme}
-FICHIER: {path}
-CORRECTION: {description}
-VALIDATION: {comportement attendu}
-⚠️ Commit: "hotfix({module}): {HF_ID} - {description}"
-```
-
----
-
-## Post-hotfix
-
-1. Marquer résolu dans .md
-2. Si analyse approfondie nécessaire: `/business-analyse:bug {FEATURE_ID}`
-3. Ajouter test régression
-
----
-
-## Résumé
-
-```
-HOTFIX - {HF_ID}
-├── Sévérité: Critique
-├── Location: {Backend/Frontend/DB/Config}
-└── Commit: hotfix({module}): {HF_ID}
-```

package/templates/commands/business-analyse.md

@@ -1,121 +0,0 @@
----
-description: Business Analysis - Complete business analysis workflow (BABOK/IEEE 830)
-argument-hint: "<description du besoin>"
----
-
-# Business Analysis - Expert Workflow
-
-> **Ref:** Fonctions communes dans [_shared.md](business-analyse/_shared.md)
-
-Senior BA expert. Produce specs, NOT code.
-
----
-
-## Mode Automatique (Recommandé)
-
-```bash
-/business-analyse "Je veux gérer les contacts clients avec import/export"
-```
-
-Orchestre: MCP check → Contexte → Phases 1-7 → Implementation → Documentation HTML
-
----
-
-## Workflow 7 Phases
-
-```
-INIT → DISCOVER → ANALYSE → SPECIFY → VALIDATE → HANDOFF → DOC-HTML
- │        │          │         │          │          │         │
- v        v          v         v          v          v         v
-Setup  Discovery   BRD.md    FRD.md   Approval   Prompt    React
-Haiku    Opus      Sonnet   Sonnet    Haiku      Opus     Sonnet
-```
-
----
-
-## Commandes
-
-| Phase | Commande | Modèle | Output |
-|-------|----------|--------|--------|
-| AUTO | `/business-analyse` | opus | Feature complète |
-| 0 | `:0-orchestrate` | opus | context.json, prd.json |
-| 1 | `:1-init` | haiku | Structure + config.json |
-| 2 | `:2-discover` | opus | 1-discovery.md |
-| 3 | `:3-analyse` | sonnet | 2-brd.md |
-| 4 | `:4-specify` | sonnet | 3-frd.md |
-| 5 | `:5-validate` | haiku | validation.json |
-| 6 | `:6-handoff` | opus | 4-handoff.md |
-| 7 | `:7-doc-html` | sonnet | DocumentationPage.tsx |
-| + | `:bug` | sonnet | BUG-XXX.md |
-| ⚡ | `:hotfix` | haiku | HF-XXX.md |
-| 🔄 | `:change-request` | sonnet | CR-XXX.md |
-
----
-
-## Restriction Contexte
-
-**BUSINESS uniquement** - Refuser platform/personal/system
-
-Permission path: `business.{application}.{module}.{action}`
-
----
-
-## Règles Absolues
-
-1. **JAMAIS de code** dans les specs (tables, diagrammes textuels uniquement)
-2. **ULTRATHINK** obligatoire phases 2, 3, 4, 6
-3. **Validation Phase 5** obligatoire avant handoff
-4. **NOK → ANALYSE** (réviser si rejeté)
-5. **Context7** obligatoire pour génération React (phase 7)
-6. **4 langues i18n** (FR, EN, IT, DE)
-
----
-
-## Feature ID Format
-
-- Feature: `FEAT-XXX`
-- Business Rule: `BR-XXX`
-- Functional Req: `FR-XXX`
-- Use Case: `UC-XXX`
-- Bug: `BUG-XXX`
-- Hotfix: `HF-YYYYMMDD-NNN`
-- Change Request: `CR-FEAT-XXX-N`
-
----
-
-## Quick Start
-
-```bash
-# Mode automatique
-/business-analyse "Description du besoin"
-
-# Mode manuel
-/business-analyse:1-init
-/business-analyse:2-discover {app} {module} "Description"
-/business-analyse:3-analyse FEAT-001
-/business-analyse:4-specify FEAT-001
-/business-analyse:5-validate FEAT-001
-/business-analyse:6-handoff FEAT-001
-/implement FEAT-001
-/business-analyse:7-doc-html FEAT-001
-```
-
----
-
-## Post-Implementation
-
-```bash
-/business-analyse:bug FEAT-001           # Bug découvert
-/business-analyse:hotfix                  # Fix urgent
-/business-analyse:change-request FEAT-001 # Changement scope
-```
-
----
-
-## Exécution Auto
-
-```javascript
-if (ARGUMENTS && ARGUMENTS.trim().length > 0) {
-  execute("/business-analyse:0-orchestrate " + ARGUMENTS);
-}
-```

package/templates/commands/controller/create.md

@@ -1,216 +0,0 @@
-# /controller:create - Génération Controller API SmartStack
-
-> **Synergie Skill/Commande:**
-> - **Skill** (`.claude/skills/controller/`) → Invocation automatique par Claude
-> - **Commande** (`/controller:create`) → Invocation manuelle par l'utilisateur
-> - Templates partagés dans `.claude/skills/controller/templates.md`
-
----
-
-## ARGUMENTS
-
-```
-/controller:create <area> <module> [entity]
-```
-
-| Variable | Extraction | Valeurs |
-|----------|------------|---------|
-| `$AREA` | Premier mot | `Admin`, `Support`, `Business`, `User`, `Auth` |
-| `$MODULE` | Deuxième mot | Nom du module (PascalCase) |
-| `$ENTITY` | Troisième mot (optionnel) | Nom de l'entité Domain (défaut = singulier de $MODULE) |
-
-**Exemples:**
-```
-/controller:create Admin Users
-/controller:create Support Tickets Ticket
-/controller:create Support Sla SlaDefinition
-```
-
----
-
-## RÈGLES ABSOLUES
-
-1. **TOUJOURS** utiliser `[RequirePermission(Permissions.*)]` - jamais de strings
-2. **TOUJOURS** ajouter `[ProducesResponseType]` pour chaque status possible
-3. **TOUJOURS** logger les opérations (Info pour CRUD, Warning pour Delete/Sensitive)
-4. **TOUJOURS** protéger les comptes système (UserType.System/LocalAdmin)
-5. **JAMAIS** de SQL direct - utiliser EF Core
-6. **JAMAIS** d'endpoint sans permission (sauf [AllowAnonymous] pour auth)
-
----
-
-## WORKFLOW
-
-### ÉTAPE 1: PARSING DES ARGUMENTS
-
-```
-EXTRAIRE $AREA = premier mot des arguments (PascalCase)
-EXTRAIRE $MODULE = deuxième mot des arguments (PascalCase)
-EXTRAIRE $ENTITY = troisième mot OU singulier de $MODULE
-
-SI $AREA absent → AskUserQuestion (options: Admin, Support, Business, User, Auth)
-SI $MODULE absent → AskUserQuestion (texte libre)
-```
-
-### ÉTAPE 2: ANALYSE EXISTANTE
-
-| Action | Commande |
-|--------|----------|
-| Entity Domain | `Glob "Domain/**/{Entity}.cs"` |
-| Permissions existantes | `Read Permissions.cs` |
-| DbContext DbSet | `Grep "{Entity}s" ApplicationDbContext.cs` |
-| Controller existant | `Glob "Controllers/{Area}/{Module}Controller.cs"` |
-
-### ÉTAPE 3: CONFIRMATION UTILISATEUR
-
-```typescript
-AskUserQuestion({
-  questions: [
-    {
-      header: "Type",
-      question: "Quel type de controller ?",
-      options: [
-        { label: "CRUD Complet (Recommended)", description: "GET list, GET by ID, POST, PUT, PATCH, DELETE" },
-        { label: "Read-Only", description: "GET list, GET by ID uniquement" },
-        { label: "Custom", description: "Actions spécifiques à définir" }
-      ]
-    },
-    {
-      header: "Postman",
-      question: "Générer les tests Postman ?",
-      options: [
-        { label: "Oui (Recommended)", description: "Ajoute tests dans SmartStack.Security.postman_collection.json" },
-        { label: "Non", description: "Controller uniquement" }
-      ]
-    }
-  ]
-})
-```
-
-### ÉTAPE 4: VALIDATION SÉCURITÉ
-
-**Vérifications obligatoires avant génération:**
-
-1. ✅ Permission path existe ou sera créée
-2. ✅ Format permission: `context.application.module.action`
-3. ✅ DbSet existe dans ApplicationDbContext
-4. ✅ Entity a les méthodes Create/Update nécessaires
-
-### ÉTAPE 5: GÉNÉRATION
-
-| Fichier | Chemin | Action |
-|---------|--------|--------|
-| Controller | `src/SmartStack.Api/Controllers/{Area}/{Module}Controller.cs` | CREATE |
-| Permissions | `src/SmartStack.Application/Common/Authorization/Permissions.cs` | UPDATE |
-| Tests Postman | `tests/SmartStack.Security.postman_collection.json` | UPDATE (si choisi) |
-
-**Utiliser templates de** → `.claude/skills/controller/templates.md`
-
-### ÉTAPE 6: LOGS CRITIQUES - VÉRIFICATION
-
-Après génération, **VÉRIFIER** que le controller contient :
-
-| Événement | Niveau Requis | Présent ? |
-|-----------|---------------|-----------|
-| Login échoué (si auth) | `LogCritical` | ☐ |
-| Compte verrouillé (si auth) | `LogCritical` | ☐ |
-| Password change | `LogWarning` | ☐ |
-| Création | `LogInformation` | ☐ |
-| Modification | `LogInformation` | ☐ |
-| Suppression | `LogWarning` | ☐ |
-| Désactivation | `LogWarning` | ☐ |
-
-### ÉTAPE 7: RÉSUMÉ FINAL
-
-Afficher:
-- ✅ Fichiers créés (chemins cliquables)
-- 🔐 Permissions ajoutées
-- 🧪 Tests Postman générés (si applicable)
-- 📝 Prochaines étapes:
-  - Vérifier les DTOs
-  - Ajouter validation métier si nécessaire
-  - Tester avec Swagger/Postman
-
----
-
-## SOURCES DE DONNÉES
-
-| Donnée | Source |
-|--------|--------|
-| Entity Domain | `src/SmartStack.Domain/**/{Entity}.cs` |
-| DbContext | `src/SmartStack.Application/Common/Interfaces/IApplicationDbContext.cs` |
-| Permissions | `src/SmartStack.Application/Common/Authorization/Permissions.cs` |
-| Controllers existants | `src/SmartStack.Api/Controllers/**/*.cs` |
-| Tests Postman | `tests/SmartStack.Security.postman_collection.json` |
-
----
-
-## MAPPING AREA → ROUTE
-
-| Area | Route Prefix | Permission Context |
-|------|--------------|-------------------|
-| `Admin` | `api/admin/` | `platform.administration.` |
-| `Support` | `api/support/` | `platform.support.` |
-| `Business` | `api/business/` | `business.` |
-| `User` | `api/user/` | `personal.myspace.` |
-| `Auth` | `api/auth/` | (AllowAnonymous pour login) |
-
----
-
-## TEMPLATES
-
-→ **Voir `.claude/skills/controller/templates.md`**
-
-Templates disponibles:
-- CRUD Controller (standard)
-- Auth Controller (login/logout/change-password)
-- Controller avec Relations (nested resources)
-- Patterns réutilisables (pagination, error responses)
-
-→ **Voir `.claude/skills/controller/postman-templates.md`**
-
-Templates tests:
-- GET list (200, 403, 401)
-- POST create (201, 403)
-- DELETE (403)
-- Auth (login success/fail, invalid token)
-
----
-
-## CONTRAINTES TECHNIQUES
-
-### Injection de Dépendances (Obligatoire)
-
-```csharp
-public {Module}Controller(
-    IApplicationDbContext context,     // TOUJOURS
-    ICurrentUserService currentUser,   // TOUJOURS
-    ILogger<{Module}Controller> logger // TOUJOURS
-    // + services spécifiques au module
-)
-```
-
-### ProducesResponseType (Obligatoire)
-
-```csharp
-[ProducesResponseType(typeof(PagedResult<T>), StatusCodes.Status200OK)]
-[ProducesResponseType(StatusCodes.Status401Unauthorized)]  // Si [Authorize]
-[ProducesResponseType(StatusCodes.Status403Forbidden)]     // Si [RequirePermission]
-[ProducesResponseType(StatusCodes.Status404NotFound)]      // Si GET/PUT/DELETE by ID
-```
-
-### Logging Pattern (Obligatoire)
-
-```csharp
-// Information - opérations standard
-_logger.LogInformation("User {User} created {Entity} {Id}",
-    _currentUser.Email, entity.Id);
-
-// Warning - opérations sensibles
-_logger.LogWarning("User {User} deleted {Entity} {Id} ({Name})",
-    _currentUser.Email, id, entity.Name);
-
-// Critical - sécurité (automatique via middleware pour 401/403)
-_logger.LogCritical("SECURITY: Login attempt on locked account - {Email} from {IP}",
-    email, ipAddress);
-```