@atlashub/smartstack-cli 3.19.0 → 3.21.0

package/templates/skills/business-analyse/html/src/styles/03-navigation.css

@@ -1,62 +1,120 @@
 /* ============================================
-   SIDEBAR - Navigation 5 niveaux
+   SIDEBAR - Hierarchical Tree Navigation
    ============================================ */
-.nav-group { padding: 1rem 0; }
+
+/* Sidebar header */
+.sidebar-header {
+    padding: 0.75rem 1rem;
+    border-bottom: 1px solid var(--border);
+    background: var(--bg-hover);
+}
+.sidebar-app-name {
+    font-size: 0.95rem;
+    font-weight: 600;
+    color: var(--primary-light);
+    display: block;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+/* Nav groups (top-level: Cadrage, Modules, Consolidation, Synthese) */
+.nav-group { padding: 0.4rem 0; }
 .nav-group + .nav-group { border-top: 1px solid var(--border); }
 
 .nav-group-title {
-    font-size: 0.65rem;
+    font-size: 0.7rem;
     text-transform: uppercase;
     letter-spacing: 0.1em;
     color: var(--text-muted);
-    padding: 0 1rem;
-    margin-bottom: 0.5rem;
+    padding: 0.4rem 1rem;
+    margin-bottom: 0.15rem;
     font-weight: 600;
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    gap: 0.3rem;
+    user-select: none;
+    transition: color var(--transition-fast);
+}
+.nav-group-title:hover { color: var(--text-bright); }
+
+/* Chevron icon for expand/collapse */
+.nav-chevron {
+    font-size: 0.6rem;
+    display: inline-block;
+    transition: transform var(--transition-fast);
+    color: var(--text-muted);
+    width: 12px;
+    text-align: center;
+    flex-shrink: 0;
 }
+.nav-chevron.expanded { transform: rotate(90deg); }
 
+/* Nav items (leaf nodes) */
 .nav-item {
     display: flex;
     align-items: center;
-    gap: 0.5rem;
-    padding: 0.45rem 1rem;
+    gap: 0.4rem;
+    padding: 0.35rem 1rem;
     color: var(--text);
     text-decoration: none;
-    font-size: 0.85rem;
+    font-size: 0.82rem;
     cursor: pointer;
     transition: all var(--transition-fast);
     border-left: 3px solid transparent;
 }
 .nav-item:hover { background: var(--bg-hover); color: var(--text-bright); }
-.nav-item.active { background: rgba(99,102,241,0.1); border-left-color: var(--primary); color: var(--primary-light); font-weight: 500; }
+.nav-item.active {
+    background: rgba(99,102,241,0.1);
+    border-left-color: var(--primary);
+    color: var(--primary-light);
+    font-weight: 500;
+}
 
-.nav-item .nav-icon { font-size: 1rem; width: 20px; text-align: center; }
+.nav-item .nav-icon {
+    font-size: 0.45rem;
+    width: 12px;
+    text-align: center;
+    color: var(--border-light);
+    flex-shrink: 0;
+}
 .nav-item .nav-badge {
     margin-left: auto;
-    font-size: 0.65rem;
+    font-size: 0.6rem;
     background: var(--bg-hover);
-    padding: 0.1rem 0.4rem;
+    padding: 0.1rem 0.35rem;
     border-radius: 10px;
     color: var(--text-muted);
+    min-width: 16px;
+    text-align: center;
 }
 
-.nav-children { margin-left: 1.2rem; }
-.nav-children .nav-item { font-size: 0.8rem; padding: 0.3rem 1rem; }
+/* Nested children (indented) */
+.nav-children { margin-left: 0; }
+.nav-children .nav-item { padding-left: 1.6rem; font-size: 0.8rem; }
+.nav-children .nav-children .nav-item { padding-left: 2.4rem; font-size: 0.78rem; }
+.nav-children .nav-children .nav-children .nav-item { padding-left: 3rem; font-size: 0.75rem; }
 
-/* ============================================
-   PHASE PROGRESS
-   ============================================ */
-.phase-progress {
-    display: flex; align-items: center; gap: 0.3rem;
-    padding: 0.75rem 1rem; border-bottom: 1px solid var(--border);
-}
-.phase-dot {
-    width: 24px; height: 24px; border-radius: 50%;
-    display: flex; align-items: center; justify-content: center;
-    font-size: 0.6rem; font-weight: 700; color: var(--text-muted);
-    background: var(--bg-hover); border: 2px solid var(--border);
-    transition: all var(--transition-fast);
+/* Module header in nav (collapsible) */
+.nav-module-header {
+    font-weight: 500;
+    color: var(--text-bright);
+    font-size: 0.85rem;
+}
+.nav-module-header:hover { color: var(--primary-light); }
+
+/* Section/Resource items in nav */
+.nav-section-item { margin-top: 0.1rem; }
+.nav-section-link { font-style: italic; }
+.nav-icon-section { font-size: 0.5rem; color: var(--accent); }
+.nav-icon-resource { font-size: 0.7rem; color: var(--border-light); }
+.nav-resource-link {
+    cursor: default;
+    font-size: 0.72rem;
+    color: var(--text-muted);
+    padding-top: 0.2rem;
+    padding-bottom: 0.2rem;
 }
-.phase-dot.completed { background: var(--success); border-color: var(--success); color: #fff; }
-.phase-dot.current { background: var(--primary); border-color: var(--primary); color: #fff; }
-.phase-line { flex: 1; height: 2px; background: var(--border); }
-.phase-line.completed { background: var(--success); }
+.nav-resource-link:hover { background: transparent; color: var(--text-muted); }
+.nav-resources { margin-left: 0.5rem; }

package/templates/skills/business-analyse/html/src/styles/05-modules.css

@@ -388,3 +388,67 @@
     padding-left: 0.75rem; border-left: 2px solid var(--accent);
     margin-bottom: 0.2rem;
 }
+
+/* ============================================
+   STRUCTURE TAB (Sections/Resources)
+   ============================================ */
+.struct-section {
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    margin-bottom: 1rem;
+    overflow: hidden;
+}
+.struct-section-header {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 0.75rem 1rem;
+    background: var(--bg-hover);
+    border-bottom: 1px solid var(--border);
+}
+.struct-section-code {
+    font-weight: 600;
+    color: var(--text-bright);
+    font-size: 0.95rem;
+}
+.struct-section-desc {
+    flex: 1;
+    font-size: 0.8rem;
+    color: var(--text-muted);
+}
+.struct-section-badge {
+    font-size: 0.65rem;
+    color: var(--text-muted);
+    background: rgba(99,102,241,0.1);
+    padding: 0.1rem 0.5rem;
+    border-radius: 4px;
+    white-space: nowrap;
+}
+.struct-resources {
+    padding: 0.5rem 0;
+}
+.struct-resource {
+    display: flex;
+    align-items: baseline;
+    gap: 0.5rem;
+    padding: 0.35rem 1rem 0.35rem 1.5rem;
+    font-size: 0.85rem;
+    transition: background var(--transition-fast);
+}
+.struct-resource:hover {
+    background: var(--bg-hover);
+}
+.struct-resource-icon {
+    color: var(--primary-light);
+    font-size: 0.7rem;
+    flex-shrink: 0;
+}
+.struct-resource-name {
+    font-weight: 500;
+    color: var(--text-bright);
+}
+.struct-resource-desc {
+    font-size: 0.8rem;
+    color: var(--text-muted);
+}

package/templates/skills/business-analyse/html/src/template.html

@@ -20,6 +20,7 @@
             <span class="header-app-name" id="appName">{{APPLICATION_NAME}}</span>
             <div class="header-spacer"></div>
             <div class="header-actions">
+                <button class="btn btn-sm" onclick="resetToEmbedded()" title="Reinitialiser depuis les donnees d'origine (supprime les modifications locales)">Reset</button>
                 <button class="btn btn-sm" onclick="saveToLocalStorage()" title="Sauvegarder les modifications dans le navigateur">Sauvegarder</button>
                 <button class="btn btn-sm btn-review" onclick="saveReviewJSON()" title="Sauvegarder les corrections pour creer une nouvelle version">Sauvegarder corrections</button>
                 <button class="btn btn-sm btn-primary" onclick="exportJSON()" title="Exporter les donnees au format JSON pour l'extraction">Exporter JSON</button>
@@ -32,85 +33,16 @@
 
         <div class="body" id="appBody">
             <!-- ============================================
-                 SIDEBAR - Navigation 5 niveaux
+                 SIDEBAR - Navigation hierarchique
                  ============================================ -->
             <aside class="sidebar">
-                <!-- Phase Progress -->
-                <div class="phase-progress">
-                    <div class="phase-dot current" id="phase-1" title="Cadrage">1</div>
-                    <div class="phase-line" id="pline-1"></div>
-                    <div class="phase-dot" id="phase-2" title="Decomposition">2</div>
-                    <div class="phase-line" id="pline-2"></div>
-                    <div class="phase-dot" id="phase-3" title="Specification">3</div>
-                    <div class="phase-line" id="pline-3"></div>
-                    <div class="phase-dot" id="phase-4" title="Consolidation">4</div>
-                    <div class="phase-line" id="pline-4"></div>
-                    <div class="phase-dot" id="phase-5" title="Synthese">5</div>
+                <!-- Application Name -->
+                <div class="sidebar-header">
+                    <span class="sidebar-app-name" id="sidebarAppName">{{APPLICATION_NAME}}</span>
                 </div>
-
-                <!-- Phase 1 : Cadrage -->
-                <div class="nav-group">
-                    <div class="nav-group-title">1. Cadrage</div>
-                    <a class="nav-item active" onclick="showSection('cadrage-context')" data-section="cadrage-context">
-                        <span class="nav-icon">&#9679;</span> Contexte
-                    </a>
-                    <a class="nav-item" onclick="showSection('cadrage-stakeholders')" data-section="cadrage-stakeholders">
-                        <span class="nav-icon">&#9679;</span> Parties prenantes
-                        <span class="nav-badge" id="stakeholderCount">0</span>
-                    </a>
-                    <a class="nav-item" onclick="showSection('cadrage-scope')" data-section="cadrage-scope">
-                        <span class="nav-icon">&#9679;</span> Perimetre fonctionnel
-                    </a>
-                    <a class="nav-item" onclick="showSection('cadrage-risks')" data-section="cadrage-risks">
-                        <span class="nav-icon">&#9679;</span> Risques et hypotheses
-                    </a>
-                    <a class="nav-item" onclick="showSection('cadrage-success')" data-section="cadrage-success">
-                        <span class="nav-icon">&#9679;</span> Criteres de reussite
-                    </a>
-                </div>
-
-                <!-- Phase 2 : Decomposition -->
-                <div class="nav-group">
-                    <div class="nav-group-title">2. Decomposition</div>
-                    <a class="nav-item" onclick="showSection('decomp-modules')" data-section="decomp-modules">
-                        <span class="nav-icon">&#9679;</span> Domaines fonctionnels
-                        <span class="nav-badge" id="moduleCount">0</span>
-                    </a>
-                    <a class="nav-item" onclick="showSection('decomp-dependencies')" data-section="decomp-dependencies">
-                        <span class="nav-icon">&#9679;</span> Dependances
-                    </a>
-                </div>
-
-                <!-- Phase 3 : Specification par module -->
-                <div class="nav-group" id="modulesNav">
-                    <div class="nav-group-title">3. Specification</div>
-                    <!-- Populated dynamically per module -->
-                </div>
-
-                <!-- Phase 4 : Consolidation -->
-                <div class="nav-group">
-                    <div class="nav-group-title">4. Consolidation</div>
-                    <a class="nav-item" onclick="showSection('consol-datamodel')" data-section="consol-datamodel">
-                        <span class="nav-icon">&#9679;</span> Modele de donnees
-                        <span class="nav-badge" id="entityCount">0</span>
-                    </a>
-                    <a class="nav-item" onclick="showSection('consol-interactions')" data-section="consol-interactions">
-                        <span class="nav-icon">&#9679;</span> Interactions
-                    </a>
-                    <a class="nav-item" onclick="showSection('consol-permissions')" data-section="consol-permissions">
-                        <span class="nav-icon">&#9679;</span> Coherence des acces
-                    </a>
-                    <a class="nav-item" onclick="showSection('consol-flows')" data-section="consol-flows">
-                        <span class="nav-icon">&#9679;</span> Parcours bout en bout
-                    </a>
-                </div>
-
-                <!-- Phase 5 : Synthese -->
-                <div class="nav-group">
-                    <div class="nav-group-title">5. Synthese</div>
-                    <a class="nav-item" onclick="showSection('handoff-summary')" data-section="handoff-summary">
-                        <span class="nav-icon">&#9679;</span> Vue d'ensemble
-                    </a>
+                <!-- Dynamic Tree Navigation -->
+                <div id="sidebarNav">
+                    <!-- Populated by buildNavTree() -->
                 </div>
             </aside>
 

package/templates/skills/business-analyse/references/deploy-data-build.md

@@ -26,14 +26,15 @@ const FEATURE_DATA = {
     scope: {
       // CONVERT feature.json keys to HTML keys:
       // mustHave → vital, shouldHave → important, couldHave → optional, outOfScope → excluded
+      // CRITICAL: Preserve per-item `module` assignment from coverageMatrix (NOT modules[0])
       vital: (master.cadrage.globalScope?.mustHave || master.cadrage.coverageMatrix?.filter(i => i.category === "mustHave") || [])
-        .map(item => typeof item === 'string' ? { name: item, description: "" } : { name: item.item || item, description: item.notes || "" }),
+        .map(item => typeof item === 'string' ? { name: item, description: "", module: null } : { name: item.item || item, description: item.notes || "", module: item.module || null }),
       important: (master.cadrage.globalScope?.shouldHave || master.cadrage.coverageMatrix?.filter(i => i.category === "shouldHave") || [])
-        .map(item => typeof item === 'string' ? { name: item, description: "" } : { name: item.item || item, description: item.notes || "" }),
+        .map(item => typeof item === 'string' ? { name: item, description: "", module: null } : { name: item.item || item, description: item.notes || "", module: item.module || null }),
       optional: (master.cadrage.globalScope?.couldHave || master.cadrage.coverageMatrix?.filter(i => i.category === "couldHave") || [])
-        .map(item => typeof item === 'string' ? { name: item, description: "" } : { name: item.item || item, description: item.notes || "" }),
+        .map(item => typeof item === 'string' ? { name: item, description: "", module: null } : { name: item.item || item, description: item.notes || "", module: item.module || null }),
       excluded: (master.cadrage.globalScope?.outOfScope || master.cadrage.coverageMatrix?.filter(i => i.category === "outOfScope") || [])
-        .map(item => typeof item === 'string' ? { name: item, description: "" } : { name: item.item || item, description: item.notes || "" })
+        .map(item => typeof item === 'string' ? { name: item, description: "", module: null } : { name: item.item || item, description: item.notes || "", module: item.module || null })
     },
     risks: (master.cadrage.risks || []).map(r => ({
       description: r.description,
@@ -123,8 +124,9 @@ const FEATURE_DATA = {
 const EMBEDDED_ARTIFACTS = {
   wireframes: {
     // PER-MODULE keyed object (NOT a flat array)
-    // FOR EACH module: extract from specification.uiWireframes[]
-    [moduleCode]: moduleFeature.specification.uiWireframes.map(wf => ({
+    // FOR EACH module: extract from specification.uiWireframes[] OR specification.wireframes[] (SAFETY NET)
+    // IMPORTANT: The agent may write wireframes under either key name — always check BOTH
+    [moduleCode]: (moduleFeature.specification.uiWireframes || moduleFeature.specification.wireframes || []).map(wf => ({
       screen: wf.screen || wf.name || wf.id || "",  // SAFETY NET: fallback name/id → screen
       section: wf.section || "",                      // e.g. "list"
       format: wf.mockupFormat || "ascii",             // RENAME: mockupFormat → format
@@ -161,7 +163,7 @@ const EMBEDDED_ARTIFACTS = {
 
 ### Artifact Gathering
 
-1. For EACH module: read `specification.uiWireframes[]`, **rename fields** (`mockupFormat`→`format`, `mockup`→`content`), store under `wireframes[moduleCode]`
+1. For EACH module: read `specification.uiWireframes[]` OR `specification.wireframes[]` (check BOTH keys — agent may use either), **rename fields** (`mockupFormat`→`format`, `mockup`→`content`), store under `wireframes[moduleCode]`
 2. Read master's `consolidation.e2eFlows[]` and build e2eFlows array with diagram generation
 3. Read master's `dependencyGraph` and build nodes/edges
 4. Serialize as JSON with 2-space indentation

package/templates/skills/business-analyse/references/html-data-mapping.md

@@ -20,25 +20,17 @@ Build a JSON object following this **exact mapping** from feature.json to the HT
     analysisMode: master.metadata.analysisMode || "interactive"  // always "interactive"
   },
   cadrage: {
-    problem: {
-      description: master.cadrage.problem,              // string → problem.description
-      trigger: master.cadrage.trigger,                  // string → problem.trigger
-      impactedPeople: "",                               // not in feature.json, client fills
-      history: "",
-      consequences: ""
-    },
-    current: {
-      tools: master.cadrage.asIs,                       // string → current.tools
-      steps: [],                                        // client can add process steps
-      painPoints: master.cadrage.stakeholders
-        .flatMap(s => s.painPoints || []).join("\n"),    // aggregate all painPoints
-      errors: ""
-    },
-    vision: {
-      changes: master.cadrage.toBe,                     // string → vision.changes
-      results: master.cadrage.acceptanceCriteria
-        .map(ac => ac.criterion).join("\n"),             // AC → results (one per line)
-      successSign: ""
+    // CONTEXT SECTION — lean format (merged from problem/asIs/toBe)
+    // NOTE: 01-data-init.js has backward compat for old problem/current/vision format
+    context: {
+      problem: master.cadrage.problem || "",             // flat string from feature.json
+      trigger: master.cadrage.trigger || "",              // flat string from feature.json
+      currentSituation: master.cadrage.asIs || "",        // flat string from feature.json
+      desiredSituation: master.cadrage.toBe || "",        // flat string from feature.json
+      painPoints: (master.cadrage.stakeholders || [])
+        .flatMap(s => s.painPoints || []).join("\n"),     // aggregate all painPoints
+      acceptanceCriteria: (master.cadrage.acceptanceCriteria || [])
+        .map(ac => ac.criterion).join("\n")               // AC → newline-separated string
     },
     stakeholders: master.cadrage.stakeholders.map(s => ({
       role: s.role,
@@ -64,22 +56,22 @@ Build a JSON object following this **exact mapping** from feature.json to the HT
       impact: r.impact,
       mitigation: r.mitigation || ""
     })),
-    assumptions: "",
-    success: {
-      definition: (master.cadrage.acceptanceCriteria || [])
-        .map(ac => ac.criterion).join("\n"),
-      metrics: "",
-      timeline: "",
-      minimumConditions: ""
-    }
+    criteria: (master.cadrage.acceptanceCriteria || []).map(ac => ({
+      text: ac.criterion,
+      validated: ac.validated || false
+    }))
   },
   modules: master.modules.map(m => ({
     code: m.code,
-    name: m.code,                                       // module code as name
+    name: m.name || m.code,                             // display name (MANDATORY, separate from code)
     description: m.description || "",
     featureType: m.featureType || "data-centric",
     priority: m.priority || "must",
     entities: m.entities || [],
+    anticipatedSections: m.anticipatedSections || [],    // [{code, description, resources[]}]
+    dependencies: m.dependencies || [],
+    dependents: m.dependents || [],
+    estimatedComplexity: m.estimatedComplexity || "medium",
     status: m.status || "handed-off"
   })),
   dependencies: (master.dependencyGraph?.edges || []).map(e => ({

package/templates/skills/business-analyse/references/validate-incremental-html.md

@@ -44,7 +44,8 @@ Build EMBEDDED_ARTIFACTS with wireframes for completed modules only:
 const EMBEDDED_ARTIFACTS = {
   wireframes: {
     // FOR EACH completed module: extract wireframes with RENAMED fields
-    [moduleCode]: moduleFeature.specification.uiWireframes.map(wf => ({
+    // SAFETY NET: check BOTH key names (agent may use either)
+    [moduleCode]: (moduleFeature.specification.uiWireframes || moduleFeature.specification.wireframes || []).map(wf => ({
       screen: wf.screen,
       section: wf.section,
       format: wf.mockupFormat || "ascii",   // RENAME: mockupFormat → format

package/templates/skills/business-analyse/steps/step-02-decomposition.md

@@ -293,10 +293,12 @@ Create: docs/business/{app}/{module_code}/business-analyse/v1.0/
 
 > Module feature.json files will be created by step-03 when each module is processed.
 
-### 9. Display Summary
+### 9. Display Summary & AUTOCHAIN
 
 ```
-## Decomposition Complete - {feature_id}
+═══════════════════════════════════════════════════════════
+  DECOMPOSITION COMPLETE - {feature_id}
+═══════════════════════════════════════════════════════════
 
 | Aspect | Value |
 |--------|-------|
@@ -309,8 +311,16 @@ Create: docs/business/{app}/{module_code}/business-analyse/v1.0/
 {numbered list of modules}
 
 → Starting iterative specification with {first_module}...
+═══════════════════════════════════════════════════════════
 ```
 
+**AUTOCHAIN — DO NOT STOP HERE:**
+- Do NOT ask "shall I continue?" or "voulez-vous que je continue?"
+- Do NOT summarize what's coming next
+- Do NOT wait for user input
+- The user ALREADY validated at step 6 — that was the checkpoint
+- IMMEDIATELY load step-03a1-setup.md
+
 ---
 
 ## SINGLE-MODULE MODE
@@ -325,6 +335,9 @@ When `workflow.mode = "module"` or only 1 scope item identified:
 
 ---
 
-## NEXT STEP
+## NEXT STEP (MANDATORY — NO PAUSE)
 
 Load: `./step-03a1-setup.md`
+
+> **FORBIDDEN:** Asking any question between decomposition summary and step-03 load.
+> The client checkpoint was at step 6. Do NOT add another one.

package/templates/skills/business-analyse/steps/step-03c-compile.md

@@ -48,6 +48,45 @@ Compile all data collected in step-03a (data) and step-03b (UI) into the module
 
 Generate the complete specification for this module. **Each subsection below includes a STRUCTURE CARD showing the EXACT JSON format. Follow them precisely.**
 
+#### ENTITY ATTRIBUTE SCHEMA (MANDATORY — applies to ALL entities in section 6b of step-03a)
+
+> **CRITICAL:** Entity attributes MUST use STRUCTURED properties, not free-text validation strings.
+> The ralph-loop needs parseable types to generate correct C# code.
+
+> **STRUCTURE CARD: analysis.entities[].attributes[]**
+> ```json
+> {
+>   "name": "occupancyRate",
+>   "description": "Employee occupancy percentage",
+>   "type": "decimal",
+>   "maxLength": null,
+>   "nullable": true,
+>   "required": false,
+>   "unique": false,
+>   "indexed": false,
+>   "defaultValue": "100",
+>   "validation": "min:0, max:100, step:0.01",
+>   "foreignKey": null
+> }
+> ```
+> **MANDATORY fields:** `name`, `type`
+> **type values:** `string`, `int`, `long`, `decimal`, `double`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `Guid`, `enum:{EnumName}`, `byte[]`
+> **For FK attributes:**
+> ```json
+> {
+>   "name": "departmentId",
+>   "description": "FK to Department",
+>   "type": "Guid",
+>   "required": true,
+>   "foreignKey": { "targetEntity": "Department", "targetField": "Id", "onDelete": "restrict" }
+> }
+> ```
+> **FORBIDDEN:** Free-text-only validation like `"FK vers Employee"` or `"Max 100 caractères"` without corresponding structured properties.
+>
+> **BaseEntity inheritance:** All entities inherit `tenantId`, `createdAt`, `updatedAt`, `createdBy`, `updatedBy` from SmartStack.BaseEntity. Do NOT redeclare these. Document this once at the top of the entities section.
+
+---
+
 #### 8a. Actors
 
 Inherited from application roles → mapped to module permissions.
@@ -234,7 +273,7 @@ const navigationResources = specification.sections.flatMap(section =>
 );
 ```
 
-**Write to seedDataCore:**
+**Write seedDataCore to specification:**
 
 ```
 ba-writer.enrichSection({
@@ -254,6 +293,9 @@ ba-writer.enrichSection({
 })
 ```
 
+> **NOTE:** This step writes ONLY seedDataCore. The FULL specification write (actors, useCases, wireframes, sections, etc.) happens in step-03d section 11.
+> ALL data from 8a-8l MUST be carried forward to step-03d. Do NOT discard in-memory data.
+
 **Validation:**
 
 - EVERY section in `specification.sections[]` MUST appear in `navigationSections`
@@ -280,8 +322,9 @@ BDD acceptance tests per UC.
 >   ]
 > }
 > ```
-> **STRUCTURE:** Object with `feature` string + `scenarios[]` array. Each scenario has `given`, `when`, `then` as ARRAYS of strings.
+> **STRUCTURE:** MUST be an ARRAY of objects (NOT a single object). Each object has `feature` string + `scenarios[]` array. Each scenario has `given`, `when`, `then` as ARRAYS of strings.
 > **FORBIDDEN:** Do NOT use flat arrays of `{uc, scenario, given, when, then}` where given/when/then are single strings.
+> **FORBIDDEN:** Do NOT use a single object `{feature, scenarios}` — MUST be an ARRAY `[{feature, scenarios}]` even with one feature.
 
 #### 8h. Validations
 
@@ -405,6 +448,16 @@ Before loading step-03d-validate, verify all 12 subsections (8a-8l) are populate
 
 **IF any subsection is missing → STOP and request the missing data before proceeding.**
 
+**SCHEMA UNIFORMITY CHECK (multi-module mode):**
+IF this is NOT the first module in moduleOrder:
+  Compare THIS module's specification structure against the FIRST specified module:
+  - `gherkinScenarios` MUST be array (not object) in ALL modules
+  - `validations[].rules` MUST be array (not singular `rule`) in ALL modules
+  - `messages[]` MUST have `message` field in ALL modules
+  - `specification.apiEndpoints[]` MUST be present in ALL modules
+  - `specification.i18nKeys` MUST be present in ALL modules
+  IF any structural divergence detected → AUTO-FIX to match the canonical format before proceeding.
+
 ---
 
 ## NEXT STEP