@atlashub/smartstack-cli 3.23.0 → 3.25.0

package/templates/skills/business-analyse/patterns/suggestion-catalog.md

@@ -489,7 +489,7 @@ Auto-added:
 | Produits/Products | Commerce, Inventaire | Catalogue avec variantes, tarification, stock |
 
 **Section pattern for module dedie:**
-- Section `list` (TOUJOURS) : grille + create en modale + clic vers detail
+- Section `list` (TOUJOURS) : grille + bouton create (navigue vers page `/create`) + clic vers detail
 - Page detail avec onglets : Infos + onglets relationnels
 - Sections additionnelles UNIQUEMENT si : dashboard, approve, import, rapport
 

package/templates/skills/business-analyse/questionnaire/07-ui.md

@@ -39,8 +39,8 @@
 | Need | Component | Détail |
 |------|-----------|--------|
 | List with pagination | DataTable | Tri, pagination, sélection, actions inline |
-| Creation form | Form + Modal | Validation FluentValidation, i18n des erreurs |
-| Edit form | Form + Modal | Pré-remplissage, dirty check, optimistic locking |
+| Creation form | Form page (`/create` route) | Validation FluentValidation, i18n des erreurs |
+| Edit form | Form page (`/:id/edit` route) | Pré-remplissage, dirty check, optimistic locking |
 | Filters | FilterBar | Filtres combinables, persistance URL params |
 | Export | ExportButton | CSV/Excel, respecte les filtres actifs |
 | Cards/Grid | CardGrid | Affichage visuel alternatif au tableau |
@@ -58,7 +58,7 @@
 | Question | If answer is vague/insufficient | Probe |
 |----------|-------------------------------|-------|
 | Q7.1 (devices) | "Desktop uniquement" | "Aucun accès mobile ? Même pas en consultation ? Tablette en atelier/terrain ?" |
-| Q7.5 (screens) | "Un écran de liste" | "Avec création/édition inline ou en modal ? Détail en side panel ou page séparée ?" |
+| Q7.5 (screens) | "Un écran de liste" | "Avec pages dédiées pour création et édition ? Détail en page avec onglets ?" |
 | Q7.5 (screens) | Pas de mention dashboard | "L'utilisateur a-t-il besoin d'un tableau de bord avec des KPIs avant de plonger dans les données ?" |
 | Q7.7 (key info) | "Toutes les colonnes" | "Sur mobile/petit écran, quelles 3-4 colonnes sont indispensables ? Le reste = détail secondaire" |
 | Q7.8 (actions) | "CRUD classique" | "Actions métier spécifiques ? (valider, dupliquer, archiver, changer statut, assigner)" |

package/templates/skills/business-analyse/references/cadrage-pre-analysis.md

@@ -84,7 +84,7 @@ For each detected module, anticipate sections (Level 4) and resources (Level 5)
 | integration | list | sync-status-grid, config-form, log-viewer | Infos, Config, Logs |
 
 > **RULE:** Sections = functional zones only (`list`, `dashboard`, `approve`, `import`, `rapport`, `planning`).
-> `create`/`edit` = actions (modal/drawer) within the `list` page. `detail` = tabbed page reached by clicking a row in `list`.
+> `create`/`edit` = separate pages with own URL routes (`/create` and `/:id/edit`). `detail` = tabbed page reached by clicking a row in `list`.
 
 **Always check:** Does the user's description imply additional functional sections? (e.g., "reports" → `dashboard`, "calendar view" → `planning`, "approval workflow" → `approve`)
 

package/templates/skills/business-analyse/references/entity-architecture-decision.md

@@ -121,7 +121,7 @@ L'entite {E} est-elle CORE pour cette application ?
 Module
 ├── Section: list
 │   └── Page principale avec grille/table
-│   └── Action "Creer" (ouvre formulaire en modale/drawer DANS cette page)
+│   └── Action "Creer" (navigue vers la page /create avec formulaire)
 │   └── Clic sur une ligne → navigation vers la page detail
 │   └── Resources : {entity}-grid, {entity}-filters, {entity}-form
 │
@@ -152,8 +152,8 @@ Module
 
 | PAS une section | C'est quoi en realite |
 |-----------------|----------------------|
-| `create` | Action (bouton) dans la page `list`, ouvre un formulaire en modale/drawer |
-| `edit` | Action dans la page detail, bascule les champs en mode edition |
+| `create` | Action (bouton) dans la page `list`, navigue vers la page `/create` avec formulaire |
+| `edit` | Action dans la page list/detail, navigue vers la page `/:id/edit` avec formulaire pre-rempli |
 | `detail` | Page de detail accessible par navigation depuis `list` (pas une section menu) |
 | `delete` | Action avec confirmation dans la page `list` ou `detail` |
 | `search` | Composant de filtrage integre dans la section `list` |

package/templates/skills/business-analyse/references/handoff-file-templates.md

@@ -70,14 +70,22 @@ From `specification.uiWireframes[]`, `specification.dashboards[]` and `analysis.
 
 ```json
 "frontend": [
-  { "path": "src/pages/{ModuleName}/{PageName}Page.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "wireframeAcceptanceCriteria": "Layout MUST match wireframe..." },
-  { "path": "src/pages/{ModuleName}/{PageName}DetailPage.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}" },
-  { "path": "src/pages/{ModuleName}/{DashboardName}DashboardPage.tsx", "type": "DashboardPage", "linkedUCs": [], "linkedWireframes": ["{module}-dashboard"], "module": "{moduleCode}", "dashboardRef": "{module}-dashboard", "instructions": "Use Recharts library..." },
-  { "path": "src/components/{ModuleName}/{ComponentName}.tsx", "type": "Component", "linkedUCs": [], "linkedWireframes": [], "module": "{moduleCode}" },
-  { "path": "src/hooks/use{ModuleName}{Hook}.ts", "type": "Hook", "linkedUCs": [], "module": "{moduleCode}" }
+  { "path": "src/pages/{ContextPascal}/{ApplicationName}/{ModuleName}/{PageName}Page.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "wireframeAcceptanceCriteria": "Layout MUST match wireframe...", "skill": "/ui-components" },
+  { "path": "src/pages/{ContextPascal}/{ApplicationName}/{ModuleName}/{PageName}DetailPage.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}", "skill": "/ui-components" },
+  { "path": "src/pages/{ContextPascal}/{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

package/templates/skills/business-analyse/references/spec-auto-inference.md

@@ -9,7 +9,7 @@
 | string + unique | text | yes | yes | clickAction: navigate:detail |
 | string | text | yes | yes | — |
 | enum / status | badge | yes | yes (multi-select) | colorMap from lifeCycles if exists |
-| FK:Entity | text (join .name) | yes | yes (entity-select) | Display related entity name |
+| FK:Entity | text (join .name) | yes | yes (EntityLookup) | Display related entity name, filter via searchable EntityLookup |
 | decimal | currency | yes | no | — |
 | int | number | yes | no | — |
 | datetime | date-relative | yes | yes (date-range) | — |
@@ -23,7 +23,7 @@
 | string | Input | entity.required | — |
 | string (multiline) | TextArea | entity.required | rows: 4 |
 | enum | Select | entity.required | source: enum name |
-| FK:Entity | EntitySelect | entity.required | source: target entity, searchable |
+| FK:Entity | EntityLookup | entity.required | source: target entity, searchable. Component: `@/components/ui/EntityLookup`. NEVER plain text input for FK Guid fields. Backend API MUST support `?search=` param. See `smartstack-frontend.md` section 6. |
 | decimal | NumberInput | entity.required | — |
 | int | NumberInput | entity.required | — |
 | datetime | DatePicker | entity.required | — |
@@ -31,22 +31,22 @@
 
 ## Auto-Generated UI Components by featureType
 
-> **RULE:** Sections = functional zones only. `create`/`edit` are actions within `list`. `detail` is a tabbed page reached from `list`.
+> **RULE:** Sections = functional zones only. `create`/`edit` are separate pages with own URL routes (`/create` and `/:id/edit`). `detail` is a tabbed page reached from `list`.
 
-| featureType | Sections (functional zones) | List page includes | Detail page tabs |
-|---|---|---|---|
-| data-centric | list | grid, filters, create form (modal) | Infos, {relations} |
-| workflow | list, approve | grid, filters, create form (modal) | Infos, {relations}, Historique |
-| integration | list | grid, filters, config form | Infos, Config, Logs |
-| reporting | dashboard | — | — |
-| full-module | list, dashboard | grid, filters, create form (modal) | Infos, {relations}, Historique |
+| featureType | Sections (functional zones) | List page includes | Form pages | Detail page tabs |
+|---|---|---|---|---|
+| data-centric | list | grid, filters, create button | `/create` page, `/:id/edit` page | Infos, {relations} |
+| workflow | list, approve | grid, filters, create button | `/create` page, `/:id/edit` page | Infos, {relations}, Historique |
+| integration | list | grid, filters, config button | `/create` page, `/:id/edit` page | Infos, Config, Logs |
+| reporting | dashboard | — | — | — |
+| full-module | list, dashboard | grid, filters, create button | `/create` page, `/:id/edit` page | Infos, {relations}, Historique |
 
 ## Component Generation Rules
 
-1. **list section:** SmartTable with all non-long-text attributes as columns, actions = [view, edit, delete], defaultSort = { createdAt, desc }. Create action opens SmartForm in modal/drawer.
-2. **create form (in list):** SmartForm with all writable attributes as fields, component inferred from type. Opens as modal/drawer from the list page.
-3. **detail page (from list click):** TabPanel with: Info tab (all attributes), relation tabs (child SmartTable for each 1:N relationship), History tab (if auditable). See "Detail Page Tab Auto-Inference" below for exact rules.
-4. **edit (in detail):** Same form as create but pre-filled (mode: edit). Inline in the detail page Info tab.
+1. **list section:** SmartTable with all non-long-text attributes as columns, actions = [view, edit, delete], defaultSort = { createdAt, desc }. Create button navigates to `/create` page. Edit action navigates to `/:id/edit` page.
+2. **create page (`/create` route):** SmartForm (full page) with all writable attributes as fields, component inferred from type. Back button + form + submit. NEVER a modal.
+3. **edit page (`/:id/edit` route):** Same form as create but pre-filled with entity data. Full page with back button. NEVER a modal or inline toggle.
+4. **detail page (from list click):** TabPanel with: Info tab (all attributes read-only + edit button navigating to `/:id/edit`), relation tabs (child SmartTable for each 1:N relationship), History tab (if auditable). See "Detail Page Tab Auto-Inference" below for exact rules.
 5. **dashboard section:** Trigger 3d (dashboard specification)
 
 ## Detail Page Tab Auto-Inference

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

@@ -136,7 +136,7 @@ pre_analysis:
 
 **Modules identifiés :**
 - **{Module 1}** : {functional description}
-  - Section **list** : {entity}-grid, {entity}-filters, {entity}-form (création en modale)
+  - Section **list** : {entity}-grid, {entity}-filters + pages `/create` et `/:id/edit`
   - Page détail (onglets) : {Infos, {relation_tabs}...}
   - {IF dashboard needed:} Section **dashboard** : {kpi-cards, charts...}
 - **{Module 2}** : {functional description}
@@ -601,7 +601,7 @@ BEFORE transitioning to step-02:
    f. **List detail page tabs** — for entities accessible via click from `list`
 
 > **SECTION RULE:** Sections are functional zones (list, dashboard, approve, import, rapport...).
-> `create` and `edit` are ACTIONS within the `list` page (modal/drawer).
+> `create` and `edit` are SEPARATE PAGES with their own URL routes (`/create` and `/:id/edit`).
 > `detail` is a page with tabs accessible by clicking a row in `list`, NOT a standalone section.
 
 4. **OUTPUT the matrix as text** (do NOT put it inside AskUserQuestion — it won't render):

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

@@ -73,7 +73,7 @@ For each mustHave/shouldHave scope item:
 >   "entities": ["Anticipated entity names"],
 >   "estimatedComplexity": "simple|medium|complex",
 >   "anticipatedSections": [
->     { "code": "list", "description": "Main page: grid, create action (modal), click to detail", "resources": ["entity-grid", "entity-filters", "entity-form"] },
+>     { "code": "list", "description": "Main page: grid, create button (navigates to /create page), click to detail", "resources": ["entity-grid", "entity-filters", "entity-create-page", "entity-edit-page"] },
 >     { "code": "dashboard", "description": "Module KPIs and overview (if needed)", "resources": ["entity-kpi-cards", "entity-charts"] }
 >   ],
 >   "detailTabs": ["Informations", "RelatedEntity1", "Historique"]

package/templates/skills/business-analyse/steps/step-03a1-setup.md

@@ -200,7 +200,7 @@ Total: {N} requirements mapped to this module
 For each module, propose standard sections based on module type:
 
 > **RULE:** Sections = functional zones only. `list` is ALWAYS present (default).
-> `create`/`edit` = actions within the `list` page (modal/drawer). `detail` = tabbed page from list click.
+> `create`/`edit` = separate pages with own URL routes (`/create` and `/:id/edit`). `detail` = tabbed page from list click.
 
 | Module Type | Sections (functional zones) | Detail page tabs (from list click) |
 |-------------|---------------------------|-----------------------------------|
@@ -291,7 +291,7 @@ See [references/spec-auto-inference.md](../references/spec-auto-inference.md) fo
 - Entity attribute → SmartTable column mapping (9 type rules)
 - Entity attribute → SmartForm field mapping (8 type rules)
 - Auto-generated sections per featureType (5 types)
-- Component generation rules (list section, create form in modal, detail page with tabs, dashboard section)
+- Component generation rules (list section, create/edit form pages with own routes, detail page with tabs, dashboard section)
 - Status/lifecycle enhancement rules
 
 Write auto-generated sections to `specification.sections[]` via ba-writer.enrichSection()

package/templates/skills/business-analyse/steps/step-03b-ui.md

@@ -319,7 +319,8 @@ For each section, identify what resources/components are needed:
 
 - List section → DataGrid, FilterBar, SearchInput, ExportButton, CreateButton
 - Detail page (from list click) → BackButton, DetailHeader, StatusBadge, TabPanel, DetailCard, SmartForm (edit mode), SmartTable (relation tabs), Timeline (history tab)
-- Create (in list) → SmartForm (modal/drawer), ValidationMessages, SubmitButton
+- Create page (`/create` route) → SmartForm (full page), ValidationMessages, SubmitButton, BackButton
+- Edit page (`/:id/edit` route) → SmartForm (full page, pre-filled), ValidationMessages, SubmitButton, BackButton
 - Approve section → StatusTransitionPanel, CommentBox, ApproveRejectButtons
 - Dashboard section → StatCard, RechartsChart (Bar/Line/Pie/Area), DashboardGrid, FilterBar
 

package/templates/skills/business-analyse/steps/step-05a-handoff.md

@@ -287,13 +287,24 @@ For each module, generate these SEPARATE frontend file entries (not one monolith
 
 ```json
 "frontend": [
-  { "path": "src/pages/{Mod}/{ListPage}Page.tsx", "type": "Page", "linkedWireframes": ["{module}-list"], "module": "{moduleCode}" },
-  { "path": "src/pages/{Mod}/{DetailPage}Page.tsx", "type": "Page", "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}" },
+  { "path": "src/pages/{Context}/{App}/{Mod}/{ListPage}Page.tsx", "type": "Page", "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "skill": "/ui-components" },
+  { "path": "src/pages/{Context}/{App}/{Mod}/{Entity}CreatePage.tsx", "type": "Page", "linkedWireframes": ["{module}-create"], "module": "{moduleCode}", "skill": "/ui-components", "fkFields": ["EmployeeId→Employee", "DepartmentId→Department"] },
+  { "path": "src/pages/{Context}/{App}/{Mod}/{Entity}EditPage.tsx", "type": "Page", "linkedWireframes": ["{module}-edit"], "module": "{moduleCode}", "skill": "/ui-components", "fkFields": ["EmployeeId→Employee", "DepartmentId→Department"] },
+  { "path": "src/pages/{Context}/{App}/{Mod}/{DetailPage}Page.tsx", "type": "Page", "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}", "skill": "/ui-components" },
   { "path": "src/hooks/use{Module}.ts", "type": "Hook", "module": "{moduleCode}" },
-  { "path": "src/i18n/{module}.json", "type": "I18n", "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}" }
 ]
 ```
 
+**FK fields in forms:** Create/Edit page entries MUST include `"fkFields"` array listing FK properties and their target entities (format: `"PropertyId→TargetEntity"`). This tells ralph-loop to use `EntityLookup` component instead of plain text inputs. Derive FK fields from `analysis.entities[].relationships[]` where `type = "N:1"` or from properties ending in `Id` with a navigation property. See `smartstack-frontend.md` section 6 for the EntityLookup pattern.
+
+**Page generation:** ALL pages MUST use `/ui-components` skill (indicated by `"skill"` field). NEVER write raw TSX without the skill patterns.
+
+**I18n generation:** 4 JSON files per module with identical key structures. `{moduleLower}` = lowercase module code. Keys: actions, labels, columns, form, errors, validation, messages, empty. See `smartstack-frontend.md` template.
+
 Additional per-section pages (dashboard, import, etc.) are separate entries.
 
 **Route wiring task (MANDATORY — separate entry):**
@@ -344,7 +355,7 @@ Add to progress.txt after all module tasks.
 >     "application": [{"path": "src/Application/Services/{Ctx}/{App}/{Mod}/{Svc}Service.cs", "type": "Service|Dto|Validator", "linkedFRs": [], "linkedUCs": [], "module": "..."}],
 >     "infrastructure": [{"path": "src/Infrastructure/Persistence/Configurations/{Ctx}/{App}/{Mod}/{Entity}Configuration.cs", "type": "EFConfiguration", "linkedFRs": [], "module": "..."}],
 >     "api": [{"path": "src/API/Controllers/{CtxShort}/{App}/{Entity}Controller.cs", "type": "ApiController", "linkedUCs": [], "linkedFRs": [], "module": "..."}],
->     "frontend": [{"path": "src/pages/{Mod}/{Page}Page.tsx", "type": "Page|Component|Hook|DashboardPage", "linkedUCs": [], "linkedWireframes": [], "module": "..."}],
+>     "frontend": [{"path": "src/pages/{Ctx}/{App}/{Mod}/{Page}Page.tsx", "type": "Page|Component|Hook|DashboardPage|I18n", "linkedUCs": [], "linkedWireframes": [], "module": "...", "skill": "/ui-components"}],
 >     "seedData": [{"path": "src/Infrastructure/Persistence/Seeding/Data/{Mod}/...SeedData.cs", "type": "SeedData", "category": "core|business", "source": "...", "module": "..."}],
 >     "tests": [{"path": "src/Tests/Unit/Domain/{Ctx}/{App}/{Mod}/{Entity}Tests.cs", "type": "UnitTests|IntegrationTests|SecurityTests", "linkedFRs": [], "linkedUCs": [], "module": "..."}]
 >   },

package/templates/skills/business-analyse/templates/tpl-frd.md

@@ -100,8 +100,8 @@
 
 | Element | Type | Behavior | Permission |
 |---------|------|----------|------------|
-| [+ New] | Button | Opens create modal | `{module}.create` |
-| [E] | Icon | Opens edit modal | `{module}.update` |
+| [+ New] | Button | Navigates to `/create` page | `{module}.create` |
+| [E] | Icon | Navigates to `/:id/edit` page | `{module}.update` |
 | [D] | Icon | Confirmation + delete | `{module}.delete` |
 
 ## 5. Validation and Messages

package/templates/skills/business-analyse/templates-frd.md

@@ -272,8 +272,8 @@
 
 | Element | Type | Behavior | Permission |
 |---------|------|----------|------------|
-| [+ New] | Button | Opens create modal | `{module}.create` |
-| [E] | Icon | Opens edit modal | `{module}.update` |
+| [+ New] | Button | Navigates to `/create` page | `{module}.create` |
+| [E] | Icon | Navigates to `/:id/edit` page | `{module}.update` |
 | [D] | Icon | Confirmation + delete | `{module}.delete` |
 
 ## 5. Validation and Messages

package/templates/skills/efcore/steps/migration/step-02-create.md

@@ -107,7 +107,20 @@ dotnet ef migrations add "$MIGRATION_NAME" \
   --verbose
 ```
 
-### 6. Verify Creation
+### 6. Cleanup EF Core Design-Time Artifacts
+
+```bash
+# EF Core's Roslyn BuildHost creates corrupted bin folders on Windows (U+F05C instead of backslash)
+# Clean up any bin*Debug folders that are NOT the normal bin/Debug path
+for d in src/*/bin?Debug; do
+  if [ -d "$d" ]; then
+    echo "Removing corrupted EF Core artifact: $d"
+    rm -rf "$d"
+  fi
+done
+```
+
+### 7. Verify Creation
 
 ```bash
 # Check files were created

package/templates/skills/ralph-loop/references/category-rules.md

@@ -56,8 +56,9 @@ Execution sequence:
    > NEVER use `$HOME/.dotnet/tools` alone — on WSL, `$HOME` resolves to `/home/{user}` where .NET SDK is not installed.
 1. Call `mcp__smartstack__suggest_migration` → get standardized name
 2. `dotnet ef migrations add {Name} --project src/{Infra}.csproj --startup-project src/{Api}.csproj -o Persistence/Migrations`
-3. `dotnet ef database update --project src/{Infra}.csproj --startup-project src/{Api}.csproj`
-4. `dotnet build --no-restore` → verify build passes
+3. Cleanup corrupted EF Core artifacts: `for d in src/*/bin?Debug; do [ -d "$d" ] && rm -rf "$d"; done`
+4. `dotnet ef database update --project src/{Infra}.csproj --startup-project src/{Api}.csproj`
+5. `dotnet build --no-restore` → verify build passes
 
 **BLOCKING:** If migration fails, DO NOT proceed. Fix the EF configs first.
 
@@ -281,6 +282,8 @@ fi
 - Swagger XML documentation
 - Consistent route patterns: `api/{context}/{app}/{module}`
 - Return DTOs, never domain entities
+- **ALL GetAll endpoints MUST accept `?search=` query parameter** (enables EntityLookup on frontend)
+- **GetAll returns paginated results:** `PaginatedResult<T>` with items, totalCount, page, pageSize
 
 **Controller coverage (BLOCKING):**
 - EVERY entity in the module MUST have a controller with CRUD endpoints (GET list, GET by id, POST, PUT, DELETE)
@@ -307,18 +310,28 @@ fi
 3. **Wire routes to App.tsx (detect pattern: `contextRoutes` array OR JSX `<Route>`):**
    - **Pattern A** (`contextRoutes: ContextRouteExtensions` in App.tsx): add to `contextRoutes.{context}[]` with RELATIVE paths → auto-injected into both standard + tenant trees
    - **Pattern B** (JSX `<Route>` in App.tsx): insert `<Route>` entries inside correct Layout wrapper (BOTH standard AND tenant-prefixed `/t/:slug/...` blocks)
-4. Create pages using SmartStack components
+4. Create pages using **`/ui-components` skill** (MANDATORY for entity lists, grids, tables, dashboards, charts). The skill ensures CSS variables, EntityCard, SmartTable, loading/error/empty states, and responsive grid patterns.
 5. Create preferences hook: `use{Module}Preferences.ts`
-6. Generate i18n (4 languages: fr, en, it, de)
+6. Generate i18n (4 languages: fr, en, it, de) — see I18n section below for detailed rules
 7. `npm run typecheck` MUST pass (BLOCKING)
 
 **Components:**
 - Lists: `SmartTable` + `SmartFilter` (NOT HTML `<table>`)
 - Grids: `EntityCard` (NOT custom `<div>` cards)
 - Detail: `EntityDetailCard`, `StatusBadge`, tab layout
-- Forms: `SmartForm` with FluentValidation-backed fields
+- Forms: `SmartForm` with FluentValidation-backed fields — **MUST be full pages, NEVER modals**
+- FK fields: `EntityLookup` for searchable entity selection (NEVER plain text for Guid FK)
 - Dashboard: `StatCard`, Recharts components
 
+**Form pages (CRITICAL — ZERO modals/popups/drawers):**
+- Create form: `EntityCreatePage.tsx` with route `/{module}/create`
+- Edit form: `EntityEditPage.tsx` with route `/{module}/:id/edit`
+- ALL forms are full pages with their own URL — NEVER Modal/Dialog/Drawer/Popup
+- Back button with `navigate(-1)` on every form page
+- Use React.lazy() + `<Suspense fallback={<PageLoader />}>` for form page imports
+- **Form tests (MANDATORY):** Co-located `EntityCreatePage.test.tsx` and `EntityEditPage.test.tsx`
+  → Cover: rendering, validation, submit, pre-fill (edit), navigation, error handling
+
 **Layout wrapper mapping:**
 
 | Context | Layout | Route path |
@@ -355,17 +368,43 @@ Adding routes to clientRoutes[] instead of contextRoutes.{context}[] → MUST us
 '00000000-0000-0000-0000-000000000000'       → use dynamic ID from auth context or route params
 const api = axios.create(...)                → use @/services/api/apiClient (single instance)
 useXxx with raw axios inside hooks           → hooks MUST use the shared apiClient from @/services/api
+<input type="text" value={...employeeId}    → FK Guid fields MUST use EntityLookup (searchable select)
+placeholder="Enter ID" / "Enter GUID"       → EntityLookup provides search-based entity selection
+<Modal>/<Dialog>/<Drawer>/<Popup> for forms  → forms are FULL PAGES with own URL routes (/create, /:id/edit)
+useState(showCreateModal/editDialog)         → navigate to form page, NEVER toggle modal visibility
 ```
 
 ---
 
-## I18n
+## I18n (MANDATORY for frontend)
+
+> **CRITICAL:** Every frontend module MUST have 4 translation files. Missing i18n = broken UI (untranslated labels, empty buttons).
+
+**File path:** `src/i18n/locales/{lang}/{moduleLower}.json` (4 files: fr, en, it, de)
+
+**JSON key structure (identical across all 4 languages):**
+```json
+{
+  "actions": { "create": "...", "edit": "...", "delete": "...", "save": "...", "cancel": "...", "search": "...", "filter": "...", "export": "...", "refresh": "..." },
+  "labels": { "title": "...", "description": "...", "status": "...", "createdAt": "...", "updatedAt": "..." },
+  "columns": { "name": "...", "status": "...", "date": "...", "actions": "..." },
+  "form": { "name": "...", "description": "...", "submit": "...", "required": "..." },
+  "errors": { "loadFailed": "...", "saveFailed": "...", "deleteFailed": "...", "notFound": "..." },
+  "validation": { "required": "...", "minLength": "...", "maxLength": "...", "invalid": "..." },
+  "messages": { "created": "...", "updated": "...", "deleted": "...", "confirmDelete": "..." },
+  "empty": { "title": "...", "description": "...", "action": "..." }
+}
+```
+
+**Usage pattern in TSX:** `t('{moduleLower}:actions.create', 'Create')` — ALWAYS namespace prefix + fallback value.
 
 **Rules:**
-- 4 JSON files: fr, en, it, de
-- Identical key structures across all languages
+- 4 JSON files: fr, en, it, de — ALL mandatory (not just fr/en)
+- Identical key structures across all languages — same keys, translated values
 - All UI labels, validation messages, button text, empty states
-- Depends on frontend task completion
+- Depends on frontend page completion (pages define which keys are needed)
+- Add entity-specific keys under `labels`, `columns`, `form` for each entity field
+- Reference `smartstack-frontend.md` for the complete template
 
 ---
 
@@ -439,6 +478,29 @@ useXxx with raw axios inside hooks           → hooks MUST use the shared apiCl
 - Coverage >= 80%
 - No `[Fact(Skip = "...")]`
 
+**Frontend test completeness (BLOCKING):**
+
+After all frontend pages are generated, verify test coverage:
+
+```bash
+# Count page files vs test files
+PAGE_COUNT=$(find src/pages/ -name "*.tsx" ! -name "*.test.tsx" 2>/dev/null | wc -l)
+TEST_COUNT=$(find src/pages/ -name "*.test.tsx" 2>/dev/null | wc -l)
+
+if [ "$PAGE_COUNT" -gt 0 ] && [ "$TEST_COUNT" -eq 0 ]; then
+  echo "BLOCKING: Category D — No .test.tsx files found in src/pages/"
+  echo "Every module with pages MUST have at least one test file"
+  echo "Pages found: $PAGE_COUNT, Tests found: 0"
+  exit 1
+fi
+
+# Minimum ratio: at least 1 test per 3 pages
+MIN_TESTS=$(( (PAGE_COUNT + 2) / 3 ))
+if [ "$TEST_COUNT" -lt "$MIN_TESTS" ]; then
+  echo "WARNING: Low test coverage — $TEST_COUNT tests for $PAGE_COUNT pages (minimum: $MIN_TESTS)"
+fi
+```
+
 ---
 
 ## Validation (FINAL — BLOCKING)

package/templates/skills/ralph-loop/references/compact-loop.md

@@ -99,8 +99,8 @@ Batch: {batch.length} [{firstCategory}] → {batch.map(t => `[${t.id}] ${t.descr
 | `infrastructure` with migration | `Migrations/` folder has .cs files | No migration files |
 | `infrastructure` with seed data | Seed data .cs files exist | 0 files created |
 | `application` | Service + DTO + Validator files exist | 0 files created |
-| `api` | Controller .cs files exist | 0 files created |
-| `frontend` | .tsx page files exist | 0 files created |
+| `api` | Controller .cs files exist + GetAll supports `?search=` | 0 files created OR GetAll without search param |
+| `frontend` | .tsx page files exist + FK fields use EntityLookup (not plain text) | 0 files created OR FK Guid field as `<input type="text">` |
 | `test` | Test project dir exists AND contains test .cs files | No test project or 0 test files |
 | `validation` | `dotnet test` exit 0 AND `dotnet build` exit 0 | Either command fails |
 
@@ -108,7 +108,7 @@ Batch: {batch.length} [{firstCategory}] → {batch.map(t => `[${t.id}] ${t.descr
 
 | Category | Action |
 |----------|--------|
-| `infrastructure` with `_migrationMeta` | Migration sequence: `suggest_migration` MCP → `dotnet ef migrations add` → `dotnet ef database update` → `dotnet build` |
+| `infrastructure` with `_migrationMeta` | Migration sequence: `suggest_migration` MCP → `dotnet ef migrations add` → cleanup corrupted artifacts (`for d in src/*/bin?Debug; do [ -d "$d" ] && rm -rf "$d"; done`) → `dotnet ef database update` → `dotnet build` |
 | `infrastructure` with seed data keywords | **MANDATORY:** Read `references/core-seed-data.md` → implement templates → `dotnet build` |
 | `frontend` | MCP-first: `scaffold_api_client` → `scaffold_routes` (outputFormat: clientRoutes) → **wire to App.tsx (detect pattern: `contextRoutes` array OR JSX `<Route>`)** → create pages → `npm run typecheck && npm run lint` |
 | `test` | **Create tests:** `scaffold_tests` MCP → **Run:** `dotnet test --verbosity normal` → **Fix loop:** if fail → fix SOURCE CODE → rebuild → retest → repeat until 100% pass |

package/templates/skills/ralph-loop/references/core-seed-data.md

@@ -1253,3 +1253,13 @@ public class {Module}DevDataSeeder : IDevDataSeeder
 - Using `Guid.NewGuid()` for TenantId
 - Omitting idempotency check (`AnyAsync`)
 - Hardcoding TenantId inline (use `SeedConstants.DefaultTenantId`)
+
+### CROSS-SCHEMA FK WARNING
+
+> `SeedConstants.DefaultTenantId` MUST reference a tenant that EXISTS in `core.tenant_Tenants`.
+> The SmartStack platform seeds a default tenant during `InitializeSmartStackAsync()`.
+> If you use a custom GUID, ensure it is created BEFORE `DevDataSeeder` runs (Order >= 200).
+>
+> **Pipeline validation:**
+> - ralph-loop POST-CHECK warns if GUID not found in project config
+> - validate-feature step-05 verifies FK exists in real database via SQL query