@atlashub/smartstack-cli 4.74.0 → 4.76.0

package/templates/skills/apex/steps/step-03c-layer2-backend.md

@@ -122,21 +122,48 @@ For each entity where {code_patterns} defines strategy != "manual":
 > **AGENT BOUNDARY:** Snipper agents do NOT have access to MCP tools or Bash.
 > MCP scaffolding and bash validation MUST be executed by the principal agent.
 
+#### Pre-Phase A — NavRoute Uniqueness Validation
+
+> **BLOCKING gate.** Run BEFORE any scaffold_extension call.
+
+```
+# Verify {entity_section_map} produces unique NavRoutes for section-level entities
+allNavRoutes = {entity_section_map}.map(e => e.navRoute)
+duplicates = allNavRoutes.filter((nr, i, arr) => arr.indexOf(nr) !== i)
+
+# Module-level entities MAY share NavRoute (sub-resources without own section)
+# Section-level entities MUST have unique NavRoutes
+sectionNavRoutes = {entity_section_map}.filter(e => e.level == "section").map(e => e.navRoute)
+sectionDuplicates = sectionNavRoutes.filter((nr, i, arr) => arr.indexOf(nr) !== i)
+
+IF sectionDuplicates.length > 0:
+  BLOCKING: "Two section-level entities share the same NavRoute: {sectionDuplicates}"
+  → Fix entity_section_map in step-00 §4g before proceeding
+```
+
 #### Phase A — Sequential: MCP scaffolding (principal agent)
 
-For each entity, the principal agent calls MCP directly:
+For each entity, the principal agent calls MCP directly with **per-entity NavRoute from `{entity_section_map}`**:
 
 ```
 IF NOT economy_mode AND entities.length > 1:
 
   FOR EACH entity in entities:
-    1. mcp__smartstack__scaffold_extension(type: "dto", name: "{Entity}", options: { navRoute: "{navRoute}" })
-    2. mcp__smartstack__scaffold_extension(type: "controller", name: "{Entity}", options: { navRoute: "{navRoute}" })
+    # Resolve per-entity NavRoute from entity_section_map (step-00 §4g)
+    entityMap = {entity_section_map}.find(e => e.entity == entity)
+    entityNavRoute = entityMap.navRoute   // e.g., "crm.clients.contacts" for Contact
+    entityLevel = entityMap.level         // "module" or "section"
+
+    1. mcp__smartstack__scaffold_extension(type: "dto", name: "{Entity}", options: { navRoute: "{entityNavRoute}" })
+    2. mcp__smartstack__scaffold_extension(type: "controller", name: "{Entity}", options: { navRoute: "{entityNavRoute}" })
 
     # Immediate NavRoute verification (principal has Bash access)
-    3. Verify: [NavRoute] present, [Route] absent, segment count >= 2
+    3. Verify:
+       - [NavRoute] present, [Route] absent
+       - NavRoute value == entityNavRoute (exact match)
+       - Segment count matches level: "module" → 2 segments (1 dot), "section" → 3 segments (2 dots)
        If [Route] found alongside [NavRoute] → remove [Route] immediately
-       If [NavRoute] missing → add it with correct value
+       If [NavRoute] missing or wrong value → fix with entityNavRoute
 ```
 
 #### Phase B — Parallel: post-scaffold adjustments (Snipper agents)
@@ -160,6 +187,7 @@ After ALL Phase A scaffolding completes, launch Snipper agents in parallel:
 
         DO NOT regenerate controller or DTO files — already created by MCP in Phase A.
         DO NOT add [Route] attribute — NavRoute is already set correctly.
+        NavRoute for this entity: {entityNavRoute} (from entity_section_map — DO NOT change it)
         Files already created: {list of paths from Phase A}')
   # All agents launched in parallel
 ```
@@ -293,11 +321,28 @@ for ENTITY in $ENTITIES; do
   ALL_NAVROUTES="$ALL_NAVROUTES
 $NR"
 done
+
+# Check MediatR pattern — MCP scaffold_extension generates ISender, manual code uses I*Service
+FAIL_MEDIATOR=false
+for ENTITY in $ENTITIES; do
+  CTRL=$(find src/ -path "*/Controllers/*" -name "${ENTITY}*Controller.cs" 2>/dev/null | head -1)
+  [ -z "$CTRL" ] && continue
+  if grep -qE 'private readonly I[A-Za-z0-9_]+Service ' "$CTRL" && ! grep -q 'ISender' "$CTRL"; then
+    echo "BLOCKING: $CTRL injects service directly instead of ISender _mediator"
+    echo "  MCP scaffold_extension was NOT called — regenerate via MCP"
+    FAIL_MEDIATOR=true
+  fi
+done
+if [ "$FAIL_MEDIATOR" = true ]; then
+  echo "BLOCKING: One or more controllers bypass MCP scaffold_extension (HARD RULE violation)"
+  exit 1
+fi
 ```
 
 > IF any BLOCKING found: fix the controller(s) BEFORE proceeding to Layer 3.
 > The fix is: remove [Route], add [NavRoute] with the correct dot-separated value,
 > add `using SmartStack.Api.Routing;`.
+> If ISender missing: delete the controller and call `mcp__smartstack__scaffold_extension(type: 'controller')`.
 
 ### Post-Layer 2 Build Gate
 

package/templates/skills/apex/steps/step-03d-layer3-frontend.md

@@ -41,6 +41,108 @@ if (delegate_mode && specification_loading_plan) {
 > - **Dashboard pages**: use `screen.kpis[]` for KPI card and chart definitions
 > - **Actions**: use `screen.actions[]` for action buttons (create, export, bulk operations)
 
+### Build Per-Entity PRD Context Block (delegate mode)
+
+> **CRITICAL:** This block builds the authoritative specification that MUST be passed to `/ui-components`.
+> Without it, `/ui-components` infers columns from entity structure and misses PRD-specified fields
+> (e.g., Person Extension Pattern display fields like DisplayFirstName, DisplayLastName).
+
+When companion specs are loaded, build a `{prd_context}` map keyed by entity name:
+
+```javascript
+const prdContextMap = {};  // entityName → structured PRD block
+
+if (screensData?.sections) {
+  for (const section of screensData.sections) {
+    for (const resource of (section.resources || [])) {
+      if (!resource.entity) continue;
+      const entityName = resource.entity;
+
+      if (!prdContextMap[entityName]) {
+        prdContextMap[entityName] = { screens: [], labels: {}, permissions: [] };
+      }
+
+      // Collect screen resource specs
+      prdContextMap[entityName].screens.push({
+        sectionCode: section.code,
+        sectionType: section.sectionType,
+        resourceType: resource.type,
+        columns: resource.columns || null,
+        fields: resource.fields || null,
+        actions: resource.actions || [],
+        defaultSort: resource.defaultSort || null,
+        defaultPageSize: resource.defaultPageSize || 20
+      });
+
+      // Collect section labels (4 languages)
+      if (section.labels) {
+        prdContextMap[entityName].labels[section.code] = section.labels;
+      }
+
+      // Collect permissions
+      if (section.permission) {
+        prdContextMap[entityName].permissions.push(section.permission);
+      }
+    }
+  }
+}
+```
+
+Then, for each entity, serialize the PRD context into a text block to inject into `/ui-components`:
+
+```javascript
+function buildPrdBlock(entityName) {
+  const ctx = prdContextMap[entityName];
+  if (!ctx || ctx.screens.length === 0) return '';
+
+  let block = '\n--- PRD SPECIFICATION (AUTHORITATIVE — use these EXACT definitions) ---\n';
+
+  // SmartTable columns
+  const tableScreens = ctx.screens.filter(s => s.resourceType === 'SmartTable' && s.columns);
+  for (const screen of tableScreens) {
+    block += `\nCOLUMNS for DataTable (section: "${screen.sectionCode}") — use ALL, in this EXACT order:\n`;
+    for (const col of screen.columns) {
+      block += `  - key: "${col.field}", label_fr: "${col.label?.fr || col.field}", ` +
+               `label_en: "${col.label?.en || col.field}", format: "${col.format}", ` +
+               `sortable: ${col.sortable || false}\n`;
+    }
+    if (screen.actions.length > 0) {
+      block += `ACTIONS: ${screen.actions.join(', ')}\n`;
+    }
+    if (screen.defaultSort) {
+      block += `DEFAULT SORT: field="${screen.defaultSort.field}", direction="${screen.defaultSort.direction}"\n`;
+    }
+    block += `PAGE SIZE: ${screen.defaultPageSize}\n`;
+  }
+
+  // SmartForm fields
+  const formScreens = ctx.screens.filter(s => s.resourceType === 'SmartForm' && s.fields);
+  for (const screen of formScreens) {
+    block += `\nFORM FIELDS (section: "${screen.sectionCode}"):\n`;
+    for (const field of screen.fields) {
+      block += `  - name: "${field.name}", type: "${field.type}", required: ${field.required || false}\n`;
+    }
+  }
+
+  // Labels
+  block += '\nSECTION LABELS (use for page titles, breadcrumbs, i18n — 4 languages):\n';
+  for (const [code, labels] of Object.entries(ctx.labels)) {
+    block += `  ${code}: fr="${labels.fr}" en="${labels.en}" it="${labels.it}" de="${labels.de}"\n`;
+  }
+
+  // Permissions
+  if (ctx.permissions.length > 0) {
+    block += `\nPERMISSIONS: ${ctx.permissions.join(', ')}\n`;
+  }
+
+  block += '--- END PRD SPECIFICATION ---\n';
+  return block;
+}
+```
+
+**Usage:** When invoking `Skill("ui-components")`, append `buildPrdBlock(entityName)` to the arguments.
+The `/ui-components` skill reads free-text instructions — the structured block is parsed naturally.
+
 ### ⛔ HARD RULE — /ui-components is NON-NEGOTIABLE (read BEFORE any Layer 3 action)
 
 > **VIOLATION CHECK:** If ANY .tsx page file was created by Write tool WITHOUT
@@ -115,7 +217,11 @@ TaskUpdate(taskId: progress_tracker_id,
 ### Frontend Tasks (sequential or parallel within layer)
 
 For each module:
-- API client: MCP scaffold_api_client
+- API client: MCP scaffold_api_client — **MANDATORY, do not skip or generate manually.**
+  → The generated API client uses `apiClient` from `@/services/api` (auth, token refresh, tenant isolation).
+  → Hooks MUST import from the generated API service, NEVER use raw `fetch()` or direct axios.
+  → If `scaffold_api_client` is unavailable: generate the service manually using `apiClient` import,
+    but NEVER using `fetch()`. Pattern: `import apiClient from '@/services/api'; const res = await apiClient.get('/api/...');`
 - Routes — TWO mandatory steps:
   1. Generate registry: MCP scaffold_routes (source: 'controllers', outputFormat: 'componentRegistry', dryRun: false)
      → Creates/updates componentRegistry.generated.ts + navRoutes.generated.ts
@@ -126,6 +232,15 @@ For each module:
   → Create{Section}Page.tsx (/create route)
   → Edit{Section}Page.tsx (/:id/edit route)
   "detail" is NEVER a separate section — it's the /:id route of the list section.
+- **CRUD Page Completeness (MANDATORY for every entity section with a ListPage):**
+  1. ALL 4 page types MUST exist (List, Detail, Create/Form, Edit/Form)
+  2. **Create button on ListPage (MANDATORY):** Every ListPage MUST include a "New" / "Create" button
+     in the header that calls `navigate('create')`. Without this button, users cannot access the create form.
+  3. **componentRegistry registration:** ALL page types MUST be registered via `PageRegistry.register()`.
+     After `scaffold_routes`, verify the registry contains keys for ALL pages.
+     If form pages (create/edit) are missing from registry, add them manually.
+  4. **POST-CHECK Gate PG-2b:** Grep every `*ListPage.tsx` for `navigate.*create`.
+     If absent → BLOCKING error — add the create button before proceeding.
 - Pages: **MANDATORY — INVOKE Skill("ui-components")** for ALL page generation.
   ⚠ BLOCKING REQUIREMENT: You MUST call Skill("ui-components") for EVERY page (.tsx).
   NEVER generate .tsx page code directly. NEVER write page content in Agent prompts.
@@ -163,7 +278,12 @@ For each module:
   → Follow JSON template from smartstack-frontend.md
   → Keys: actions, labels, errors, validation, columns, form, messages, empty
   → All t() calls must use namespace prefix + fallback: t('ns:key', 'Default text')
-  → **Register namespace in i18n config** (critical — POST-CHECK C39 catches this, but fix it now):
+  → **UTF-8 accents are MANDATORY** — NEVER use ASCII-only text for accented languages:
+    - FR: "Département" (not "Departement"), "employés" (not "employes"), "trouvée" (not "trouvee")
+    - DE: "Übersicht" (not "Ubersicht"), "Beschäftigung" (not "Beschaftigung")
+    - IT: "attività" (not "attivita"), "dipendentì" (not "dipendenti")
+    - EN: no accents needed (but proper apostrophes: "employee's" not "employees")
+  → **Register namespace in i18n config** (critical — POST-CHECK C39 + GATE PG-4 catch this, but fix it now):
     1. Find i18n config: `Glob("src/**/i18n/config.ts")` or `index.ts` or `i18n.ts`
     2. Read the config → find the resources/ns registration pattern
     3. Add the new namespace import + registration for all 4 languages
@@ -172,11 +292,20 @@ For each module:
     6. **I18n File/Import Alignment Check:** Verify that every locale JSON file on disk for this module
        has a corresponding import in the i18n config index.ts. Glob `src/**/i18n/locales/*/` for module files,
        then verify each is imported. Missing imports cause silent translation failures (keys show as raw strings).
+    7. **If registration is missing after step 6:** This is a BLOCKING error. The page will show raw keys
+       (`list.title`, `form.department`) instead of translated text. Fix before proceeding.
 - Permissions: Call MCP generate_permissions for the module permission root (2 segments: {app}.{module}),
   then also call MCP generate_permissions for each section (3 segments: {app}.{module}.{section}).
 - Section routes: Ensure navigation seed data has ComponentKey matching PageRegistry keys.
   ComponentKey convention: `{app_code}.{module_code}.{section_code}` (dot-separated, lowercase).
   DynamicRouter generates the URL paths from seed data Route field.
+  **CRITICAL: PageRegistry keys use DOTS as hierarchy separator, NEVER hyphens.**
+  - Correct: `PageRegistry.register('rh.employes.list', lazy(...))`
+  - WRONG:   `PageRegistry.register('rh-employes-list', lazy(...))`
+  NavigationService computes `ComponentKey = "{app.Code}.{module.Code}.{section.Code}"` at runtime.
+  DynamicRouter calls `PageRegistry.resolve(componentKey)` — keys MUST match exactly.
+  For client projects: `import { PageRegistry } from '@atlashub/smartstack';`
+  For SmartStack core: `import { PageRegistry } from '@/extensions/PageRegistry';`
 - MUST use src/pages/{App}/{Module}/ hierarchy (NOT flat)
 
 ### Documentation (after frontend pages exist)
@@ -227,13 +356,17 @@ IF NOT economy_mode AND entities.length > 1:
   # PHASE B — Sequential: pages via /ui-components (principal agent)
   # Snipper agents cannot call Skill() — only the principal agent can.
   For each entity (sequentially):
-    **INVOKE Skill("ui-components")** — pass entity context:
+    **INVOKE Skill("ui-components")** — pass entity context + PRD spec:
       - Entity: {EntityName}, Module: {ModuleName}, App: {AppName}
       - Page types: List, Detail, Create, Edit (+ Dashboard if applicable)
       - "CSS: Use CSS variables ONLY — bg-[var(--bg-card)], text-[var(--text-primary)]"
       - "Forms: Create/Edit are FULL PAGES with own routes (/create, /:id/edit)"
       - "FK FIELDS: EntityLookup for ALL FK Guid fields"
       - "I18n: ALL text uses t('namespace:key', 'Fallback')"
+      - {buildPrdBlock(EntityName)} — append the PRD specification block from companion specs
+      - "COLUMNS ARE AUTHORITATIVE: Do NOT infer columns from entity attributes. Use ALL columns from the PRD SPECIFICATION block above, in the EXACT order listed. Do NOT add, remove, or reorder columns."
+      - "LABELS ARE AUTHORITATIVE: Use PRD SECTION LABELS for i18n t() fallback text and page titles. Do NOT invent labels."
+      - "ACTIONS ARE AUTHORITATIVE: Implement ALL action buttons listed in the PRD SPECIFICATION (create, edit, delete, approve, reject, export, etc.)."
     Generate form tests: co-located .test.tsx for Create and Edit pages
 
 ELSE:
@@ -245,12 +378,16 @@ ELSE:
     2. MCP scaffold_routes (outputFormat: 'componentRegistry')
     3. Verify PageRegistry registration (componentRegistry.generated.ts)
        No manual App.tsx wiring needed — DynamicRouter resolves at runtime
-    4. **INVOKE Skill("ui-components")** — pass entity context:
+    4. **INVOKE Skill("ui-components")** — pass entity context + PRD spec:
        - Entity: {EntityName}, Module: {ModuleName}, App: {AppName}
        - Page types: List, Detail, Create, Edit (+ Dashboard if applicable)
        - "CSS: Use CSS variables ONLY — bg-[var(--bg-card)], text-[var(--text-primary)]"
        - "Forms: Create/Edit are FULL PAGES with own routes (/create, /:id/edit)"
        - "I18n: ALL text uses t('namespace:key', 'Fallback')"
+       - {buildPrdBlock(EntityName)} — append the PRD specification block from companion specs
+       - "COLUMNS ARE AUTHORITATIVE: Do NOT infer columns from entity attributes. Use ALL columns from the PRD SPECIFICATION block above, in the EXACT order listed."
+       - "LABELS ARE AUTHORITATIVE: Use PRD SECTION LABELS for i18n t() fallback text."
+       - "ACTIONS ARE AUTHORITATIVE: Implement ALL action buttons listed in the PRD SPECIFICATION."
     5. I18n: 4 JSON files (fr, en, it, de) + register namespace in i18n config
     6. Form tests: co-located .test.tsx for Create and Edit pages
 ```
@@ -281,6 +418,91 @@ When delegating to `/ui-components` skill, include explicit instructions:
 - "CSS: Use CSS variables ONLY — `bg-[var(--bg-card)]`, `text-[var(--text-primary)]`."
 - "Forms: Create/Edit forms are FULL PAGES with own routes (e.g., `/create`, `/:id/edit`)."
 - "I18n: ALL text must use `t('namespace:key', 'Fallback')`. Generate JSON files in `src/i18n/locales/`."
+- "Hooks: MUST use apiClient from @/services/api — NEVER raw fetch() or direct axios import."
+- "PRD COLUMNS: If a `--- PRD SPECIFICATION ---` block is present, use its columns[] as the EXACT DataTable columns. Do NOT add, remove, or reorder. Do NOT infer columns from entity attributes — the PRD is the source of truth."
+- "PRD LABELS: If a `--- PRD SPECIFICATION ---` block is present, use its SECTION LABELS for page titles and i18n fallback text in all 4 languages."
+- "PRD ACTIONS: If a `--- PRD SPECIFICATION ---` block lists actions (approve, reject, export, etc.), generate the corresponding buttons and handlers."
+
+### ⛔ POST-GENERATION VERIFICATION GATES (MANDATORY — run after ALL pages are created)
+
+> **These checks are BLOCKING.** Do not commit until ALL pass. Each check targets a known failure mode
+> observed in production runs where the agent bypassed /ui-components or delegated pages to Snipper agents.
+
+```
+### GATE PG-1: /ui-components Skill Invocation Check
+# Verify that Skill("ui-components") was actually called during this layer execution.
+# The HARD RULE says: "If ANY .tsx page was created by Write tool WITHOUT a prior
+# Skill('ui-components') call, the frontend layer is INVALID."
+#
+# How to verify: Review your own tool call history in this conversation.
+# IF you created ANY .tsx file in src/pages/ WITHOUT calling Skill("ui-components") first:
+#   → FAIL — delete ALL pages in src/pages/, invoke Skill("ui-components"), regenerate.
+#   → This is NOT optional. Pages generated without the skill WILL use fictional CSS classes,
+#     raw HTML <table>, and miss DataTable/EntityCard/CSS variables/responsive design.
+
+### GATE PG-2: Page Completeness Check (4 page types per section)
+# For each section that has a ListPage, verify ALL 4 page types exist:
+for section_dir in $(find src/pages -mindepth 2 -maxdepth 3 -type d); do
+  section_name=$(basename "$section_dir")
+  has_list=$(find "$section_dir" -name "*List*Page.tsx" | head -1)
+  if [ -n "$has_list" ]; then
+    has_detail=$(find "$section_dir" -name "*Detail*Page.tsx" | head -1)
+    has_create=$(find "$section_dir" -name "*Create*Page.tsx" -o -name "Create*Page.tsx" | head -1)
+    has_edit=$(find "$section_dir" -name "*Edit*Page.tsx" -o -name "Edit*Page.tsx" | head -1)
+    if [ -z "$has_detail" ] || [ -z "$has_create" ] || [ -z "$has_edit" ]; then
+      echo "FAIL PG-2: $section_dir missing pages: detail=${has_detail:-MISSING} create=${has_create:-MISSING} edit=${has_edit:-MISSING}"
+      # → Generate missing pages via Skill("ui-components")
+    fi
+  fi
+done
+
+### GATE PG-3: No Stub Pages ("Under development" detection)
+# Pages must be fully implemented — not placeholders.
+grep -rl "Under development\|Under construction\|TODO.*implement\|Coming soon" src/pages/ && {
+  echo "FAIL PG-3: Stub pages detected — all pages must be fully implemented"
+  # → For each stub: invoke Skill("ui-components") to generate the real implementation
+  # → Stubs are NEVER acceptable as deliverables
+}
+
+### GATE PG-4: I18n Namespace Registration Check
+# JSON translation files MUST be imported in i18n config. Missing imports cause
+# all translation keys to render as raw strings (e.g., "list.title" instead of "Liste des employés").
+I18N_CONFIG=$(find src -path "*/i18n/index.ts" -o -path "*/i18n/config.ts" | head -1)
+if [ -n "$I18N_CONFIG" ]; then
+  for json_file in $(find src -path "*/i18n/locales/fr/*.json" -type f); do
+    namespace=$(basename "$json_file" .json)
+    if ! grep -q "$namespace" "$I18N_CONFIG"; then
+      echo "FAIL PG-4: Namespace '$namespace' not registered in $I18N_CONFIG"
+      # → Add import + registration for all 4 languages (fr, en, it, de)
+    fi
+  done
+fi
+
+### GATE PG-5: No Raw fetch() in Hooks
+# Hooks MUST use apiClient from @/services/api (which handles auth, token refresh, tenant isolation).
+# Raw fetch() bypasses authentication and session management.
+grep -rl "fetch(" src/hooks/ && {
+  echo "FAIL PG-5: Raw fetch() found in hooks — must use apiClient from @/services/api"
+  # → Rewrite hooks to use: import apiClient from '@/services/api';
+  # → Replace fetch() calls with apiClient.get(), apiClient.post(), etc.
+}
+
+### GATE PG-6: No Fictional CSS Classes
+# Pages MUST use Tailwind + CSS variables. Fictional classes indicate /ui-components was bypassed.
+FICTIONAL_CLASSES="page-container\|page-header\|page-actions\|filter-bar\|data-table\|btn btn-primary\|btn btn-outline\|btn-sm\|loading-spinner\|empty-state"
+grep -rl "$FICTIONAL_CLASSES" src/pages/ && {
+  echo "FAIL PG-6: Fictional CSS classes found — pages were not generated by /ui-components"
+  # → Delete ALL pages, invoke Skill("ui-components"), regenerate from scratch
+}
+
+### GATE PG-7: Agent Boundary Verification
+# This is a self-check: review all Agent() calls made during Layer 3.
+# IF any Agent(subagent_type='Snipper') prompt contained "Page.tsx" or "pages/" file creation:
+#   → VIOLATION of the agent boundary rule (Snipper cannot generate pages)
+#   → Delete pages created by Snipper, regenerate via Skill("ui-components")
+```
+
+> **If ANY gate fails:** Fix the issue, then re-run ALL gates. Do not commit with failures.
 
 ### Frontend Tests Inline
 

package/templates/skills/apex/steps/step-04-examine.md

@@ -168,6 +168,168 @@ for (const providerFile of providerFiles) {
 
 ---
 
+## 6d. PRD Compliance Verification (delegate mode only)
+
+> **Run ONLY when `delegate_mode` is true AND companion spec files exist.**
+> This checks that generated code matches PRD specifications — not just technical quality.
+> The PRD companion files are the AUTHORITATIVE source for columns, actions, labels, and permissions.
+
+```javascript
+if (delegate_mode) {
+  const specsDir = path.dirname(delegate_prd_path);
+  const prd = readJSON(delegate_prd_path);
+
+  const screensPath = path.join(specsDir, prd.specificationFiles?.screens);
+  const permsPath = path.join(specsDir, prd.specificationFiles?.permissions);
+  const screens = fileExists(screensPath) ? readJSON(screensPath) : null;
+  const perms = fileExists(permsPath) ? readJSON(permsPath) : null;
+
+  if (screens) {
+    // ──── PC-1 (BLOCKING): Column Completeness ────
+    // Every column defined in screens.json SmartTable resources MUST exist in the generated ListPage.
+    for (const section of screens.sections) {
+      for (const resource of (section.resources || [])) {
+        if (resource.type !== 'SmartTable' || !resource.columns) continue;
+        const entityName = resource.entity;
+        // Find the corresponding ListPage
+        const listPages = Glob(`src/pages/**/${entityName}*ListPage.tsx`);
+        if (listPages.length === 0) {
+          BLOCKING(`PC-1: No ListPage found for entity ${entityName} (section: ${section.code})`);
+          continue;
+        }
+        const pageContent = readFile(listPages[0]);
+        const missingCols = [];
+        for (const col of resource.columns) {
+          // Check for the column field name in the page content
+          if (!pageContent.includes(col.field)) {
+            missingCols.push(`${col.field} (${col.format})`);
+          }
+        }
+        if (missingCols.length > 0) {
+          BLOCKING(`PC-1: ${listPages[0]} missing ${missingCols.length}/${resource.columns.length} columns: ${missingCols.join(', ')}. ` +
+            `Fix: re-invoke Skill("ui-components") with the PRD SPECIFICATION block containing ALL columns.`);
+        }
+      }
+    }
+
+    // ──── PC-2 (BLOCKING): Action Button Completeness ────
+    // Actions defined in screens.json MUST have corresponding handlers in the generated pages.
+    for (const section of screens.sections) {
+      for (const resource of (section.resources || [])) {
+        if (!resource.actions || resource.actions.length === 0) continue;
+        const entityName = resource.entity;
+        const pages = Glob(`src/pages/**/${entityName}*Page.tsx`);
+        const allContent = pages.map(p => readFile(p)).join('\n');
+
+        for (const action of resource.actions) {
+          let found = false;
+          switch (action) {
+            case 'create': found = allContent.includes('navigate') && allContent.includes('create'); break;
+            case 'edit':    found = allContent.includes('edit') || allContent.includes('Edit'); break;
+            case 'delete':  found = allContent.includes('delete') || allContent.includes('Delete'); break;
+            case 'approve': found = allContent.includes('approve') || allContent.includes('Approve'); break;
+            case 'reject':  found = allContent.includes('reject') || allContent.includes('Reject'); break;
+            case 'export':  found = allContent.includes('export') || allContent.includes('Export'); break;
+            default:        found = allContent.toLowerCase().includes(action.toLowerCase());
+          }
+          if (!found) {
+            BLOCKING(`PC-2: ${entityName} pages missing action handler for '${action}' (section: ${section.code}). ` +
+              `Fix: add ${action} button/handler to the relevant page.`);
+          }
+        }
+      }
+    }
+
+    // ──── PC-3 (WARNING): I18n Label Accent Accuracy ────
+    // French/German/Italian labels MUST have proper UTF-8 accents.
+    const ACCENT_PATTERNS_FR = {
+      'Employes': 'Employés', 'Departement': 'Département', 'Departements': 'Départements',
+      'Prenom': 'Prénom', 'Numero': 'Numéro', 'Societe': 'Société',
+      'Categorie': 'Catégorie', 'Securite': 'Sécurité', 'Conge': 'Congé', 'Conges': 'Congés',
+      'Generalites': 'Généralités', 'Resume': 'Résumé', 'Echeance': 'Échéance'
+    };
+    const i18nFiles = Glob(`src/**/i18n/locales/fr/*.json`);
+    for (const file of i18nFiles) {
+      const content = readFile(file);
+      for (const [ascii, accented] of Object.entries(ACCENT_PATTERNS_FR)) {
+        if (content.includes(`"${ascii}"`) || content.includes(`"${ascii} `)) {
+          WARNING(`PC-3: ${file} contains ASCII-only '${ascii}' — should be '${accented}'. Fix the accent.`);
+        }
+      }
+    }
+
+    // ──── PC-5 (WARNING): Section Page Completeness ────
+    // Every primary/functional section in screens.json should have a corresponding page.
+    for (const section of screens.sections) {
+      if (!['primary', 'functional'].includes(section.sectionType)) continue;
+      const sectionCode = section.code;
+      const resources = section.resources || [];
+      const entityNames = resources.map(r => r.entity).filter(Boolean);
+
+      // Check if any page exists for this section's entities
+      let pageFound = false;
+      for (const entity of entityNames) {
+        const pages = Glob(`src/pages/**/${entity}*Page.tsx`);
+        if (pages.length > 0) { pageFound = true; break; }
+      }
+      // Also check by section code (e.g., CalendarPage, ApprovePage)
+      if (!pageFound) {
+        const sectionPages = Glob(`src/pages/**/*${sectionCode}*Page.tsx`);
+        pageFound = sectionPages.length > 0;
+      }
+      if (!pageFound) {
+        WARNING(`PC-5: Section '${sectionCode}' (${section.sectionType}) defined in screens.json ` +
+          `but no corresponding page found. Consider generating it.`);
+      }
+    }
+  }
+
+  if (perms) {
+    // ──── PC-4 (BLOCKING): Permission Seed Data Completeness ────
+    // All permissionPaths from permissions.json MUST be seeded in PermissionsSeedData.
+    const permSeedFiles = Glob(`**/PermissionsSeedData.cs`);
+    const permClassFiles = Glob(`**/Permissions.cs`);
+    const allPermContent = [...permSeedFiles, ...permClassFiles].map(f => readFile(f)).join('\n');
+
+    for (const path of perms.permissionPaths) {
+      // Check for the permission path (may be stored as kebab-case or segments)
+      const segments = path.split('.');
+      const lastSegment = segments[segments.length - 1].toLowerCase();
+      if (!allPermContent.toLowerCase().includes(lastSegment)) {
+        BLOCKING(`PC-4: Permission path '${path}' not found in seed data. ` +
+          `Fix: add to PermissionsSeedData.cs and Permissions.cs constants.`);
+      }
+    }
+
+    // Verify roles from permissions.json exist in RolesSeedData
+    const roleSeedFiles = Glob(`**/RolesSeedData.cs`);
+    const allRoleContent = roleSeedFiles.map(f => readFile(f)).join('\n');
+    for (const role of perms.roles) {
+      if (!allRoleContent.includes(role.role)) {
+        WARNING(`PC-4b: Role '${role.role}' from permissions.json not found in RolesSeedData.cs.`);
+      }
+    }
+  }
+
+  // ──── PC-6 (WARNING): I18n Namespace Registration ────
+  // This overlaps with GATE PG-4 but cross-checks against screens.json sections.
+  const i18nConfig = Glob(`src/**/i18n/config.ts`)[0] || Glob(`src/**/i18n/index.ts`)[0];
+  if (i18nConfig && screens) {
+    const configContent = readFile(i18nConfig);
+    const moduleCode = prd.project?.module;
+    if (moduleCode && !configContent.includes(moduleCode)) {
+      WARNING(`PC-6: Module namespace '${moduleCode}' not registered in ${i18nConfig}. ` +
+        `Translation keys will render as raw strings.`);
+    }
+  }
+}
+```
+
+> **If ANY BLOCKING check fails:** Return to step-03d to fix the specific issue, then re-run section 6d.
+> BLOCKING failures indicate the generated code does NOT match the PRD specification.
+
+---
+
 ## 7. Acceptance Criteria POST-CHECK
 
 For each AC from step-01:
@@ -210,6 +372,7 @@ AC1: {criterion} → PASS / FAIL (evidence)
 | Navigation translations (4 langs) | PASS / N/A |
 | Inline tests | PASS / N/A |
 | POST-CHECKs | PASS / N/A |
+| PRD Compliance (delegate) | PASS / N/A |
 | Acceptance criteria | {X}/{Y} PASS |
 
 ---