@atlashub/smartstack-cli 4.41.0 → 4.42.0

package/templates/skills/{ba-generate-html → business-analyse-html}/html/src/scripts/11-review-panel.js

@@ -69,17 +69,19 @@ function renderReviewPanel() {
         return;
     }
 
-    container.innerHTML = filtered.map((c, i) => {
+    container.innerHTML = filtered.map(function(c, i) {
         const globalIndex = data.comments.indexOf(c);
         const sectionLabel = getSectionLabel(c.sectionId);
         const date = c.timestamp ? new Date(c.timestamp).toLocaleDateString('fr-FR', { day: '2-digit', month: '2-digit' }) : '';
+        var elId = c.elementId || c.cardIndex;
+        var safeElId = String(elId).replace(/[^a-zA-Z0-9_-]/g, '_');
 
         return `
-            <div class="review-comment-item" onclick="navigateToComment('${c.sectionId}', ${c.cardIndex})">
-                <div class="review-comment-section">${sectionLabel}</div>
-                <div class="review-comment-text">${c.content}</div>
+            <div class="review-comment-item" onclick="navigateToComment('${c.sectionId}', '${safeElId}')">
+                <div class="review-comment-section">${escapeHtml(sectionLabel)}</div>
+                <div class="review-comment-text">${escapeHtml(c.content)}</div>
                 <div class="review-comment-footer">
-                    <span class="review-comment-author">${c.author || 'Utilisateur'} - ${date}</span>
+                    <span class="review-comment-author">${escapeHtml(c.author || 'Utilisateur')} - ${escapeHtml(date)}</span>
                     <div class="review-comment-actions">
                         <button class="review-action-btn ${c.status === 'validated' ? 'reject' : 'validate'}"
                             onclick="event.stopPropagation();toggleCommentStatus(${globalIndex})"
@@ -135,29 +137,29 @@ function getSectionLabel(sectionId) {
     return sectionId;
 }
 
-function navigateToComment(sectionId, cardIndex) {
+function navigateToComment(sectionId, safeElId) {
     // Handle list-based sectionIds (ucList-*, brList-*, entList-*) → navigate to module + tab
     const listMatch = sectionId.match(/^(uc|br|ent)List-(.+)$/);
     if (listMatch) {
         const [, tabType, moduleCode] = listMatch;
         showSection('module-spec-' + moduleCode);
-        setTimeout(() => {
+        setTimeout(function() {
             switchTab(moduleCode, tabType);
-            scrollToCommentThread(sectionId, cardIndex);
+            scrollToCommentThread(sectionId, safeElId);
         }, 150);
     } else {
         showSection(sectionId);
-        scrollToCommentThread(sectionId, cardIndex);
+        scrollToCommentThread(sectionId, safeElId);
     }
 }
 
-function scrollToCommentThread(sectionId, cardIndex) {
-    setTimeout(() => {
-        const thread = document.getElementById('comment-thread-' + sectionId + '-' + cardIndex);
+function scrollToCommentThread(sectionId, safeElId) {
+    setTimeout(function() {
+        const thread = document.getElementById('comment-thread-' + sectionId + '-' + safeElId);
         if (thread && !thread.classList.contains('visible')) {
             thread.classList.add('visible');
         }
-        const container = document.querySelector(`.comment-btn-container[data-section-id="${sectionId}"][data-card-index="${cardIndex}"]`);
+        const container = document.querySelector('.comment-btn-container[data-section-id="' + sectionId + '"][data-element-id]');
         if (container) {
             container.scrollIntoView({ behavior: 'smooth', block: 'center' });
         }

package/templates/skills/business-analyse-html/html/src/styles/02-layout.css

@@ -0,0 +1,216 @@
+/* ============================================
+   LAYOUT
+   ============================================ */
+.app { display: flex; flex-direction: column; min-height: 100vh; }
+
+.header {
+    background: var(--bg-card);
+    border-bottom: 1px solid var(--border);
+    height: var(--header-height);
+    display: flex;
+    align-items: center;
+    padding: 0 1.5rem;
+    gap: 1rem;
+    position: sticky;
+    top: 0;
+    z-index: 100;
+}
+
+.header-logo {
+    width: 32px; height: 32px;
+    background: linear-gradient(135deg, var(--primary), var(--secondary));
+    border-radius: 6px;
+    display: flex; align-items: center; justify-content: center;
+    font-weight: 700; font-size: 0.85rem; color: #fff;
+    flex-shrink: 0;
+}
+
+.header-title { font-size: 1rem; font-weight: 600; color: var(--text-bright); }
+.header-sep { width: 1px; height: 24px; background: var(--border); }
+.header-app-name { font-size: 0.9rem; color: var(--primary-light); font-weight: 500; }
+.header-spacer { flex: 1; }
+
+.header-actions { display: flex; gap: 0.5rem; }
+
+.body { display: flex; flex: 1; }
+
+/* ============================================
+   SIDEBAR - Container
+   ============================================ */
+.sidebar {
+    width: var(--sidebar-width);
+    background: var(--bg-card);
+    border-right: 1px solid var(--border);
+    overflow-y: auto;
+    height: calc(100vh - var(--header-height));
+    position: sticky;
+    top: var(--header-height);
+    flex-shrink: 0;
+}
+
+.sidebar::-webkit-scrollbar { width: 4px; }
+.sidebar::-webkit-scrollbar-thumb { background: var(--border); border-radius: 4px; }
+
+/* ============================================
+   MAIN CONTENT - FULL WIDTH
+   ============================================ */
+.main {
+    flex: 1;
+    padding: 2rem 3rem;
+    overflow-y: auto;
+    height: calc(100vh - var(--header-height));
+}
+
+.section { margin-bottom: 4rem; }
+.section-title {
+    font-size: 1.4rem;
+    color: var(--text-bright);
+    font-weight: 600;
+    margin-bottom: 0.5rem;
+    padding-bottom: 0.5rem;
+    border-bottom: 2px solid var(--primary);
+}
+.section-subtitle {
+    font-size: 0.9rem;
+    color: var(--text-muted);
+    margin-bottom: 1.5rem;
+}
+
+/* ============================================
+   RESPONSIVE
+   ============================================ */
+.hamburger-btn {
+    display: none;
+    background: none;
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    color: var(--text);
+    font-size: 1.2rem;
+    padding: 0.2rem 0.5rem;
+    cursor: pointer;
+    flex-shrink: 0;
+}
+.sidebar-overlay {
+    display: none;
+    position: fixed;
+    inset: 0;
+    background: rgba(0,0,0,0.5);
+    z-index: 149;
+}
+.sidebar-overlay.visible { display: block; }
+
+@media (max-width: 768px) {
+    .hamburger-btn { display: block; }
+    .sidebar {
+        display: none;
+        position: fixed;
+        top: 0;
+        left: 0;
+        height: 100vh;
+        z-index: 150;
+        box-shadow: 4px 0 24px rgba(0,0,0,0.3);
+    }
+    .sidebar.mobile-open { display: block; }
+    .main { padding: 1rem; }
+    .form-row { grid-template-columns: 1fr; }
+    .stakeholder-grid { grid-template-columns: 1fr; }
+    .module-grid { grid-template-columns: 1fr; }
+    .stat-grid { grid-template-columns: repeat(2, 1fr); }
+    .dm-entity-grid { grid-template-columns: 1fr; }
+    .mock-form-row { grid-template-columns: 1fr; }
+    .mock-kpi-grid { grid-template-columns: repeat(2, 1fr); }
+    .header-actions { gap: 0.25rem; }
+    .header-actions .btn-sm { padding: 0.2rem 0.4rem; font-size: 0.7rem; }
+    .header-title { display: none; }
+    .header-sep { display: none; }
+}
+
+/* ============================================
+   SEARCH
+   ============================================ */
+.sidebar-search {
+    padding: 0.5rem 0.75rem;
+    border-bottom: 1px solid var(--border);
+}
+.sidebar-search input {
+    width: 100%;
+    padding: 0.4rem 0.6rem;
+    background: var(--bg-input);
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    color: var(--text);
+    font-size: 0.8rem;
+    font-family: inherit;
+}
+.sidebar-search input:focus {
+    outline: none;
+    border-color: var(--primary);
+}
+.nav-item.search-hidden { display: none; }
+.nav-group.search-hidden { display: none; }
+.search-highlight { background: rgba(234,179,8,0.3); border-radius: 2px; }
+
+/* ============================================
+   PROGRESS INDICATOR
+   ============================================ */
+.progress-bar-container {
+    width: 100%;
+    height: 8px;
+    background: var(--bg-hover);
+    border-radius: 4px;
+    overflow: hidden;
+    margin-bottom: 0.5rem;
+}
+.progress-bar-fill {
+    height: 100%;
+    background: linear-gradient(90deg, var(--primary), var(--success));
+    border-radius: 4px;
+    transition: width 0.5s ease;
+}
+.progress-label {
+    font-size: 0.8rem;
+    color: var(--text-muted);
+    margin-bottom: 0.75rem;
+}
+.progress-checks {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
+    gap: 0.3rem;
+}
+.progress-check {
+    font-size: 0.8rem;
+    color: var(--text-muted);
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+}
+.progress-check.done { color: var(--success); }
+.progress-check-icon { font-size: 0.9rem; width: 16px; text-align: center; }
+
+/* ============================================
+   PRINT
+   ============================================ */
+@media print {
+    .sidebar, .header-actions, .add-btn, .uc-actions, .inline-form, .module-card-remove, .hamburger-btn, .sidebar-search { display: none !important; }
+    .main { max-width: 100%; padding: 0.5cm; height: auto; overflow: visible; }
+    .body { display: block; }
+    .section { display: block !important; page-break-inside: avoid; margin-bottom: 1cm; }
+    .section + .section { page-break-before: auto; }
+    body { background: #fff !important; color: #1a1a1a !important; }
+    * { color-adjust: exact; -webkit-print-color-adjust: exact; }
+    .card, .uc-item, .br-item, .module-card, .entity-block, .interaction-item {
+        border-color: #ddd !important;
+        background: #fff !important;
+        color: #1a1a1a !important;
+    }
+    .card-label, .uc-detail-label, .section-subtitle, .form-label { color: #666 !important; }
+    .section-title { color: #1a1a1a !important; border-bottom-color: #333 !important; }
+    .tab-panel { display: block !important; page-break-inside: avoid; }
+    .tab-bar { display: none !important; }
+    .review-panel, .comment-btn-container, .notification, .wireframe-comment, [contenteditable] { display: none !important; }
+    .editable { border: none !important; padding: 0 !important; }
+    .header { position: static; background: #fff !important; border-bottom-color: #ddd !important; }
+    .header-logo { background: #333 !important; }
+    .header-title, .header-app-name { color: #1a1a1a !important; }
+    a { text-decoration: none !important; color: inherit !important; }
+}

package/templates/skills/{ba-generate-html → business-analyse-html}/html/src/styles/05-modules.css

@@ -442,3 +442,39 @@
     font-size: 0.8rem;
     color: var(--text-muted);
 }
+
+/* ============================================
+   SECTION GROUPS (Hierarchical Mode)
+   ============================================ */
+.section-group {
+    margin-bottom: 1.5rem;
+    border-left: 3px solid var(--primary);
+    padding-left: 0;
+}
+.section-group-header {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.5rem 0.75rem;
+    background: rgba(99,102,241,0.05);
+    border-bottom: 1px solid var(--border);
+    margin-bottom: 0.5rem;
+    border-radius: 0 6px 0 0;
+}
+.section-group-icon {
+    font-size: 0.6rem;
+    color: var(--primary-light);
+}
+.section-group-label {
+    font-weight: 600;
+    color: var(--primary-light);
+    font-size: 0.9rem;
+}
+.section-group-route {
+    font-size: 0.7rem;
+    color: var(--text-muted);
+    font-family: 'Courier New', monospace;
+    background: var(--bg-input);
+    padding: 0.1rem 0.4rem;
+    border-radius: 3px;
+}

package/templates/skills/{ba-generate-html → business-analyse-html}/html/src/template.html

@@ -13,20 +13,21 @@
         <!-- ============================================
              HEADER
              ============================================ -->
-        <header class="header">
-            <div class="header-logo">BA</div>
+        <header class="header" role="banner">
+            <button class="hamburger-btn" onclick="toggleMobileSidebar()" aria-label="Ouvrir le menu de navigation">&#9776;</button>
+            <div class="header-logo" aria-hidden="true">BA</div>
             <span class="header-title">Analyse métier</span>
             <div class="header-sep"></div>
             <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="Réinitialiser depuis les données 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 créer une nouvelle version">Sauvegarder corrections</button>
-                <button class="btn btn-sm btn-primary" onclick="exportJSON()" title="Exporter les données au format JSON pour l'extraction">Exporter JSON</button>
-                <button class="btn btn-sm review-toggle-btn" id="reviewToggleBtn" onclick="toggleReviewPanel()" title="Ouvrir/fermer le panneau de review">
+                <button class="btn btn-sm" onclick="resetToEmbedded()" title="Réinitialiser depuis les données d'origine (supprime les modifications locales)" aria-label="Réinitialiser les données">Reset</button>
+                <button class="btn btn-sm" onclick="saveToLocalStorage()" title="Sauvegarder les modifications dans le navigateur" aria-label="Sauvegarder">Sauvegarder</button>
+                <button class="btn btn-sm btn-review" onclick="saveReviewJSON()" title="Sauvegarder les corrections pour créer une nouvelle version" aria-label="Sauvegarder les corrections">Sauvegarder corrections</button>
+                <button class="btn btn-sm btn-primary" onclick="exportJSON()" title="Exporter les données au format JSON pour l'extraction" aria-label="Exporter en JSON">Exporter JSON</button>
+                <button class="btn btn-sm review-toggle-btn" id="reviewToggleBtn" onclick="toggleReviewPanel()" title="Ouvrir/fermer le panneau de review" aria-label="Panneau de review">
                     Review
-                    <span class="review-badge hidden" id="reviewBadge">0</span>
+                    <span class="review-badge hidden" id="reviewBadge" aria-live="polite">0</span>
                 </button>
             </div>
         </header>
@@ -35,11 +36,16 @@
             <!-- ============================================
                  SIDEBAR - Navigation hiérarchique
                  ============================================ -->
-            <aside class="sidebar">
+            <div class="sidebar-overlay" id="sidebarOverlay" onclick="toggleMobileSidebar()"></div>
+            <aside class="sidebar" id="sidebarAside" role="navigation" aria-label="Navigation principale">
                 <!-- Application Name -->
                 <div class="sidebar-header">
                     <span class="sidebar-app-name" id="sidebarAppName">{{APPLICATION_NAME}}</span>
                 </div>
+                <!-- Search -->
+                <div class="sidebar-search">
+                    <input type="search" id="sidebarSearchInput" placeholder="Rechercher..." oninput="filterNavItems(this.value)" aria-label="Rechercher dans le document">
+                </div>
                 <!-- Dynamic Tree Navigation -->
                 <div id="sidebarNav">
                     <!-- Populated by buildNavTree() -->
@@ -49,7 +55,7 @@
             <!-- ============================================
                  MAIN CONTENT
                  ============================================ -->
-            <main class="main" id="mainContent">
+            <main class="main" id="mainContent" role="main">
 
                 <!-- SECTION: Contexte (merged: problem + current + vision) -->
                 <div class="section" id="cadrage-context">
@@ -370,6 +376,10 @@
                     <h2 class="section-title">Synthèse de l'analyse</h2>
                     <p class="section-subtitle">Vue d'ensemble de toute l'analyse métier, prête pour le développement.</p>
 
+                    <div class="card" style="margin-bottom:1.5rem;" id="progressIndicator">
+                        <!-- Populated by renderProgressIndicator() -->
+                    </div>
+
                     <div class="stat-grid" id="handoffStats">
                         <!-- Populated dynamically -->
                     </div>
@@ -396,10 +406,10 @@
             <!-- ============================================
                  REVIEW PANEL (right sidebar)
                  ============================================ -->
-            <aside class="review-panel" id="reviewPanel">
+            <aside class="review-panel" id="reviewPanel" role="complementary" aria-label="Panneau de review">
                 <div class="review-panel-header">
                     <span class="review-panel-title">Review</span>
-                    <button class="review-panel-close" onclick="toggleReviewPanel()" title="Fermer">&times;</button>
+                    <button class="review-panel-close" onclick="toggleReviewPanel()" title="Fermer" aria-label="Fermer le panneau de review">&times;</button>
                 </div>
                 <div class="review-filters">
                     <button class="review-filter-btn active" onclick="filterReviewComments('all')" data-filter="all">Tous</button>

package/templates/skills/{ba-generate-html → business-analyse-html}/references/data-build.md

@@ -1,6 +1,6 @@
 # FEATURE_DATA & EMBEDDED_ARTIFACTS Build Reference
 
-> Reference for `/ba-generate-html` skill (step-02-build-data) — complete mapping specification for the interactive HTML.
+> Reference for `/business-analyse-html` skill (step-02-build-data) — complete mapping specification for the interactive HTML.
 > **Canonical field mapping reference:** See also `data-mapping.md` for the authoritative field name mapping between module JSON files and HTML data objects.
 
 ## FEATURE_DATA Object

package/templates/skills/{ba-generate-html → business-analyse-html}/references/data-mapping.md

@@ -1,6 +1,6 @@
 # HTML Data Mapping Reference
 
-> **Used by:** `/ba-generate-html` skill (step-02-build-data)
+> **Used by:** `/business-analyse-html` skill (step-02-build-data)
 > **Purpose:** Exact mapping from module JSON files to HTML FEATURE_DATA and EMBEDDED_ARTIFACTS objects
 
 ---
@@ -102,6 +102,7 @@ const mod = collected_data.modules[moduleCode];
 moduleSpecs[moduleCode] = {
   useCases: (mod.usecases?.useCases || []).map(uc => ({
     name: uc.name,
+    sectionCode: uc.sectionCode || "",                  // links UC to anticipatedSections[].code
     actor: uc.primaryActor,
     steps: (uc.mainScenario || []).join("\n"),           // array → newline-separated string
     alternative: (uc.alternativeScenarios || [])
@@ -109,6 +110,7 @@ moduleSpecs[moduleCode] = {
   })),
   businessRules: (mod.rules?.rules || []).map(br => ({
     name: br.name,
+    sectionCode: br.sectionCode || "",                  // links BR to anticipatedSections[].code
     category: br.category,                              // "validation"|"calculation"|"workflow"|"security"|"data"
     statement: br.statement,
     example: (br.examples || []).map(e => e.input + " → " + e.expected).join("; ")
@@ -164,6 +166,8 @@ function buildPermissionKeys(permissionsData) {
 }
 ```
 
+> **Language handling:** The actionMap should use `metadata.language` to select the correct labels. For `fr`: Consulter/Créer/Modifier/Supprimer. For `en`: Read/Create/Update/Delete. Default to English if language is unknown.
+
 ### Frequency Mapping
 
 ```

package/templates/skills/{ba-generate-html → business-analyse-html}/references/output-modes.md

@@ -1,12 +1,12 @@
 # Deploy Mode Support & Troubleshooting
 
-> Reference for `/ba-generate-html` skill (HTML deployment) and `/derive-prd` skill (handoff + PRD generation) — mode variations and common issues.
+> Reference for `/business-analyse-html` skill (HTML deployment) and `/business-analyse-handoff` skill (handoff + PRD generation) — mode variations and common issues.
 
 ## Mode Support
 
 ### Standard Mode
 
-Full handoff with all implementation details (via `/derive-prd`):
+Full handoff with all implementation details (via `/business-analyse-handoff`):
 - All 8 file categories (including documentation)
 - Complete BR-to-code mapping
 - Full API endpoint summary
@@ -20,7 +20,7 @@ Simplified handoff with minimal scope:
 - 3 core SeedData entries (omit some optional ones)
 - Basic prd.json with simplified sections
 - Lightweight progress.txt
-- Display `/ralph-loop` command for later use
+- Display `/business-analyse-develop` command for later use
 
 ### Delta Mode (use_case = refactoring)
 
@@ -95,8 +95,8 @@ Full handoff across multiple applications within a project:
 - `rolePermissions[]` are scoped per application (same role can have different permissions per app)
 - Seed data order: applications in topological order, then modules within each application
 
-**ralph-loop execution (recommended):**
-- Run `/ralph-loop` once per application (module-by-module within each app)
+**business-analyse-develop execution (recommended):**
+- Run `/business-analyse-develop` once per application (module-by-module within each app)
 - Cross-application PRD runs last after all applications are implemented
 - Application order follows `applicationDependencyGraph.topologicalOrder`
 
@@ -104,8 +104,8 @@ Full handoff across multiple applications within a project:
 
 | Issue | Resolution |
 |-------|-----------|
-| All modules missing handoff data | Run `/derive-prd` skill. Handoff MUST be written to each module's handoff.json. |
-| prd.json generation failed | Run `/derive-prd`. Verify ss derive-prd command is installed and index.json path is correct. |
+| All modules missing handoff data | Run `/business-analyse-handoff` skill. Handoff MUST be written to each module's handoff.json. |
+| prd.json generation failed | Run `/business-analyse-handoff`. Verify ss business-analyse-handoff command is installed and index.json path is correct. |
 | progress.txt incomplete | Ensure all CORE SeedData entries are present: 2 app-level (NavigationApplication + ApplicationRoles) + per module (NavigationModule + NavigationSections + Permissions + Roles). Check topological order. |
 | BA manifest not found | Create docs/index.json if missing. Use schema provided in section 3. |
 | Manifest entries incorrect | Verify appCode, moduleCode, and version match index.json metadata exactly. |

package/templates/skills/{ba-generate-html → business-analyse-html}/steps/step-01-collect.md

@@ -72,14 +72,36 @@ FOR each module in master.index.modules[]:
   moduleIndex = READ(moduleDir + "index.json")
 
   // Read ALL flat files from module directory
-  collected_data.modules[module.code] = {
+  const moduleData = {
     index: moduleIndex,
     entities: READ(moduleDir + "entities.json") || { entities: [] },
     rules: READ(moduleDir + "rules.json") || { rules: [] },
     usecases: READ(moduleDir + "usecases.json") || { useCases: [] },
     permissions: READ(moduleDir + "permissions.json") || { roles: [], permissions: [], matrix: [] },
     screens: READ(moduleDir + "screens.json") || { screens: [] }
+  };
+
+  // POST-COLLECT VALIDATION: detect missing mandatory data for specified modules
+  const moduleStatus = moduleIndex?.metadata?.status || moduleIndex?.status || "unknown";
+  const warnings = [];
+  if (["specified", "consolidated", "designed", "reviewed", "handed-off"].includes(moduleStatus)) {
+    if ((moduleData.entities.entities || []).length === 0)
+      warnings.push("entities.json is EMPTY for specified module " + module.code);
+    if ((moduleData.usecases.useCases || []).length === 0)
+      warnings.push("usecases.json is EMPTY for specified module " + module.code);
+    if ((moduleData.rules.rules || []).length === 0)
+      warnings.push("rules.json is EMPTY for specified module " + module.code);
   }
+  if (warnings.length > 0) {
+    Display("⚠ WARNING — Missing data for module " + module.code + ":");
+    warnings.forEach(w => Display("  - " + w));
+    Display("The HTML document will have incomplete sections for this module.");
+  }
+
+  collected_data.modules[module.code] = moduleData;
+
+// Read navigation.json if present (written by /business-analyse-design)
+collected_data.navigation = READ(docs_dir + '/navigation.json') || null;
 ```
 
 ### 5. Display Collection Summary
@@ -88,6 +110,7 @@ FOR each module in master.index.modules[]:
 JSON collected:
   Master: index.json + cadrage.json
   Modules: {module_count} modules (flat files: entities, rules, usecases, permissions, screens)
+  Warnings: {total_warnings} (see above if any)
 → Proceeding to data build...
 ```
 
@@ -97,6 +120,7 @@ JSON collected:
 
 - BLOCK if index.json absent
 - BLOCK if 0 modules found
+- WARN (non-blocking) if specified module has empty mandatory files
 - BLOCK if feature not consolidated
 
 ## NEXT STEP

package/templates/skills/{ba-generate-html → business-analyse-html}/steps/step-02-build-data.md

@@ -33,13 +33,22 @@ metadata: {
 }
 ```
 
-**cadrage.context** (lean format):
+**cadrage.context** (lean format — MANDATORY fields logged if empty):
 ```javascript
+const problem = master.cadrage.problem || "";
+const trigger = master.cadrage.trigger || "";
+const currentSituation = master.cadrage.asIs || "";
+const desiredSituation = master.cadrage.toBe || "";
+
+// MANDATORY field check — warn if core cadrage data is empty
+if (!problem) console.warn("⚠ cadrage.problem is empty — HTML will show blank problem section");
+if (!currentSituation && !desiredSituation) console.warn("⚠ cadrage has no current/desired situation");
+
 context: {
-  problem: master.cadrage.problem || "",
-  trigger: master.cadrage.trigger || "",
-  currentSituation: master.cadrage.asIs || "",        // asIs → currentSituation
-  desiredSituation: master.cadrage.toBe || "",        // toBe → desiredSituation
+  problem: problem,
+  trigger: trigger,
+  currentSituation: currentSituation,                 // asIs → currentSituation
+  desiredSituation: desiredSituation,                  // toBe → desiredSituation
   painPoints: (master.cadrage.stakeholders || []).flatMap(s => s.painPoints || []).join("\n"),
   acceptanceCriteria: (master.cadrage.acceptanceCriteria || []).map(ac => ac.criterion).join("\n")
 }
@@ -101,12 +110,14 @@ const mod = collected_data.modules[moduleCode];
 moduleSpecs[moduleCode] = {
   useCases: (mod.usecases?.useCases || []).map(uc => ({
     name: uc.name,
+    sectionCode: uc.sectionCode || "",
     actor: uc.primaryActor,
     steps: (uc.mainScenario || []).join("\n"),
     alternative: (uc.alternativeScenarios || []).map(a => a.name + ": " + (a.steps || []).join(", ")).join("\n")
   })),
   businessRules: (mod.rules?.rules || []).map(br => ({
     name: br.name,
+    sectionCode: br.sectionCode || "",
     category: br.category,
     statement: br.statement,
     example: (br.examples || []).map(e => e.input + " → " + e.expected).join("; ")
@@ -128,6 +139,23 @@ moduleSpecs[moduleCode] = {
 
 > See `references/data-mapping.md` for `buildPermissionKeys()` implementation.
 
+**Enrich anticipatedSections with section-level UC/BR (AFTER moduleSpecs is built):**
+
+```javascript
+// Post-processing: populate each section's useCases[] and businessRules[]
+// using the sectionCode field from moduleSpecs
+FEATURE_DATA.modules.forEach(m => {
+  const spec = FEATURE_DATA.moduleSpecs[m.code];
+  if (!spec) return;
+  (m.anticipatedSections || []).forEach(section => {
+    section.useCases = (spec.useCases || []).filter(uc => uc.sectionCode === section.code);
+    section.businessRules = (spec.businessRules || []).filter(br => br.sectionCode === section.code);
+  });
+});
+```
+
+> This step is CRITICAL for the HTML viewer to display UC/BR grouped by section.
+
 **consolidation:**
 ```javascript
 consolidation: {

package/templates/skills/{ba-generate-html → business-analyse-html}/steps/step-03-render.md

@@ -18,8 +18,8 @@ Inject FEATURE_DATA and EMBEDDED_ARTIFACTS into the HTML template and write the
 ### 1. Locate Template
 
 ```
-1. Primary: ~/.claude/skills/ba-generate-html/html/ba-interactive.html
-2. Fallback: templates/skills/ba-generate-html/html/ba-interactive.html (project CLI path)
+1. Primary: ~/.claude/skills/business-analyse-html/html/ba-interactive.html
+2. Fallback: templates/skills/business-analyse-html/html/ba-interactive.html (project CLI path)
 3. IF neither found → BLOCKING ERROR: "HTML template not found"
 ```
 

package/templates/skills/{ba-generate-html → business-analyse-html}/steps/step-04-verify.md

@@ -76,8 +76,8 @@ Modules: {count} ({names})
   1. Open ba-interactive.html in browser
   2. Review all modules, use cases, business rules
   3. Validate wireframes and permissions
-  4. If OK: /derive-prd then /ralph-loop to begin development
-  5. If changes needed: /business-analyse to iterate
+  4. If approved: /business-analyse-handoff then /business-analyse-develop to begin development
+  5. If corrections needed: export ba-review.json from the HTML, then run /business-analyse-review
 
 ══════════════════════════════════════════════════════════════
 ```