@atlashub/smartstack-cli 4.18.0 → 4.19.0

package/templates/skills/derive-prd/references/acceptance-criteria.md

@@ -0,0 +1,169 @@
+# Module Acceptance Criteria (Shared Reference)
+
+> **Loaded by:** step-03-specify (post-check), step-05-deploy (pre-handoff gate), ralph-loop step-01-task (input validation)
+> **Purpose:** Define measurable, bash-verifiable acceptance criteria that a module MUST pass before being marked "specified".
+> **Key principle:** These checks read the REAL JSON files on disk — NOT in-memory data the model "thinks" it wrote.
+
+---
+
+## Why Bash-Verifiable?
+
+All previous checks were **pseudocode interpreted by the model**. The model can "decide" a check passes even when it fails (hallucination of validation). Bash checks are **objective** — they read the actual file and count real elements.
+
+---
+
+## Acceptance Criteria Table
+
+| # | Criterion | Minimum | Field Path | Blocking | Category |
+|---|-----------|---------|------------|----------|----------|
+| AC-01 | Entities present | 2 | `analysis.entities[]` | YES | Data Model |
+| AC-02 | Entity attributes have `type` field | ALL | `analysis.entities[].attributes[].type` | YES | Data Model |
+| AC-03 | Use cases present | 2 | `specification.useCases[]` | YES | Requirements |
+| AC-04 | Functional requirements present | 4 | `specification.functionalRequirements[]` | YES | Requirements |
+| AC-05 | Wireframes present | 1 | `specification.uiWireframes[] \|\| specification.wireframes[]` | YES | UI |
+| AC-06 | Wireframes >= sections | count match | wireframes.length >= sections.length | YES | UI |
+| AC-07 | Wireframe content non-empty | ALL | `wireframe.mockup \|\| wireframe.ascii \|\| wireframe.content` | YES | UI |
+| AC-08 | Sections present | 1 | `specification.sections[]` | YES | UI |
+| AC-09 | SeedDataCore 9 arrays non-empty | 9/9 | `specification.seedDataCore.*` | YES | Seed Data |
+| AC-10 | Gherkin scenarios is array | `Array.isArray` | `specification.gherkinScenarios` | YES | Format |
+| AC-11 | API endpoints present | 1 | `specification.apiEndpoints[]` | YES | API |
+| AC-12 | Messages present | 4 | `specification.messages[]` | YES | Messages |
+| AC-13 | Validations present | 1 | `specification.validations[]` | YES | Validation |
+| AC-14 | Wireframe field naming | canonical | `screen` not `title`, `mockup` not `ascii` | WARNING | Convention |
+| AC-15 | Validation rules format | ALL array | `specification.validations[].rules` is `Array` | YES | Format |
+| AC-16 | Messages have `message` field | ALL present | `specification.messages[].message` truthy | YES | Format |
+| AC-17 | Gherkin content structure | ALL valid | Each element has `feature` (string) + `scenarios` (array) | YES | Format |
+
+---
+
+## Bash Verification Script (node -e)
+
+> **Usage:** Called from step-03 post-check after writing module JSON files.
+> Also callable standalone for debugging: `node -e "..." path/to/index.json`
+
+```bash
+MODULE_JSON="{module_feature_json_path}"
+node -e "
+const fs = require('fs');
+const data = JSON.parse(fs.readFileSync(process.argv[1], 'utf-8'));
+const spec = data.specification || {};
+const analysis = data.analysis || {};
+const wf = spec.uiWireframes || spec.wireframes || [];
+const sections = spec.sections || [];
+const sdc = spec.seedDataCore || {};
+
+const checks = [
+  ['AC-01: entities >= 2',          (analysis.entities||[]).length,               2],
+  ['AC-03: useCases >= 2',          (spec.useCases||[]).length,                   2],
+  ['AC-04: FRs >= 4',               (spec.functionalRequirements||[]).length,     4],
+  ['AC-05: wireframes >= 1',        wf.length,                                    1],
+  ['AC-06: wireframes >= sections', wf.length,                                    sections.length],
+  ['AC-08: sections >= 1',          sections.length,                               1],
+  ['AC-09: seedDataCore 9 arrays',  Object.keys(sdc).filter(k => Array.isArray(sdc[k]) && sdc[k].length > 0).length, 9],
+  ['AC-10: gherkin is array',       Array.isArray(spec.gherkinScenarios) ? 1 : 0,  1],
+  ['AC-11: apiEndpoints >= 1',      (spec.apiEndpoints||[]).length,                1],
+  ['AC-12: messages >= 4',          (spec.messages||[]).length,                    4],
+  ['AC-13: validations >= 1',       (spec.validations||[]).length,                 1]
+];
+
+const fails = [];
+checks.forEach(c => {
+  if (c[1] < c[2]) {
+    fails.push(c);
+    console.error('FAIL: ' + c[0] + ' = ' + c[1] + ' (min: ' + c[2] + ')');
+  }
+});
+
+// AC-02: Entity attribute types
+const badAttrs = (analysis.entities||[]).flatMap(e =>
+  (e.attributes||[]).filter(a => !a.type).map(a => e.name + '.' + a.name)
+);
+if (badAttrs.length > 0) {
+  fails.push(['AC-02: attr.type missing', badAttrs.length, 0]);
+  console.error('FAIL: AC-02: ' + badAttrs.length + ' attributes without type: ' + badAttrs.slice(0, 5).join(', ') + (badAttrs.length > 5 ? '...' : ''));
+}
+
+// AC-07: Wireframe content non-empty
+const emptyWf = wf.filter(w => !w.mockup && !w.ascii && !w.content);
+if (emptyWf.length > 0) {
+  fails.push(['AC-07: wireframe content empty', emptyWf.length, 0]);
+  console.error('FAIL: AC-07: ' + emptyWf.length + ' wireframes have EMPTY content');
+}
+
+// AC-14: Wireframe field naming (WARNING only)
+const badFields = wf.filter(w => w.title || w.ascii || (w.name && !w.screen));
+if (badFields.length > 0) {
+  console.warn('WARNING: AC-14: ' + badFields.length + ' wireframes use non-canonical field names (title/ascii/name)');
+}
+
+// AC-15: Validation rules format (rules must be array, not string)
+const badRules = (spec.validations||[]).filter(v => v.rules && !Array.isArray(v.rules));
+if (badRules.length > 0) {
+  fails.push(['AC-15: validations[].rules not array', badRules.length, 0]);
+  console.error('FAIL: AC-15: ' + badRules.length + ' validations have rules as string instead of array');
+}
+
+// AC-16: Messages must have 'message' field
+const noMsg = (spec.messages||[]).filter(m => !m.message);
+if (noMsg.length > 0) {
+  fails.push(['AC-16: messages[].message missing', noMsg.length, 0]);
+  console.error('FAIL: AC-16: ' + noMsg.length + ' messages missing "message" field');
+}
+
+// AC-17: Gherkin content structure (each element needs feature + scenarios[])
+if (Array.isArray(spec.gherkinScenarios)) {
+  const badGherkin = spec.gherkinScenarios.filter(g => !g.feature || !Array.isArray(g.scenarios));
+  if (badGherkin.length > 0) {
+    fails.push(['AC-17: gherkin content invalid', badGherkin.length, 0]);
+    console.error('FAIL: AC-17: ' + badGherkin.length + ' gherkin entries missing feature or scenarios[]');
+  }
+}
+
+// Summary
+if (fails.length > 0) {
+  console.error('\\nBLOCKING: ' + fails.length + ' acceptance criteria FAILED');
+  process.exit(1);
+}
+console.log('PASS: All acceptance criteria met (AC-01 to AC-17)');
+" "$MODULE_JSON"
+```
+
+---
+
+## Integration Points
+
+### 1. step-03-specify.md (post-check)
+
+After writing module JSON files, run the bash script above.
+IF FAIL → re-execute section 11 write with corrected data → re-run until PASS.
+
+### 2. step-05-deploy.md (pre-handoff gate)
+
+Before writing handoff for each module, run the bash script on the module index.json.
+IF FAIL → STOP handoff for this module, report which criteria failed.
+
+### 3. ralph-loop step-01-task.md (input validation)
+
+At PRD load time, run the bash script on each module index.json.
+IF FAIL → BLOCKING: "Module {name} does not meet acceptance criteria — run /business-analyse to fix".
+This prevents ralph-loop from generating code from incomplete specifications.
+
+---
+
+## Recovery Actions per Criterion
+
+| Criterion | Recovery |
+|-----------|----------|
+| AC-01/02 | Re-run step-03 entity specification |
+| AC-03/04 | Re-run step-03 use case / functional requirements |
+| AC-05/06/07 | Re-run step-03 wireframe generation |
+| AC-08 | Re-run step-03 section definition |
+| AC-09 | Re-run step-03 seedDataCore transform |
+| AC-10 | Auto-fix: wrap in array `[gherkinScenarios]` |
+| AC-11 | Re-run step-03 API endpoints |
+| AC-12 | Re-run step-03 messages |
+| AC-13 | Re-run step-03 validations |
+| AC-14 | Auto-fix: rename title→screen, ascii→mockup |
+| AC-15 | Auto-fix: wrap string in array `[rules]` |
+| AC-16 | Auto-fix: copy `description` → `message` |
+| AC-17 | Re-run step-03 gherkin — ensure each entry has `feature` string + `scenarios` array |

package/templates/skills/derive-prd/references/entity-domain-mapping.md

@@ -0,0 +1,115 @@
+# Entity-to-Domain File Mapping
+
+> **Used by:** step-01-transform (section 6: Map Entity to Domain File)
+> **Purpose:** Define the 1:1 mapping between BA entities and Domain layer files.
+
+---
+
+## Mapping Rules
+
+Each entity identified during business analysis maps to exactly one file in the Domain layer. The mapping is deterministic based on entity type and module.
+
+### Entity -> Domain Entity File
+
+```
+BA: analysis.entities[].name = "{EntityName}"
+    analysis.entities[].module = "{ModuleCode}"
+    metadata.application = "{AppName}"
+
+Domain: src/SmartStack.{AppName}.Domain/{ModuleCode}/Entities/{EntityName}.cs
+```
+
+**Example:**
+```
+BA: analysis.entities[].name = "Employee"
+    module = "Employees"
+    application = "HumanResources"
+
+Domain: src/SmartStack.HumanResources.Domain/Employees/Entities/Employee.cs
+```
+
+### ValueObject -> Domain ValueObject File
+
+```
+BA: analysis.entities[].valueObjects[].name = "{VOName}"
+
+Domain: src/SmartStack.{AppName}.Domain/{ModuleCode}/ValueObjects/{VOName}.cs
+```
+
+**Example:**
+```
+BA: valueObject.name = "Address"
+    module = "Employees"
+
+Domain: src/SmartStack.HumanResources.Domain/Employees/ValueObjects/Address.cs
+```
+
+### Enum -> Domain Enum File
+
+```
+BA: analysis.entities[].enums[].name = "{EnumName}"
+    OR attributes with type "enum" and enumValues[]
+
+Domain: src/SmartStack.{AppName}.Domain/{ModuleCode}/Enums/{EnumName}.cs
+```
+
+**Example:**
+```
+BA: enum.name = "EmployeeStatus"
+    module = "Employees"
+
+Domain: src/SmartStack.HumanResources.Domain/Employees/Enums/EmployeeStatus.cs
+```
+
+---
+
+## Path Pattern Summary
+
+| BA Element | Domain File Path |
+|------------|-----------------|
+| Entity | `src/SmartStack.{App}.Domain/{Module}/Entities/{EntityName}.cs` |
+| ValueObject | `src/SmartStack.{App}.Domain/{Module}/ValueObjects/{VOName}.cs` |
+| Enum | `src/SmartStack.{App}.Domain/{Module}/Enums/{EnumName}.cs` |
+| Domain Exception | `src/SmartStack.{App}.Domain/{Module}/Exceptions/{ExceptionName}.cs` |
+| Domain Service | `src/SmartStack.{App}.Domain/{Module}/Services/{ServiceName}.cs` |
+
+---
+
+## Cross-Module Entity References
+
+When an entity in module A references an entity in module B:
+- The reference is by ID only (no direct entity dependency across modules)
+- Navigation properties use the same `{App}.Domain/{Module}/Entities/` path
+- Cross-module FK: `{OtherModuleEntity}Id` property + configuration in Infrastructure layer
+
+---
+
+## Integration with filesToCreate.domain
+
+Each mapped entity becomes an entry in `handoff.filesToCreate.domain[]`:
+
+```json
+{
+  "path": "src/SmartStack.HumanResources.Domain/Employees/Entities/Employee.cs",
+  "type": "Entity",
+  "module": "Employees",
+  "dependencies": []
+}
+```
+
+ValueObjects and Enums are also included:
+
+```json
+{
+  "path": "src/SmartStack.HumanResources.Domain/Employees/ValueObjects/Address.cs",
+  "type": "ValueObject",
+  "module": "Employees",
+  "dependencies": []
+},
+{
+  "path": "src/SmartStack.HumanResources.Domain/Employees/Enums/EmployeeStatus.cs",
+  "type": "Enum",
+  "module": "Employees",
+  "dependencies": []
+}
+```

package/templates/skills/{business-analyse → derive-prd}/references/handoff-file-templates.md

@@ -1,120 +1,131 @@
-# Handoff File Templates (7 Categories)
-
-> **PATH HIERARCHY CONVENTION:** All backend file paths MUST include the application hierarchy.
-> - `{ApplicationName}` = `metadata.application` (e.g., `"HumanResources"`)
-> - `{ModuleName}` = `metadata.module` (e.g., `"Projects"`)
-
-## 4.1 Domain Files
-
-From `analysis.entities[]`:
-
-```json
-"domain": [
-  { "path": "src/Domain/Entities/{ApplicationName}/{ModuleName}/{EntityName}.cs", "type": "Entity", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" }
-]
-```
-
-Include: Value objects, Enums (`src/Domain/Enums/...`), Domain exceptions (`src/Domain/Exceptions/...`)
-
-## 4.2 Application Files
-
-From `analysis.useCases[]`:
-
-```json
-"application": [
-  { "path": "src/Application/Services/{ApplicationName}/{ModuleName}/{ServiceName}Service.cs", "type": "Service", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/Application/DTOs/{ApplicationName}/{ModuleName}/{DtoName}Dto.cs", "type": "Dto", "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/Application/Validators/{ApplicationName}/{ModuleName}/{ValidatorName}Validator.cs", "type": "Validator", "linkedFRs": [], "module": "{moduleCode}" }
-]
-```
-
-Include: Service per UC cluster, DTOs for API contracts, Validators (FluentValidation), Query handlers
-
-## 4.3 Infrastructure Files
-
-From `analysis.entities[]`:
-
-```json
-"infrastructure": [
-  { "path": "src/Infrastructure/Persistence/Configurations/{ApplicationName}/{ModuleName}/{EntityName}Configuration.cs", "type": "EFConfiguration", "linkedFRs": [], "module": "{moduleCode}" }
-]
-```
-
-Include: EF Core config per entity, DbSet in IExtensionsDbContext, DI registration, Specifications
-
-## 4.4 API Files
-
-From `specification.apiEndpoints[]`:
-
-```json
-"api": [
-  { "path": "src/API/Controllers/{ApplicationName}/{EntityName}Controller.cs", "type": "ApiController", "linkedUCs": [], "linkedFRs": [], "module": "{moduleCode}" }
-]
-```
-
-Include: One controller per aggregate root, all HTTP methods, error handling
-
-## 4.5 Frontend Files
-
-From `specification.uiWireframes[]`, `specification.dashboards[]` and `analysis.useCases[]`:
-
-> **WIREFRAME TRACEABILITY:** Every frontend file MUST include `linkedWireframes[]` referencing wireframe `screen` identifiers.
-
-```json
-"frontend": [
-  { "path": "src/pages/{ApplicationName}/{ModuleName}/{PageName}Page.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "wireframeAcceptanceCriteria": "Layout MUST match wireframe...", "skill": "/ui-components" },
-  { "path": "src/pages/{ApplicationName}/{ModuleName}/{PageName}DetailPage.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}", "skill": "/ui-components" },
-  { "path": "src/pages/{ApplicationName}/{ModuleName}/{DashboardName}DashboardPage.tsx", "type": "DashboardPage", "linkedUCs": [], "linkedWireframes": ["{module}-dashboard"], "module": "{moduleCode}", "dashboardRef": "{module}-dashboard", "instructions": "Use Recharts library...", "skill": "/ui-components" },
-  { "path": "src/components/{ModuleName}/{ComponentName}.tsx", "type": "Component", "linkedUCs": [], "linkedWireframes": [], "module": "{moduleCode}", "skill": "/ui-components" },
-  { "path": "src/hooks/use{ModuleName}{Hook}.ts", "type": "Hook", "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/i18n/locales/fr/{moduleLower}.json", "type": "I18n", "language": "fr", "module": "{moduleCode}" },
-  { "path": "src/i18n/locales/en/{moduleLower}.json", "type": "I18n", "language": "en", "module": "{moduleCode}" },
-  { "path": "src/i18n/locales/it/{moduleLower}.json", "type": "I18n", "language": "it", "module": "{moduleCode}" },
-  { "path": "src/i18n/locales/de/{moduleLower}.json", "type": "I18n", "language": "de", "module": "{moduleCode}" }
-]
-```
-
-**Page generation:** ALL pages and components MUST be generated via `/ui-components` skill (entity lists, grids, tables, dashboards, charts). The `"skill"` field indicates which skill to invoke.
-
-**I18n generation:** 4 JSON files per module (fr, en, it, de) with identical key structures. `{moduleLower}` = lowercase module code. See `smartstack-frontend.md` for JSON template (keys: actions, labels, columns, form, errors, validation, messages, empty).
-
-**Dashboard acceptance criteria:** Chart library (Recharts), chart types matching spec, KPI cards, filters, CSS variables, responsive layout, wireframe-matching positions.
-
-## 4.6 SeedData Files
-
-**OBLIGATORY: 2 app-level CORE + per module CORE (NavigationModule + NavigationSections + Permissions + Roles) + business per module:**
-
-```json
-"seedData": [
-  { "path": "src/Infrastructure/Persistence/Seeding/Data/NavigationApplicationSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.navigationApplications", "module": "shared", "description": "Application-level navigation seed data. Created ONCE per application (FIRST). Provides ApplicationId for modules and roles." },
-  { "path": "src/Infrastructure/Persistence/Seeding/Data/ApplicationRolesSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.rolePermissions", "module": "shared", "description": "Application-scoped role definitions (admin, manager, contributor, viewer). Created ONCE per application. Provides role entries for SeedRolesAsync()." },
-  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/NavigationModuleSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.navigationModules", "module": "{moduleCode}" },
-  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/NavigationSectionSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.navigationSections", "module": "{moduleCode}", "description": "MANDATORY when sections defined. Seeds section-level navigation entries (list, dashboard, etc.) with full absolute routes." },
-  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/PermissionsSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.permissions", "module": "{moduleCode}" },
-  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/RolesSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.rolePermissions", "module": "{moduleCode}" },
-  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/{Entity}SeedData.cs", "type": "SeedData", "category": "business", "source": "specification.seedDataBusiness.{module}", "module": "{moduleCode}" }
-]
-```
-
-**For client projects (ExtensionsDbContext), add MANDATORY infrastructure files:**
-
-```json
-[
-  { "path": "src/Infrastructure/Persistence/Seeding/{AppPascalName}SeedDataProvider.cs", "type": "IClientSeedDataProvider", "category": "infrastructure", "description": "Runtime provider that injects core seed data into Core schema" },
-  { "path": "src/Infrastructure/Persistence/Seeding/DevDataSeeder.cs", "type": "DevDataSeeder", "category": "infrastructure" },
-  { "path": "src/Infrastructure/Persistence/Seeding/Data/SeedConstants.cs", "type": "SeedConstants", "category": "infrastructure" }
-]
-```
-
-**Path convention:** All seed data under `Persistence/Seeding/Data/`. NEVER use `Data/SeedData/`.
-
-## 4.7 Test Files
-
-```json
-"tests": [
-  { "path": "src/Tests/Unit/Domain/{ApplicationName}/{ModuleName}/{Entity}Tests.cs", "type": "UnitTests", "linkedFRs": [], "module": "{moduleCode}" },
-  { "path": "src/Tests/Unit/Application/{ApplicationName}/{ModuleName}/{ServiceName}ServiceTests.cs", "type": "UnitTests", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/Tests/Integration/{ApplicationName}/{ModuleName}/{ApiControllerName}ControllerTests.cs", "type": "IntegrationTests", "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/Tests/Security/{ApplicationName}/{ModuleName}/{ModuleName}SecurityTests.cs", "type": "SecurityTests", "linkedFRs": [], "module": "{moduleCode}" }
-]
-```
+# Handoff File Templates (8 Categories)
+
+> **PATH HIERARCHY CONVENTION:** All backend file paths MUST include the application hierarchy.
+> - `{ApplicationName}` = `metadata.application` (e.g., `"HumanResources"`)
+> - `{ModuleName}` = `metadata.module` (e.g., `"Projects"`)
+
+## 4.1 Domain Files
+
+From `analysis.entities[]`:
+
+```json
+"domain": [
+  { "path": "src/Domain/Entities/{ApplicationName}/{ModuleName}/{EntityName}.cs", "type": "Entity", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" }
+]
+```
+
+Include: Value objects, Enums (`src/Domain/Enums/...`), Domain exceptions (`src/Domain/Exceptions/...`)
+
+## 4.2 Application Files
+
+From `analysis.useCases[]`:
+
+```json
+"application": [
+  { "path": "src/Application/Services/{ApplicationName}/{ModuleName}/{ServiceName}Service.cs", "type": "Service", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/Application/DTOs/{ApplicationName}/{ModuleName}/{DtoName}Dto.cs", "type": "Dto", "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/Application/Validators/{ApplicationName}/{ModuleName}/{ValidatorName}Validator.cs", "type": "Validator", "linkedFRs": [], "module": "{moduleCode}" }
+]
+```
+
+Include: Service per UC cluster, DTOs for API contracts, Validators (FluentValidation), Query handlers
+
+## 4.3 Infrastructure Files
+
+From `analysis.entities[]`:
+
+```json
+"infrastructure": [
+  { "path": "src/Infrastructure/Persistence/Configurations/{ApplicationName}/{ModuleName}/{EntityName}Configuration.cs", "type": "EFConfiguration", "linkedFRs": [], "module": "{moduleCode}" }
+]
+```
+
+Include: EF Core config per entity, DbSet in IExtensionsDbContext, DI registration, Specifications
+
+## 4.4 API Files
+
+From `specification.apiEndpoints[]`:
+
+```json
+"api": [
+  { "path": "src/API/Controllers/{ApplicationName}/{EntityName}Controller.cs", "type": "ApiController", "linkedUCs": [], "linkedFRs": [], "module": "{moduleCode}" }
+]
+```
+
+Include: One controller per aggregate root, all HTTP methods, error handling
+
+## 4.5 Frontend Files
+
+From `specification.uiWireframes[]`, `specification.dashboards[]` and `analysis.useCases[]`:
+
+> **WIREFRAME TRACEABILITY:** Every frontend file MUST include `linkedWireframes[]` referencing wireframe `screen` identifiers.
+
+```json
+"frontend": [
+  { "path": "src/pages/{ApplicationName}/{ModuleName}/{PageName}Page.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "wireframeAcceptanceCriteria": "Layout MUST match wireframe...", "skill": "/ui-components" },
+  { "path": "src/pages/{ApplicationName}/{ModuleName}/{PageName}DetailPage.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}", "skill": "/ui-components" },
+  { "path": "src/pages/{ApplicationName}/{ModuleName}/{DashboardName}DashboardPage.tsx", "type": "DashboardPage", "linkedUCs": [], "linkedWireframes": ["{module}-dashboard"], "module": "{moduleCode}", "dashboardRef": "{module}-dashboard", "instructions": "Use Recharts library...", "skill": "/ui-components" },
+  { "path": "src/components/{ModuleName}/{ComponentName}.tsx", "type": "Component", "linkedUCs": [], "linkedWireframes": [], "module": "{moduleCode}", "skill": "/ui-components" },
+  { "path": "src/hooks/use{ModuleName}{Hook}.ts", "type": "Hook", "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/i18n/locales/fr/{moduleLower}.json", "type": "I18n", "language": "fr", "module": "{moduleCode}" },
+  { "path": "src/i18n/locales/en/{moduleLower}.json", "type": "I18n", "language": "en", "module": "{moduleCode}" },
+  { "path": "src/i18n/locales/it/{moduleLower}.json", "type": "I18n", "language": "it", "module": "{moduleCode}" },
+  { "path": "src/i18n/locales/de/{moduleLower}.json", "type": "I18n", "language": "de", "module": "{moduleCode}" }
+]
+```
+
+**Page generation:** ALL pages and components MUST be generated via `/ui-components` skill (entity lists, grids, tables, dashboards, charts). The `"skill"` field indicates which skill to invoke.
+
+**I18n generation:** 4 JSON files per module (fr, en, it, de) with identical key structures. `{moduleLower}` = lowercase module code. See `smartstack-frontend.md` for JSON template (keys: actions, labels, columns, form, errors, validation, messages, empty).
+
+**Dashboard acceptance criteria:** Chart library (Recharts), chart types matching spec, KPI cards, filters, CSS variables, responsive layout, wireframe-matching positions.
+
+## 4.6 SeedData Files
+
+**OBLIGATORY: 2 app-level CORE + per module CORE (NavigationModule + NavigationSections + Permissions + Roles) + business per module:**
+
+```json
+"seedData": [
+  { "path": "src/Infrastructure/Persistence/Seeding/Data/NavigationApplicationSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.navigationApplications", "module": "shared", "description": "Application-level navigation seed data. Created ONCE per application (FIRST). Provides ApplicationId for modules and roles." },
+  { "path": "src/Infrastructure/Persistence/Seeding/Data/ApplicationRolesSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.rolePermissions", "module": "shared", "description": "Application-scoped role definitions (admin, manager, contributor, viewer). Created ONCE per application. Provides role entries for SeedRolesAsync()." },
+  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/NavigationModuleSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.navigationModules", "module": "{moduleCode}" },
+  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/NavigationSectionSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.navigationSections", "module": "{moduleCode}", "description": "MANDATORY when sections defined. Seeds section-level navigation entries (list, dashboard, etc.) with full absolute routes." },
+  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/PermissionsSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.permissions", "module": "{moduleCode}" },
+  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/RolesSeedData.cs", "type": "SeedData", "category": "core", "source": "specification.seedDataCore.rolePermissions", "module": "{moduleCode}" },
+  { "path": "src/Infrastructure/Persistence/Seeding/Data/{ModuleName}/{Entity}SeedData.cs", "type": "SeedData", "category": "business", "source": "specification.seedDataBusiness.{module}", "module": "{moduleCode}" }
+]
+```
+
+**For client projects (ExtensionsDbContext), add MANDATORY infrastructure files:**
+
+```json
+[
+  { "path": "src/Infrastructure/Persistence/Seeding/{AppPascalName}SeedDataProvider.cs", "type": "IClientSeedDataProvider", "category": "infrastructure", "description": "Runtime provider that injects core seed data into Core schema" },
+  { "path": "src/Infrastructure/Persistence/Seeding/DevDataSeeder.cs", "type": "DevDataSeeder", "category": "infrastructure" },
+  { "path": "src/Infrastructure/Persistence/Seeding/Data/SeedConstants.cs", "type": "SeedConstants", "category": "infrastructure" }
+]
+```
+
+**Path convention:** All seed data under `Persistence/Seeding/Data/`. NEVER use `Data/SeedData/`.
+
+## 4.7 Test Files
+
+```json
+"tests": [
+  { "path": "src/Tests/Unit/Domain/{ApplicationName}/{ModuleName}/{Entity}Tests.cs", "type": "UnitTests", "linkedFRs": [], "module": "{moduleCode}" },
+  { "path": "src/Tests/Unit/Application/{ApplicationName}/{ModuleName}/{ServiceName}ServiceTests.cs", "type": "UnitTests", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/Tests/Integration/{ApplicationName}/{ModuleName}/{ApiControllerName}ControllerTests.cs", "type": "IntegrationTests", "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/Tests/Security/{ApplicationName}/{ModuleName}/{ModuleName}SecurityTests.cs", "type": "SecurityTests", "linkedFRs": [], "module": "{moduleCode}" }
+]
+```
+
+## 4.8 Documentation Files
+
+```json
+"documentation": [
+  { "path": "src/docs/{ModuleName}/doc-data.ts", "type": "DocData", "module": "{moduleCode}", "description": "Documentation data export for /documentation skill" }
+]
+```
+
+Include: Technical documentation data, API specification files, user guides.
+This category can be an empty array `[]` if no documentation is planned at this stage. It will be populated by the `/documentation` skill after `/ralph-loop` completes.