@atlashub/smartstack-cli 4.81.0 → 5.0.0

package/templates/skills/business-analyse-html/references/output-modes.md

@@ -1,119 +0,0 @@
-# Deploy Mode Support & Troubleshooting
-
-> 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 `/business-analyse-handoff`):
-- All 8 file categories (including documentation)
-- Complete BR-to-code mapping
-- Full API endpoint summary
-- Detailed prd.json
-- Comprehensive progress tracker
-
-### Micro Mode (use_case = micro)
-
-Simplified handoff with minimal scope:
-- Only essential CRUD entity + controller
-- 3 core SeedData entries (omit some optional ones)
-- Basic prd.json with simplified sections
-- Lightweight progress.txt
-- Display `/business-analyse-develop` command for later use
-
-### Delta Mode (use_case = refactoring)
-
-Focused handoff for changes:
-- Only affected modules listed
-- Reuse existing implementation patterns
-- Highlight what changed vs baseline
-- Update only affected prd.json sections
-- Progress tracker shows only delta tasks
-
-### Multi-Application Mode (workflow.mode = "project")
-
-Full handoff across multiple applications within a project:
-
-**Artifacts generated:**
-- Per-module: `.ralph/prd-{moduleCode}.json` (one per module across all applications)
-- Per-application cross-module: `.ralph/prd-CrossModule-{appCode}.json` (if app has 2+ modules)
-- Cross-application: `.ralph/prd-CrossApplication.json` (integration tests between applications)
-- Progress tracker: `.ralph/progress.txt` (grouped by application, then by module)
-- BA manifest: `docs/index.json` (project-level entry + per-application + per-module entries)
-- Interactive HTML: one HTML file per application at `docs/{app}/business-analyse/v{version}/ba-interactive.html`
-
-**Project-level manifest entry:**
-```json
-{
-  "scope": "project",
-  "projectId": "PROJ-001",
-  "projectName": "HR Platform",
-  "version": "1.0",
-  "status": "handed-off",
-  "applications": ["HumanResources", "EmployeeSelfService"],
-  "path": "business-analyse/v1.0/index.json",
-  "updatedAt": "2026-02-16T..."
-}
-```
-
-**Progress tracker structure (multi-app):**
-```
-# Progress Tracker — {projectName}
-
-## Application: {app1Name} ({app1Context})
-
-### Module: {module1} (Layer 0 — simple)
-- [ ] Domain: Entity1.cs
-- [ ] Application: Entity1Service.cs
-...
-
-### Module: {module2} (Layer 1 — medium)
-...
-
-## Application: {app2Name} ({app2Context})
-...
-
-## Cross-Application Integration
-- [ ] SharedEntityValidationTests.cs
-- [ ] CrossAppPermissionTests.cs
-- [ ] CrossAppE2EFlowTests.cs
-
-## Summary
-| Application | Modules | Files | Tasks | Complexity |
-|-------------|---------|-------|-------|------------|
-| {app1}      | {n}     | {n}   | {n}   | {level}    |
-| {app2}      | {n}     | {n}   | {n}   | {level}    |
-| Cross-App   | —       | 3     | 3     | —          |
-| **Total**   | {n}     | {n}   | {n}   | {global}   |
-```
-
-**seedDataCore differences:**
-- `navigationApplications[]` has one entry per application
-- `navigationModules[]` includes `applicationCode` field for each module
-- `permissions[]` use per-application prefixes (e.g., `hr.*` vs `admin.*`)
-- `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
-
-**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`
-
-## Troubleshooting
-
-| Issue | Resolution |
-|-------|-----------|
-| 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. |
-| ba-interactive.html is too small (< 100KB) | FEATURE_DATA not serialized correctly. Verify JSON structure. Re-run FEATURE_DATA build. |
-| moduleSpecs missing from HTML | FEATURE_DATA.moduleSpecs is empty or not included in JSON. Verify each module is iterated and populated. |
-| Scope keys still show "inScope" instead of "inscope" | Conversion from JSON keys to HTML keys failed. Check cadrage.scope conversion logic. |
-| Wireframes array is empty | Verify each module has screens.json with wireframe data (Format A: screens[].mockup, Format B: sections[].wireframe). If missing, step-02 will auto-generate text descriptions from columns/tabs. |
-| Mockups show ASCII instead of HTML tables | screens[] in moduleSpecs has empty resources. Verify screens.json format was normalized correctly (Format A: screens[] or Format B: sections[]) by step-02. |
-| dependencyGraph missing | Verify master index.json has consolidation.dependencyGraph. If missing, create empty nodes/edges arrays. |
-| HTML opens but data blank (localStorage issue) | Clear browser localStorage. HTML will load pre-populated FEATURE_DATA on first load. |
-| Export/re-import fails | Verify exported JSON matches original schema. Validate with `/business-analyse -x --validate`. |

package/templates/skills/business-analyse-html/references/wireframe-svg-style-guide.md

@@ -1,335 +0,0 @@
-# Wireframe SVG Style Guide
-
-> **Purpose:** Self-contained specification for generating professional SVG wireframes from ASCII art.
-> This document is sent as the FULL prompt to a Sonnet Task agent alongside the ASCII wireframe.
-> Referenced by: `step-05-deploy.md` (Section 8: Generate SVG Wireframes)
-
-## Agent Prompt Template
-
-> **USAGE:** Read this section, replace `{placeholders}` with actual wireframe data, send as the complete prompt to a Task(sonnet) agent. The agent returns ONLY the SVG markup string.
-
----
-
-You are a professional UI wireframe designer. Convert the following ASCII wireframe into a high-quality SVG wireframe that looks like a modern web application mockup.
-
-### Input
-
-**Screen name:** `{screenName}`
-**Module:** `{moduleName}`
-**Section type:** `{sectionType}` (list|detail|create|dashboard|approve)
-**ASCII wireframe:**
-```
-{asciiContent}
-```
-
-**Element metadata (if available):**
-```json
-{elementsJson}
-```
-
-### Output Requirements
-
-Return ONLY the SVG markup as a single `<svg>` element. No explanation, no markdown, no code fences.
-The SVG must be self-contained (no external fonts, no external CSS, no `<image>` tags).
-
-### Visual Design System
-
-#### Viewport & Canvas
-- `viewBox="0 0 960 {dynamicHeight}"` — width fixed at 960, height adapts to content
-- Minimum height: 540 for list views, 720 for detail views, 480 for dashboards
-- Background: `#1e293b` (dark card background matching the HTML theme)
-- 24px padding on all sides
-- Root element: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 {height}">`
-
-#### Color Palette (MUST use these exact colors)
-
-| Role | Color | Usage |
-|------|-------|-------|
-| Background | `#1e293b` | Main canvas, card backgrounds |
-| Surface | `#0f172a` | Input fields, table cells, nested panels |
-| Border | `#334155` | All borders, dividers, table lines |
-| Border light | `#475569` | Hover states, active borders |
-| Primary | `#6366f1` | Primary buttons, active tabs, selected items |
-| Primary hover | `#4f46e5` | Button hover state accent |
-| Primary light | `#818cf8` | Links, column headers, highlighted text |
-| Accent | `#06b6d4` | Secondary actions, info badges |
-| Text bright | `#e2e8f0` | Headings, table header text, important labels |
-| Text | `#b8c4d1` | Body text, table cell content |
-| Text muted | `#8a9bb0` | Placeholders, secondary labels, pagination |
-| Success | `#22c55e` | Active/approved status badges |
-| Success bg | `rgba(34,197,94,0.15)` | Status badge background |
-| Warning | `#eab308` | Pending/draft status badges |
-| Warning bg | `rgba(234,179,8,0.15)` | Status badge background |
-| Error | `#ef4444` | Error states, delete buttons |
-| Gray | `#94a3b8` | Inactive/draft status |
-| Gray bg | `rgba(100,116,139,0.15)` | Status badge background |
-| Row hover | `rgba(99,102,241,0.05)` | Table row hover |
-| Shadow | `rgba(0,0,0,0.25)` | Drop shadow for cards |
-
-#### Typography (embedded via system fonts)
-
-- Font family: `'Inter', 'Segoe UI', system-ui, sans-serif` (use `font-family` attribute on EVERY `<text>`)
-- Page title: 18px, font-weight 600, color `#e2e8f0`
-- Section heading: 14px, font-weight 600, color `#e2e8f0`
-- Table header: 11px, font-weight 600, text-transform uppercase, letter-spacing 0.05em, color `#8a9bb0`
-- Body text / table cells: 13px, font-weight 400, color `#b8c4d1`
-- Button text: 13px, font-weight 500, color `#ffffff`
-- Small text / badges: 11px, font-weight 500
-- Placeholder text: 13px, font-weight 400, color `#8a9bb0`, font-style italic
-
----
-
-### Component Patterns
-
-#### Buttons (Primary)
-```xml
-<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="#6366f1"/>
-<text x="{x+w/2}" y="{y+22}" text-anchor="middle"
-      font-family="Inter,Segoe UI,system-ui,sans-serif" font-size="13"
-      font-weight="500" fill="#ffffff">{label}</text>
-```
-
-#### Buttons (Secondary/Ghost)
-```xml
-<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="none" stroke="#334155" stroke-width="1"/>
-<text x="{x+w/2}" y="{y+22}" text-anchor="middle"
-      font-family="Inter,Segoe UI,system-ui,sans-serif" font-size="13"
-      font-weight="500" fill="#b8c4d1">{label}</text>
-```
-
-#### Input Fields
-```xml
-<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
-<text x="{x+12}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="13" fill="#8a9bb0" font-style="italic">{placeholder}</text>
-```
-
-#### Search Bar (input with magnifying glass icon)
-```xml
-<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
-<circle cx="{x+22}" cy="{y+18}" r="7" fill="none" stroke="#8a9bb0" stroke-width="1.5"/>
-<line x1="{x+27}" y1="{y+23}" x2="{x+31}" y2="{y+27}" stroke="#8a9bb0" stroke-width="1.5" stroke-linecap="round"/>
-<text x="{x+40}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="13" fill="#8a9bb0" font-style="italic">Rechercher...</text>
-```
-
-#### Dropdown / Select
-```xml
-<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
-<text x="{x+12}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="13" fill="#b8c4d1">{selectedValue}</text>
-<path d="M{x+w-24},{y+16} l6,8 l6,-8" fill="#8a9bb0"/>
-```
-
-#### Data Table
-- Header row: background `#0f172a`, text uppercase 11px, color `#8a9bb0`, letter-spacing 0.05em
-- Data rows: alternating `#1e293b` and `rgba(15,23,42,0.5)`, height 44px
-- Row hover: one sample row with `rgba(99,102,241,0.05)` fill
-- Column dividers: `stroke="#334155"` at 0.5 opacity
-- Cell padding: 16px horizontal
-- Header height: 40px
-- Action column (rightmost): 3-dot vertical ellipsis menu icon
-
-#### Status Badges
-```xml
-<!-- Active/Approved (green) -->
-<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(34,197,94,0.15)"/>
-<circle cx="{x+10}" cy="{y+11}" r="3" fill="#4ade80"/>
-<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="11" font-weight="500" fill="#4ade80">{label}</text>
-
-<!-- Pending/Warning (yellow) -->
-<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(234,179,8,0.15)"/>
-<circle cx="{x+10}" cy="{y+11}" r="3" fill="#facc15"/>
-<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="11" font-weight="500" fill="#facc15">{label}</text>
-
-<!-- Inactive/Draft (gray) -->
-<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(100,116,139,0.15)"/>
-<circle cx="{x+10}" cy="{y+11}" r="3" fill="#94a3b8"/>
-<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="11" font-weight="500" fill="#94a3b8">{label}</text>
-```
-
-#### Cards / Panels
-```xml
-<defs>
-  <filter id="shadow" x="-2%" y="-2%" width="104%" height="104%">
-    <feDropShadow dx="0" dy="2" stdDeviation="4" flood-color="#000000" flood-opacity="0.25"/>
-  </filter>
-</defs>
-<rect x="{x}" y="{y}" width="{w}" height="{h}" rx="12" fill="#1e293b" stroke="#334155" stroke-width="1" filter="url(#shadow)"/>
-```
-
-#### Tabs
-```xml
-<!-- Active tab -->
-<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="#6366f1"/>
-<text x="{x+w/2}" y="{y+22}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="13" font-weight="500" fill="#ffffff">{label}</text>
-
-<!-- Inactive tab -->
-<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="transparent"/>
-<text x="{x+w/2}" y="{y+22}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="13" font-weight="400" fill="#8a9bb0">{label}</text>
-```
-
-#### Pagination
-```xml
-<text x="{x}" y="{y}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="12" fill="#8a9bb0">1-25 de 142</text>
-<!-- Active page -->
-<rect x="{px}" y="{py}" width="28" height="28" rx="6" fill="#6366f1"/>
-<text x="{px+14}" y="{py+18}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="12" font-weight="500" fill="#fff">1</text>
-<!-- Inactive page -->
-<rect x="{px+32}" y="{py}" width="28" height="28" rx="6" fill="none" stroke="#334155"/>
-<text x="{px+46}" y="{py+18}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="12" fill="#8a9bb0">2</text>
-```
-
-#### KPI Cards (Dashboard)
-```xml
-<rect x="{x}" y="{y}" width="{w}" height="80" rx="8" fill="#334155"/>
-<text x="{x+w/2}" y="{y+35}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="22" font-weight="700" fill="#e2e8f0">{value}</text>
-<text x="{x+w/2}" y="{y+55}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="11" fill="#8a9bb0">{label}</text>
-```
-
-#### Chart Placeholder (Dashboard)
-```xml
-<rect x="{x}" y="{y}" width="{w}" height="180" rx="8" fill="none"
-      stroke="#334155" stroke-dasharray="6,4"/>
-<text x="{x+w/2}" y="{y+90}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="13" fill="#8a9bb0">{chartLabel}</text>
-```
-
-#### Back Button / Navigation
-```xml
-<path d="M{x},{y+10} l-8,-10 l8,-10" fill="none" stroke="#818cf8" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
-<text x="{x+8}" y="{y+5}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="13" font-weight="500" fill="#818cf8">Retour a la liste</text>
-```
-
-#### Form Layout (2-column)
-```xml
-<!-- Label -->
-<text x="{x}" y="{y}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="12" font-weight="500" fill="#8a9bb0">{fieldLabel}</text>
-<!-- Input below label (12px gap) -->
-<rect x="{x}" y="{y+8}" width="{colWidth}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
-<text x="{x+12}" y="{y+33}" font-family="Inter,Segoe UI,system-ui,sans-serif"
-      font-size="13" fill="#b8c4d1">{value or placeholder}</text>
-```
-
----
-
-### Section-Specific Layout Rules
-
-**List Page Layout:**
-1. Page header (title left + primary action button right) at y=24
-2. Filter bar below header (search + dropdowns) at y=72
-3. Data table occupying remaining space at y=128
-4. Pagination bar at bottom
-
-**Detail Page Layout:**
-1. Back button + breadcrumb at y=24
-2. Entity header (code + name + status badge + action buttons) at y=60
-3. Horizontal divider at y=100
-4. Tab bar at y=112
-5. Active tab content area at y=160
-
-**Create/Edit Form Layout:**
-1. Form title at y=24
-2. Two-column grid of form fields (label above input) starting at y=64
-3. Horizontal divider before actions
-4. Cancel + Submit buttons right-aligned at bottom
-
-**Dashboard Layout:**
-1. KPI cards in a 4-column grid at y=24
-2. 2-column grid of chart placeholders at y=128
-3. Optional filter bar above KPIs
-
----
-
-### Quality Rules (MANDATORY)
-
-1. **Every `<text>` element** MUST have the `font-family` attribute set
-2. **No external dependencies** — no `<use>`, no `<image>`, no `xlink:href`
-3. **All text must be readable** — contrast ratio >=4.5:1 on its background
-4. **Consistent spacing** — 24px margin, 16px padding, 12px gap between form fields
-5. **Rounded corners everywhere** — `rx="6"` minimum for interactive elements, `rx="12"` for cards
-6. **No `<style>` blocks** — all styling via inline attributes (inline SVG in HTML can conflict with host CSS)
-7. **viewBox only, no width/height on root `<svg>`** — let the container handle sizing
-8. **Use realistic but fictional data** — French locale, Swiss franc format (12'500.00 CHF), European dates (15.01.2026)
-9. **Match the ASCII structure exactly** — same number of columns, same sections, same buttons. Do not add or remove UI elements.
-10. **Ensure table columns match** — if ASCII shows 5 columns, SVG must show exactly 5 columns with the same headers
-
----
-
-### Fallback
-
-If you cannot produce a valid SVG (e.g., ASCII is too ambiguous or malformed), return EXACTLY the string:
-```
-FALLBACK_ASCII
-```
-This signals the system to use the ASCII wireframe instead.
-
----
-
-## Orchestration Instructions
-
-> **FOR the agent executing step-03 or step-05**: Follow this process to generate SVGs.
-
-### Step-by-step process:
-
-1. **Read** this file to get the prompt template (the "Agent Prompt Template" section above)
-
-2. **Collect** all wireframes that need SVG:
-```javascript
-const wireframesToProcess = [];
-for (const [moduleCode, wireframes] of Object.entries(EMBEDDED_ARTIFACTS.wireframes)) {
-  for (let i = 0; i < wireframes.length; i++) {
-    const wf = wireframes[i];
-    if (wf.content && !wf.svgContent) {
-      wireframesToProcess.push({ moduleCode, index: i, wf });
-    }
-  }
-}
-```
-
-3. **Spawn parallel Task(sonnet) agents** — ONE per wireframe, ALL in a single message:
-```
-FOR EACH { moduleCode, index, wf } in wireframesToProcess:
-  Task(sonnet) prompt = this file's prompt template with substitutions:
-    {screenName}  = wf.screen
-    {moduleName}  = moduleCode
-    {sectionType} = wf.section
-    {asciiContent} = wf.content
-    {elementsJson} = JSON.stringify(wf.elements || [])
-```
-
-4. **Collect and validate** results:
-```javascript
-FOR EACH result:
-  // Strip markdown code fences if agent wrapped output
-  let svg = result.trim();
-  if (svg.startsWith('```')) {
-    svg = svg.replace(/^```(?:xml|svg|html)?\n?/, '').replace(/\n?```$/, '').trim();
-  }
-
-  IF svg starts with "<svg" AND svg contains "</svg>":
-    EMBEDDED_ARTIFACTS.wireframes[moduleCode][index].svgContent = svg
-  ELSE:
-    // Graceful fallback: leave svgContent as null
-    // HTML renders ASCII automatically
-```
-
-5. **Display summary** (non-blocking):
-```
-SVG wireframes: {generated}/{total} generated successfully
-```
-
-> **CRITICAL:** SVG generation is NEVER blocking. If all generations fail, deployment
-> proceeds with ASCII-only wireframes. SVG is an enhancement, not a requirement.

package/templates/skills/business-analyse-html/steps/step-01-collect.md

@@ -1,140 +0,0 @@
----
-name: step-01-collect
-description: Collect all JSON source data for HTML generation
-model: opus
-next_step: steps/step-02-build-data.md
----
-
-# Step 1: Collect JSON Sources
-
-## YOUR TASK
-
-Read all JSON analysis files for the feature and store them as `{collected_data}` for the next step.
-
----
-
-## EXECUTION SEQUENCE
-
-### 1. Locate Feature
-
-```
-1. Read feature_id from parameters OR from .business-analyse/config.json
-2. Locate master index.json (ba-006):
-   - Primary: docs/{projectSlug}/v{version}/index.json
-   - Discovery: Glob docs/*/v*/index.json → select project
-   - Legacy fallback: docs/business-analyse/v{version}/index.json OR docs/{app}/business-analyse/v{version}/index.json
-3. IF index.json NOT found → BLOCKING ERROR: "index.json not found — run /business-analyse first"
-
-Store: projectSlug, docs_dir (e.g., "docs/projet-rh/v1.0")
-```
-
-### 2. Detect Mode
-
-```
-IF index.json contains "applications[]" with multiple entries:
-  mode = "project" (multi-app)
-ELSE:
-  mode = "single-app"
-
-Store: workflow.mode
-```
-
-### 3. Verify Consolidation Status
-
-```
-IF workflow.mode === "project":
-  projectFeature = ba-reader.findProjectFeature()
-  FOR each app in projectFeature.applications:
-    appFeature = ba-reader.findFeature(app.featureJsonPath)
-    IF appFeature.status !== "consolidated":
-      BLOCKING ERROR: "Application {app.code} not consolidated"
-ELSE:
-  feature = ba-reader.findFeature({feature_id})
-  IF feature.status !== "consolidated":
-    BLOCKING ERROR: "Feature status: {feature.status}, expected consolidated"
-```
-
-### 4. Read All JSON Files (FLAT-FILE ARCHITECTURE)
-
-> **CRITICAL:** Module data lives in separate flat files (entities.json, usecases.json, etc.),
-> NOT inside index.json. The module index.json only contains metadata and file pointers.
-> You MUST read each flat file individually.
-
-```
-collected_data = {
-  master: {
-    index: READ(index.json),           // metadata, modules[], consolidation, handoff
-    cadrage: READ(cadrage.json),        // context, stakeholders, scope
-    validation: READ(validation.json) || null  // acceptance criteria (fallback for cadrage.criteria)
-  },
-  modules: {}
-}
-
-FOR each module in master.index.modules[]:
-  // Resolve module directory path (ba-006: no business-analyse/ intermediate)
-  const appKebab = toKebabCase(module.applicationCode || applicationCode);
-  const moduleKebab = toKebabCase(module.code);
-  moduleDir = docs_dir + "/" + appKebab + "/" + moduleKebab + "/";
-  // Legacy fallback: if not found, try {app}/{module.code}/business-analyse/v{version}/
-  moduleIndex = READ(moduleDir + "index.json")
-
-  // Read ALL flat files from module directory
-  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);
-    // Check both key conventions: useCases (camelCase) and usecases (lowercase)
-    if ((moduleData.usecases.useCases || moduleData.usecases.usecases || []).length === 0)
-      warnings.push("usecases.json is EMPTY for specified module " + module.code);
-    // Check both key conventions: rules and businessRules
-    if ((moduleData.rules.rules || moduleData.rules.businessRules || []).length === 0)
-      warnings.push("rules.json is EMPTY for specified module " + module.code);
-    // Check screens: both screens[] (Format A) and sections[] (Format B)
-    if ((moduleData.screens.screens || moduleData.screens.sections || []).length === 0)
-      warnings.push("screens.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
-
-```
-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...
-```
-
----
-
-## VALIDATION
-
-- 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
-
-Load: `steps/step-02-build-data.md`

package/templates/skills/business-analyse-html/steps/step-02-build-data.md

@@ -1,76 +0,0 @@
----
-name: step-02-build-data
-description: Build FEATURE_DATA and EMBEDDED_ARTIFACTS objects from collected JSON data
-model: opus
-next_step: steps/step-03-render.md
----
-
-> **Reference files:** `references/data-mapping.md` | `references/02-mapping-tables.md` | `references/02-normalization-helpers.md` | `references/02-screen-format-detection.md` | `references/02-feature-data-building.md` | `references/02-embedded-artifacts-building.md` | `references/02-self-check-validation.md`
-
-# Step 2: Build Data Objects
-
-## YOUR TASK
-
-Build `FEATURE_DATA` and `EMBEDDED_ARTIFACTS` objects from `{collected_data}` collected in step-01.
-
----
-
-## EXECUTION SEQUENCE
-
-### 1. Build FEATURE_DATA
-
-Construct the complete FEATURE_DATA object following the exact mapping in `references/data-mapping.md`:
-
-> → **Load** `references/02-mapping-tables.md` for all field mappings (metadata, cadrage, stakeholders, scope, criteria, modules, dependencies, consolidation, handoff, moduleSpecs, wireframes, e2eFlows, dependencyGraph)
-> → **Load** `references/02-normalization-helpers.md` for normalize* functions (normalizeColumn, normalizeField, normalizeFilter, normalizeSmartFilterField, normalizeAction, normalizeChart, normalizeKpi)
-> → **Load** `references/02-screen-format-detection.md` for screens.json format detection and normalization (Format A/B-CANONICAL/B-LEGACY)
-
-**Build moduleSpecs{} (ONE entry per module) + top-level fields:**
-
-> → **Load** `references/02-feature-data-building.md` for complete moduleSpecs construction logic, screen building, anticipatedSections enrichment, and top-level fields (dependencies, consolidation, handoff)
-
-### Post-Build Self-Check (MANDATORY — BLOCKING)
-
-> → **Load** `references/02-self-check-validation.md` for complete self-check code and validation points.
-
-After building FEATURE_DATA, run the self-check to detect data loss. This compares source file counts (useCases, businessRules, entities, screens) against built FEATURE_DATA counts to catch normalization bugs before rendering.
-
----
-
-### 2. Build EMBEDDED_ARTIFACTS
-
-**Build wireframes{}, e2eFlows[], and dependencyGraph:**
-
-> → **Load** `references/02-embedded-artifacts-building.md` for complete construction logic: flat-file wireframe collection from screens.json (Sources A, B, C), field renaming (mockupFormat → format, mockup → content), e2eFlows, and dependencyGraph
-
----
-
-### 3. Generate SVG Wireframes (Parallel, Optional)
-
-This step is NEVER blocking — ASCII-only wireframes are acceptable.
-
-1. Collect all wireframes where `content` exists and `svgContent` is null
-2. Spawn parallel Task(sonnet) agents — ONE per wireframe
-3. Validate results: strip markdown fences, verify SVG syntax
-4. Inject valid SVGs into `EMBEDDED_ARTIFACTS.wireframes[moduleCode][index].svgContent`
-5. Display: `"SVG wireframe generation: {successCount}/{total} generated, {failCount} fallback (ASCII)"`
-
----
-
-## VALIDATION
-
-- FEATURE_DATA.moduleSpecs must have ONE entry per module
-- cadrage.scope uses HTML keys (inscope/outofscope)
-- Wireframe fields use format/content (NOT mockupFormat/mockup)
-- Per-module: useCases/businessRules/entities count must match source (empty when source has data = BUG)
-- dependencies[] must be present (even if empty) to prevent HTML crashes
-- **Permissions:** `buildPermissionKeys()` supports 4 formats:
-  - **Format A:** `permissions.matrix[]` with `{role, permissions[]}`
-  - **Format B:** `permissions.permissionMatrix.roleAssignments[]`
-  - **Format C:** `permissions.roles[]` with `{role, permissions[]}`
-  - **Format D:** `permissions.permissionMatrix.roleAssignments[]` with wildcard expansion
-  - Pass optional `lang` parameter ('fr'|'en') for bilingual labels. Defaults to 'fr'.
-
-## NEXT STEP
-
-Load: `steps/step-03-render.md`