@atlashub/smartstack-cli 1.14.0 → 1.14.2

package/.documentation/installation.html

@@ -14,7 +14,7 @@
         }
         .platform-btn {
             flex: 1;
-            padding: 1rem 1.5rem;
+            padding: 0.875rem 1rem;
             border: 2px solid var(--border);
             border-radius: 8px;
             background: var(--bg-card);
@@ -23,9 +23,11 @@
             transition: all 0.2s ease;
             display: flex;
             align-items: center;
-            gap: 0.75rem;
-            font-size: 1rem;
+            justify-content: center;
+            gap: 0.5rem;
+            font-size: 0.95rem;
             font-weight: 500;
+            min-height: 52px;
         }
         .platform-btn:hover {
             border-color: var(--primary);
@@ -36,7 +38,7 @@
             background: rgba(59, 130, 246, 0.1);
         }
         .platform-btn .platform-icon {
-            font-size: 1.5rem;
+            font-size: 1.25rem;
         }
         .platform-content {
             display: none;
@@ -48,26 +50,35 @@
         /* OS Selector */
         .os-selector {
             display: flex;
-            gap: 0.5rem;
-            margin-bottom: 1rem;
+            gap: 0.75rem;
         }
         .os-btn {
-            padding: 0.5rem 1rem;
-            border: 1px solid var(--border);
-            border-radius: 6px;
+            flex: 1;
+            padding: 0.875rem 1rem;
+            border: 2px solid var(--border);
+            border-radius: 8px;
             background: var(--bg-card);
             color: var(--text);
             cursor: pointer;
             transition: all 0.2s ease;
-            font-size: 0.9rem;
+            font-size: 0.95rem;
+            font-weight: 500;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 0.5rem;
+            min-height: 52px;
         }
         .os-btn:hover {
             border-color: var(--primary);
+            background: var(--bg-hover);
         }
         .os-btn.active {
             border-color: var(--primary);
             background: rgba(59, 130, 246, 0.1);
-            font-weight: 500;
+        }
+        .os-btn .os-icon {
+            font-size: 1.25rem;
         }
         .os-content {
             display: none;
@@ -80,7 +91,7 @@
         .settings-panel {
             background: var(--bg-card);
             border: 1px solid var(--border);
-            border-radius: 8px;
+            border-radius: 12px;
             padding: 1.5rem;
             margin-bottom: 2rem;
         }
@@ -91,13 +102,18 @@
         }
         .settings-group {
             flex: 1;
-            min-width: 200px;
+            min-width: 280px;
         }
         .settings-label {
             font-weight: 600;
             color: var(--text);
             margin-bottom: 0.75rem;
-            display: block;
+            display: flex;
+            align-items: center;
+            gap: 0.5rem;
+        }
+        .settings-label .label-icon {
+            font-size: 1.1rem;
         }
 
         /* Tutorial section */
@@ -489,17 +505,28 @@
                         <div class="settings-row">
                             <div class="settings-group">
                                 <span class="settings-label">
+                                    <span class="label-icon">&#128187;</span>
                                     <span data-lang="fr">Systeme d'exploitation</span>
                                     <span data-lang="en">Operating System</span>
                                 </span>
                                 <div class="os-selector">
-                                    <button class="os-btn active" data-os="windows" onclick="setOS('windows')">Windows</button>
-                                    <button class="os-btn" data-os="macos" onclick="setOS('macos')">macOS</button>
-                                    <button class="os-btn" data-os="linux" onclick="setOS('linux')">Linux</button>
+                                    <button class="os-btn active" data-os="windows" onclick="setOS('windows')">
+                                        <span class="os-icon">&#129695;</span>
+                                        <span>Windows</span>
+                                    </button>
+                                    <button class="os-btn" data-os="macos" onclick="setOS('macos')">
+                                        <span class="os-icon">&#127822;</span>
+                                        <span>macOS</span>
+                                    </button>
+                                    <button class="os-btn" data-os="linux" onclick="setOS('linux')">
+                                        <span class="os-icon">&#128039;</span>
+                                        <span>Linux</span>
+                                    </button>
                                 </div>
                             </div>
                             <div class="settings-group">
                                 <span class="settings-label">
+                                    <span class="label-icon">&#128256;</span>
                                     <span data-lang="fr">Plateforme Git</span>
                                     <span data-lang="en">Git Platform</span>
                                 </span>
@@ -651,8 +678,10 @@ git config --global credential.helper manager</code></pre>
                                             </div>
                                         </div>
 
-                                        <p data-lang="fr" style="margin-top: 1rem;">Git Credential Manager gerera automatiquement l'authentification via le navigateur lors du clone avec <code>/gitflow:10-start</code>.</p>
-                                        <p data-lang="en" style="margin-top: 1rem;">Git Credential Manager will automatically handle authentication via browser when cloning with <code>/gitflow:10-start</code>.</p>
+                                        <div class="tutorial-note" style="margin-top: 1rem;">
+                                            <p data-lang="fr"><strong>Pas besoin de <code>az login</code></strong> - Git Credential Manager ouvrira automatiquement votre navigateur pour vous authentifier avec votre compte Azure AD lors de la premiere operation Git (clone, push, etc.).</p>
+                                            <p data-lang="en"><strong>No need for <code>az login</code></strong> - Git Credential Manager will automatically open your browser to authenticate with your Azure AD account on the first Git operation (clone, push, etc.).</p>
+                                        </div>
                                     </div>
                                 </div>
                             </div>
@@ -815,14 +844,17 @@ claude mcp list</code></pre>
                         <span data-lang="en">Start your first project</span>
                     </h3>
 
-                    <div class="alert alert-info" style="margin-bottom: 1.5rem;">
-                        <span class="alert-icon">&#128161;</span>
+                    <div class="alert alert-success" style="margin-bottom: 1.5rem;">
+                        <span class="alert-icon">&#9989;</span>
                         <div class="alert-content">
-                            <p data-lang="fr">Felicitations ! L'installation est terminee. Voici comment demarrer votre premier projet SmartStack.</p>
-                            <p data-lang="en">Congratulations! Installation is complete. Here's how to start your first SmartStack project.</p>
+                            <p data-lang="fr"><strong>Vous lisez cette doc dans votre projet ?</strong> Vous etes deja pret ! Les etapes A, B, C sont deja faites. <a href="#step-d" style="color: var(--success); font-weight: 600;">Passez directement a l'etape D &rarr;</a></p>
+                            <p data-lang="en"><strong>Reading this doc in your project?</strong> You're already set! Steps A, B, C are done. <a href="#step-d" style="color: var(--success); font-weight: 600;">Skip to step D &rarr;</a></p>
                         </div>
                     </div>
 
+                    <p data-lang="fr" style="color: var(--text-muted); font-size: 0.9rem; margin-bottom: 1.5rem;">Les etapes A, B, C ci-dessous sont pour reference si vous devez configurer un nouveau projet.</p>
+                    <p data-lang="en" style="color: var(--text-muted); font-size: 0.9rem; margin-bottom: 1.5rem;">Steps A, B, C below are for reference if you need to set up a new project.</p>
+
                     <!-- Step A: Create repo -->
                     <div class="tutorial-section">
                         <h4>
@@ -907,19 +939,16 @@ claude mcp list</code></pre>
                     <div class="tutorial-section">
                         <h4>
                             <span class="step-badge">C</span>
-                            <span data-lang="fr">Initialiser SmartStack</span>
-                            <span data-lang="en">Initialize SmartStack</span>
+                            <span data-lang="fr">Installer les outils SmartStack</span>
+                            <span data-lang="en">Install SmartStack tools</span>
                         </h4>
 
-                        <p data-lang="fr">Une fois GitFlow configure, initialisez la structure du projet SmartStack :</p>
-                        <p data-lang="en">Once GitFlow is configured, initialize the SmartStack project structure:</p>
+                        <p data-lang="fr">Vous etes maintenant dans votre projet clone. Installez les outils SmartStack :</p>
+                        <p data-lang="en">You are now in your cloned project. Install SmartStack tools:</p>
 
                         <div class="code-block">
                             <button class="copy-btn">Copy</button>
-                            <pre><code># Pour un nouveau projet .NET (cree la structure Clean Architecture)
-smartstack init MonProjet
-
-# OU pour un projet existant (ajoute seulement les outils SmartStack)
+                            <pre><code># Depuis la racine de votre projet clone
 smartstack init .</code></pre>
                         </div>
 
@@ -927,39 +956,85 @@ smartstack init .</code></pre>
                         <p data-lang="en" style="margin-top: 1rem;">This command will:</p>
 
                         <ul style="margin: 0.5rem 0 1rem 1.5rem; color: var(--text-muted);">
-                            <li data-lang="fr">Creer la structure Clean Architecture (.NET)</li>
-                            <li data-lang="en">Create the Clean Architecture structure (.NET)</li>
                             <li data-lang="fr">Installer les skills et agents SmartStack</li>
                             <li data-lang="en">Install SmartStack skills and agents</li>
                             <li data-lang="fr">Configurer les hooks Claude Code</li>
                             <li data-lang="en">Configure Claude Code hooks</li>
+                            <li data-lang="fr">Generer le fichier <code>CLAUDE.md</code> avec les regles du projet</li>
+                            <li data-lang="en">Generate the <code>CLAUDE.md</code> file with project rules</li>
+                            <li data-lang="fr">Generer cette documentation (<code>.documentation/</code>)</li>
+                            <li data-lang="en">Generate this documentation (<code>.documentation/</code>)</li>
                             <li data-lang="fr">Verifier les serveurs MCP</li>
                             <li data-lang="en">Verify MCP servers</li>
                         </ul>
+
+                        <div class="tutorial-note">
+                            <p data-lang="fr"><strong>Nouveau projet .NET ?</strong> Si vous partez de zero et voulez creer la structure Clean Architecture, utilisez plutot <code>smartstack init MonProjet</code> avant l'etape A (sans creer de repo au prealable).</p>
+                            <p data-lang="en"><strong>New .NET project?</strong> If you're starting from scratch and want to create the Clean Architecture structure, use <code>smartstack init MyProject</code> before step A (without creating a repo beforehand).</p>
+                        </div>
                     </div>
 
                     <!-- Step D: Start working -->
-                    <div class="tutorial-section">
+                    <div class="tutorial-section" id="step-d">
                         <h4>
                             <span class="step-badge">D</span>
                             <span data-lang="fr">Commencer a travailler</span>
                             <span data-lang="en">Start working</span>
                         </h4>
 
-                        <p data-lang="fr">Votre environnement est pret ! Pour commencer une nouvelle fonctionnalite :</p>
-                        <p data-lang="en">Your environment is ready! To start a new feature:</p>
+                        <p data-lang="fr">Votre environnement est pret ! Le workflow GitFlow vous guide selon votre objectif :</p>
+                        <p data-lang="en">Your environment is ready! The GitFlow workflow guides you based on your goal:</p>
+
+                        <!-- Mini decision guide -->
+                        <div style="display: flex; gap: 1rem; flex-wrap: wrap; margin: 1.5rem 0;">
+                            <div style="flex: 1; min-width: 200px; padding: 1rem; background: rgba(34, 197, 94, 0.1); border: 1px solid #22c55e; border-radius: 8px;">
+                                <div style="font-weight: 600; color: #22c55e; margin-bottom: 0.5rem;">
+                                    <span data-lang="fr">Nouvelle fonctionnalite</span>
+                                    <span data-lang="en">New feature</span>
+                                </div>
+                                <code style="font-size: 0.85rem;">/gitflow:10-start feature {nom}</code>
+                            </div>
+                            <div style="flex: 1; min-width: 200px; padding: 1rem; background: rgba(234, 179, 8, 0.1); border: 1px solid #eab308; border-radius: 8px;">
+                                <div style="font-weight: 600; color: #eab308; margin-bottom: 0.5rem;">
+                                    <span data-lang="fr">Deployer en prod</span>
+                                    <span data-lang="en">Deploy to prod</span>
+                                </div>
+                                <code style="font-size: 0.85rem;">/gitflow:10-start release</code>
+                            </div>
+                            <div style="flex: 1; min-width: 200px; padding: 1rem; background: rgba(236, 72, 153, 0.1); border: 1px solid #ec4899; border-radius: 8px;">
+                                <div style="font-weight: 600; color: #ec4899; margin-bottom: 0.5rem;">
+                                    <span data-lang="fr">Bug urgent prod</span>
+                                    <span data-lang="en">Urgent prod bug</span>
+                                </div>
+                                <code style="font-size: 0.85rem;">/gitflow:10-start hotfix {nom}</code>
+                            </div>
+                        </div>
+
+                        <p data-lang="fr" style="margin-top: 1rem;">Cycle de travail type :</p>
+                        <p data-lang="en" style="margin-top: 1rem;">Typical work cycle:</p>
 
                         <div class="code-block">
                             <button class="copy-btn">Copy</button>
-                            <pre><code># Creer une branche feature
+                            <pre><code># 1. Demarrer une branche
 /gitflow:10-start feature ma-fonctionnalite
 
-# Commiter vos changements
+# 2. Coder... puis commiter regulierement
 /gitflow:3-commit
 
-# Finaliser la feature
+# 3. Creer une Pull Request quand c'est pret
+/gitflow:7-pull-request
+
+# 4. Finaliser apres le merge
 /gitflow:11-finish</code></pre>
                         </div>
+
+                        <div class="alert alert-info" style="margin-top: 1rem;">
+                            <span class="alert-icon">&#128218;</span>
+                            <div class="alert-content">
+                                <p data-lang="fr"><strong>Guide complet :</strong> Consultez le <a href="gitflow.html#workflow-decision" style="color: var(--primary);">schema decisonnel GitFlow</a> pour visualiser le workflow complet et choisir la bonne commande selon votre situation.</p>
+                                <p data-lang="en"><strong>Complete guide:</strong> See the <a href="gitflow.html#workflow-decision" style="color: var(--primary);">GitFlow decision diagram</a> to visualize the complete workflow and choose the right command for your situation.</p>
+                            </div>
+                        </div>
                     </div>
 
                     <!-- Links to documentation -->

package/config/default-config.json

@@ -1,6 +1,15 @@
 {
   "$schema": "https://atlashub.ch/schemas/claude-gitflow-config.json",
-  "version": "1.1.0",
+  "version": "2.0.0",
+  "worktrees": {
+    "enabled": true,
+    "mode": "organized",
+    "structure": {
+      "features": "../features",
+      "releases": "../releases",
+      "hotfixes": "../hotfixes"
+    }
+  },
   "git": {
     "branches": {
       "main": "main",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "1.14.0",
+  "version": "1.14.2",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, APEX, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",

package/templates/agents/efcore/migration.md

@@ -64,16 +64,16 @@ grep -oP '"version":\s*"\K[^"]+' package.json
 find Migrations -name "core_*.cs" | grep -v Designer | grep -v Snapshot
 
 # Existing migrations for Extensions
-find Migrations -name "ext_*.cs" | grep -v Designer | grep -v Snapshot
+find Persistence/Migrations -name "ext_*.cs" | grep -v Designer | grep -v Snapshot
 
 # Create Core migration
-dotnet ef migrations add $MIGRATION_NAME --context CoreDbContext
+dotnet ef migrations add $MIGRATION_NAME --context CoreDbContext -o Persistence/Migrations
 
 # Create Extensions migration
-dotnet ef migrations add $MIGRATION_NAME --context ExtensionsDbContext
+dotnet ef migrations add $MIGRATION_NAME --context ExtensionsDbContext -o Persistence/Migrations
 
 # Delete
-rm Migrations/*${OLD_NAME}*.cs
+rm Persistence/Migrations/*${OLD_NAME}*.cs
 ```
 
 ## Context Detection

package/templates/commands/efcore/_shared.md

@@ -11,7 +11,7 @@ detect_efcore_project() {
   CSPROJ=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; | head -1)
   PROJECT_DIR=$(dirname "$CSPROJ")
   PROJECT_NAME=$(basename "$CSPROJ" .csproj)
-  MIGRATIONS_DIR="$PROJECT_DIR/Migrations"
+  MIGRATIONS_DIR="$PROJECT_DIR/Persistence/Migrations"
 
   STARTUP_PROJECT=$(find . -name "*.Api.csproj" -o -name "*Web.csproj" | head -1)
   INFRA_PROJECT=$(find . -name "*Infrastructure.csproj" | head -1)

package/templates/commands/efcore/migration.md

@@ -93,7 +93,7 @@ AskUserQuestion({
 ## STEP 5: Création
 
 ```bash
-dotnet ef migrations add "$MIGRATION_NAME" --verbose
+dotnet ef migrations add "$MIGRATION_NAME" -o Persistence/Migrations --verbose
 ```
 
 ---

package/templates/commands/efcore/rebase-snapshot.md

@@ -71,7 +71,7 @@ done
 
 ```bash
 MIGRATION_NAME="${BRANCH_TYPE}_${VERSION}_${BRANCH_NAME}_Consolidated"
-dotnet ef migrations add "$MIGRATION_NAME" --verbose
+dotnet ef migrations add "$MIGRATION_NAME" -o Persistence/Migrations --verbose
 ```
 
 ---

package/templates/commands/efcore/squash.md

@@ -165,6 +165,7 @@ esac
 dotnet ef migrations add "$MIGRATION_NAME" \
   --project "$INFRA_PROJECT" \
   --startup-project "$STARTUP_PROJECT" \
+  -o Persistence/Migrations \
   --verbose
 ```
 

package/templates/skills/_shared.md

@@ -109,9 +109,32 @@ if (entity.UserType == UserType.System || entity.UserType == UserType.LocalAdmin
 
 ## MCP Tools References
 
-| Tool | Usage |
-|------|-------|
-| `mcp__smartstack__validate_conventions` | Validate conventions |
-| `mcp__smartstack__scaffold_extension` | Code generation |
-| `mcp__smartstack__check_migrations` | Check migrations |
-| `mcp__smartstack__scaffold_tests` | Generate tests |
+### Outils Core
+
+| Tool | Usage | Step APEX |
+|------|-------|-----------|
+| `mcp__smartstack__validate_conventions` | Valider conventions SmartStack (tables, migrations, services, namespaces, entities, tenants, controllers) | step-04-validate |
+| `mcp__smartstack__scaffold_extension` | Génération code (feature, entity, service, controller, component, dto, validator, repository) | step-03-execute |
+| `mcp__smartstack__check_migrations` | Analyser migrations EF Core (conflits, ordre, ModelSnapshot) | step-04-validate |
+| `mcp__smartstack__api_docs` | Documentation API depuis Swagger/OpenAPI ou controllers | step-01-analyze |
+| `mcp__smartstack__suggest_migration` | Suggérer nom migration ({context}_v{version}_{sequence}_{Description}) | step-03-execute |
+| `mcp__smartstack__generate_permissions` | Générer permissions RBAC depuis NavRoute | step-03-execute |
+
+### Outils Tests
+
+| Tool | Usage | Step APEX |
+|------|-------|-----------|
+| `mcp__smartstack__scaffold_tests` | Générer tests unitaires/intégration/sécurité | step-07-tests |
+| `mcp__smartstack__analyze_test_coverage` | Analyser couverture de tests du projet | step-07-tests |
+| `mcp__smartstack__validate_test_conventions` | Valider conventions de nommage des tests | step-07-tests |
+| `mcp__smartstack__suggest_test_scenarios` | Suggérer scénarios de test basés sur le code | step-07-tests |
+
+### Outils Frontend
+
+| Tool | Usage | Step APEX |
+|------|-------|-----------|
+| `mcp__smartstack__scaffold_api_client` | Générer client TypeScript avec NavRoute | step-03-execute |
+| `mcp__smartstack__scaffold_routes` | Générer React Router depuis NavRoute backend | step-03-execute |
+| `mcp__smartstack__validate_frontend_routes` | Valider synchronisation routes frontend/backend | step-04-validate |
+| `mcp__smartstack__scaffold_frontend_extension` | Générer infrastructure extension frontend | step-03-execute |
+| `mcp__smartstack__analyze_extension_points` | Analyser points d'extension dans les pages React | step-01-analyze |

package/templates/skills/apex/SKILL.md

@@ -225,6 +225,62 @@ When provided, step-00 will:
 - **Use parallel agents** for independent exploration tasks (unless economy_mode)
 </execution_rules>
 
+<mcp_requirements>
+**SmartStack MCP Integration:**
+
+APEX est fortement couplé au développement SmartStack via les outils MCP.
+Référence complète dans `_shared.md` section "MCP Tools References".
+
+### Outils obligatoires (chaque exécution APEX)
+
+| Tool | Quand | Step |
+|------|-------|------|
+| `mcp__smartstack__api_docs` | Analyse contexte API existant | step-01-analyze |
+| `mcp__smartstack__validate_conventions` | Validation finale du code généré | step-04-validate |
+
+### Outils conditionnels (step-03-execute)
+
+| Tool | Condition |
+|------|-----------|
+| `mcp__smartstack__scaffold_extension` | Génération entités/services/controllers |
+| `mcp__smartstack__suggest_migration` | Création nouvelle migration EF Core |
+| `mcp__smartstack__generate_permissions` | Génération permissions RBAC |
+| `mcp__smartstack__scaffold_api_client` | Génération client TypeScript |
+| `mcp__smartstack__scaffold_routes` | Génération routes React Router |
+
+### Outils conditionnels (step-04-validate)
+
+| Tool | Condition |
+|------|-----------|
+| `mcp__smartstack__check_migrations` | Si modifications EF Core détectées |
+| `mcp__smartstack__validate_frontend_routes` | Si code frontend généré |
+
+### Outils tests (step-07-tests, si `-t`)
+
+| Tool | Usage |
+|------|-------|
+| `mcp__smartstack__scaffold_tests` | Générer tests unitaires/intégration |
+| `mcp__smartstack__suggest_test_scenarios` | Suggérer scénarios de test |
+| `mcp__smartstack__analyze_test_coverage` | Analyser couverture existante |
+
+### Outils analyse (step-01-analyze)
+
+| Tool | Usage |
+|------|-------|
+| `mcp__smartstack__analyze_extension_points` | Identifier points d'extension React |
+
+### Vérification MCP (step-00)
+
+Au démarrage, vérifier la disponibilité du MCP SmartStack :
+- Si disponible : utiliser les outils MCP pour génération et validation
+- Si indisponible : avertir l'utilisateur, continuer en mode dégradé (outils manuels)
+
+### Mode économie (`-e`)
+
+En mode économie, les outils MCP restent disponibles mais les subagents sont désactivés.
+Privilégier les outils MCP (`scaffold_*`) pour la génération plutôt que l'écriture manuelle.
+</mcp_requirements>
+
 <success_criteria>
 
 - Each step loaded progressively

package/templates/skills/apex/steps/step-01-analyze.md

@@ -50,7 +50,24 @@ From the task description, identify:
 
 These keywords guide exploration - NOT planning.
 
-### 2. Explore Codebase
+### 2. SmartStack MCP Context (if available)
+
+**Use MCP tools for SmartStack-specific context:**
+
+```
+mcp__smartstack__api_docs:
+  format: "markdown"
+  # Récupère la documentation API existante
+  # Identifie les endpoints, DTOs, et patterns utilisés
+```
+
+This provides:
+- Existing API endpoints and their structure
+- DTOs and request/response models
+- Controller patterns and conventions
+- NavRoute hierarchy
+
+### 3. Explore Codebase
 
 **If `{economy_mode}` = true:**
 
@@ -98,7 +115,7 @@ Find:
 3. Known pitfalls or gotchas
 ```
 
-### 3. Synthesize Findings
+### 4. Synthesize Findings
 
 Combine results into structured context:
 
@@ -140,7 +157,7 @@ Combine results into structured context:
 - Use httpOnly cookies for tokens
 ```
 
-### 4. Infer Acceptance Criteria
+### 5. Infer Acceptance Criteria
 
 Based on task and context, infer success criteria:
 
@@ -156,7 +173,7 @@ Based on "{task_description}" and existing patterns:
 _These will be refined in the planning step._
 ```
 
-### 5. Save Output (if save_mode)
+### 6. Save Output (if save_mode)
 
 **If `{save_mode}` = true:**
 
@@ -165,7 +182,7 @@ Write findings to `{output_dir}/01-analyze.md`:
 - Add timestamp at the end
 - Update 00-context.md Progress table: 01-analyze -> Complete
 
-### 6. Present Context Summary
+### 7. Present Context Summary
 
 ```
 **Context Gathering Complete**

package/templates/skills/apex/steps/step-04-validate.md

@@ -85,7 +85,33 @@ pnpm run test
 3. Fix the root cause
 4. Re-run until passing
 
-### 3. Self-Audit Checklist
+### 3. SmartStack Convention Validation (if MCP available)
+
+**Use MCP to validate SmartStack conventions:**
+
+```
+mcp__smartstack__validate_conventions:
+  checks: ["all"]
+  # Valide: tables, migrations, services, namespaces, entities, tenants, controllers
+```
+
+**If EF Core changes detected, also run:**
+
+```
+mcp__smartstack__check_migrations:
+  # Vérifie conflits, ordre chronologique, ModelSnapshot
+```
+
+**MCP validation checks:**
+- [ ] Table naming (domain prefixes: auth_, nav_, cfg_, etc.)
+- [ ] Migration naming ({context}_v{version}_{sequence}_{Description})
+- [ ] Service interfaces (I*Service pattern)
+- [ ] Namespace structure (Domain → Application → Infrastructure → API)
+- [ ] Entity conventions (base classes, soft delete, audit)
+- [ ] Tenant isolation (ITenantEntity where required)
+- [ ] Controller routes (NavRoute attributes)
+
+### 4. Self-Audit Checklist
 
 Verify each item:
 
@@ -109,14 +135,14 @@ Verify each item:
 - [ ] Error handling consistent
 - [ ] Naming conventions match
 
-### 4. Format Code
+### 5. Format Code
 
 If format command available:
 ```bash
 pnpm run format
 ```
 
-### 5. Final Verification
+### 6. Final Verification
 
 Re-run all checks:
 ```bash
@@ -125,7 +151,7 @@ pnpm run typecheck && pnpm run lint
 
 Both MUST pass.
 
-### 6. Present Validation Results
+### 7. Present Validation Results
 
 ```
 **Validation Complete**
@@ -144,7 +170,7 @@ Both MUST pass.
 **Summary:** All checks passing, ready for next step.
 ```
 
-### 7. Save Output (if save_mode)
+### 8. Save Output (if save_mode)
 
 **If `{save_mode}` = true:**
 
@@ -154,7 +180,7 @@ Write to `{output_dir}/04-validate.md`:
 - Timestamp
 - Update 00-context.md Progress table: 04-validate -> Complete
 
-### 8. Determine Next Step
+### 9. Determine Next Step
 
 **Decision tree:**