@atlashub/smartstack-cli 4.31.0 → 4.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "4.31.0",
+  "version": "4.32.0",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",

package/templates/skills/apex/references/parallel-execution.md

@@ -98,14 +98,26 @@ Layer 2 (Backend) — if multiple entities:
   # Launched in parallel in a single message
 
 Layer 3 (Frontend) — if multiple entities:
+  # ⛔ AGENT BOUNDARY: Snipper agents do NOT have access to Skill().
+  # Pages (.tsx) MUST be generated by the principal agent via Skill("ui-components").
+  # Snipper agents handle ONLY: API clients, routes, wiring, i18n — NOT pages.
+
+  # PHASE A — Parallel: infrastructure (Snipper agents)
   Agent(subagent_type='Snipper', model='opus',
-    prompt='Execute Layer 3 frontend for {Entity1}: pages, i18n, routes...')
+    prompt='Execute Layer 3 INFRASTRUCTURE for {Entity1}: API client, routes, wiring, i18n.
+            DO NOT generate any .tsx page files — pages are handled by the principal agent.')
   Agent(subagent_type='Snipper', model='opus',
-    prompt='Execute Layer 3 frontend for {Entity2}: pages, i18n, routes...')
+    prompt='Execute Layer 3 INFRASTRUCTURE for {Entity2}: API client, routes, wiring, i18n.
+            DO NOT generate any .tsx page files — pages are handled by the principal agent.')
   # Launched in parallel in a single message
+
+  # PHASE B — Sequential: pages (principal agent only)
+  # After all Snipper agents complete, principal generates pages via Skill("ui-components").
+  # See step-03-execute.md Layer 3 HARD RULE for full protocol.
 ```
 
 Each agent has an **isolated scope**: handles one entity end-to-end within the layer.
+**Exception:** Layer 3 pages are NOT delegated — see step-03 HARD RULE.
 
 ---
 
@@ -129,8 +141,9 @@ Each agent has an **isolated scope**: handles one entity end-to-end within the l
 5. Layer 2: launch Snipper agents per entity (if multi-entity) OR agent principal (if single)
 6. Build gate: dotnet build → MUST PASS
 7. Backend tests inline (scaffold + run + fix max 3)
-8. Layer 3: launch Snipper agents per entity (if multi-entity) OR agent principal (if single)
-9. Compliance gate: 5 frontend checks → MUST PASS
+8. Layer 3 Phase A: launch Snipper agents for infra (api-client, routes, i18n) — NOT pages
+9. Layer 3 Phase B: principal agent generates ALL pages via Skill("ui-components") — sequential
+10. Compliance gate: 6 frontend checks → MUST PASS
 10. Frontend tests inline (scaffold + run + fix max 3)
 11. Layer 4 (optional): agent principal executes DevData
 ```
@@ -151,6 +164,6 @@ There is no idle state to manage — the agent principal simply waits for result
 | economy_mode = true | NO parallel agents, all sequential |
 | Single entity (any layer) | NO parallel agents, agent principal handles all |
 | Multiple entities, Layer 2 | Parallel: one Snipper agent per entity (service + controller) |
-| Multiple entities, Layer 3 | Parallel: one Snipper agent per entity (pages + i18n) |
+| Multiple entities, Layer 3 | Parallel: Snipper agents for infra (api-client, routes, i18n) — pages by principal via Skill("ui-components") |
 | Layer 0, Layer 1, Layer 4 | NO parallel agents (sequential by nature) |
 | Analysis phase (step-01) | Parallel: 2-3 Explore agents (backend + frontend + context) |

package/templates/skills/apex/references/smartstack-frontend-compliance.md

@@ -591,4 +591,26 @@ if [ -n "$PAGE_FILES" ]; then
 fi
 ```
 
-> **ALL 5 gates MUST pass before frontend commit.** When delegating to `/ui-components` skill, include explicit instructions: CSS variables only, forms as full pages, i18n with namespace + fallback.
+### Gate 6: SmartStack Components (no raw HTML tables)
+
+```bash
+PAGE_FILES=$(find src/pages/ -name "*.tsx" 2>/dev/null | grep -v "\.test\." | grep -v node_modules)
+if [ -n "$PAGE_FILES" ]; then
+  FAIL=false
+  RAW_TABLE=$(grep -Pn '<table[> ]|<tr[> ]|<td[> ]|<th[> ]' $PAGE_FILES 2>/dev/null)
+  if [ -n "$RAW_TABLE" ]; then
+    echo "BLOCKING: Raw HTML <table>/<tr>/<td> found — pages MUST use DataTable component (invoke /ui-components)"
+    echo "$RAW_TABLE"
+    FAIL=true
+  fi
+  RAW_CSS=$(grep -Pn 'style=\{?\{|style="[^"]*"' $PAGE_FILES 2>/dev/null | grep -v "className")
+  if [ -n "$RAW_CSS" ]; then
+    echo "BLOCKING: Inline CSS style= found — pages MUST use Tailwind + CSS variables (invoke /ui-components)"
+    echo "$RAW_CSS"
+    FAIL=true
+  fi
+  if [ "$FAIL" = false ]; then echo "PASS: SmartStack components (no raw HTML)"; fi
+fi
+```
+
+> **ALL 6 gates MUST pass before frontend commit.** When delegating to `/ui-components` skill, include explicit instructions: CSS variables only, forms as full pages, i18n with namespace + fallback.

package/templates/skills/apex/steps/step-03-execute.md

@@ -454,6 +454,29 @@ test({module}): backend unit and integration tests
 
 ## Layer 3 — Frontend (Pages + I18n + Documentation)
 
+### ⛔ 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
+> a prior Skill("ui-components") call in this execution, the frontend layer is INVALID.
+>
+> **You MUST NOT:**
+> - Generate .tsx page code in Agent prompts and dispatch to Snipper agents
+> - Write page content directly via the Write tool
+> - Copy-paste page templates from your knowledge
+>
+> **You MUST:**
+> - Call Skill("ui-components") which loads the style guide, responsive guidelines,
+>   accessibility rules, and pattern files (entity-card, data-table, dashboard-chart, grid-layout, kanban)
+> - Let /ui-components generate all pages with correct conventions
+>
+> **Why this matters:** Without the skill, pages miss CSS variables, DataTable/EntityCard,
+> memo()/useCallback, responsive mobile-first design, and accessibility patterns.
+>
+> **Agent boundary rule:** Snipper sub-agents DO NOT have access to the Skill tool.
+> Therefore, .tsx page generation MUST NEVER be delegated to Snipper agents.
+> Pages are ALWAYS generated by the principal agent via Skill("ui-components").
+> Snipper agents handle: API clients, routes, wiring, i18n, tests — NOT pages.
+
 ### Load Frontend References (deferred from top of step)
 
 - Read `references/smartstack-frontend.md` now — lazy loading, i18n, page structure, CSS variables, EntityLookup (sections 1-6)
@@ -668,43 +691,21 @@ When launching agents for multi-entity layers:
 
 ### Frontend Compliance Gate
 
-> See `references/smartstack-frontend.md` section 9 "Compliance Gates" for all 5 required checks:
+> See `references/smartstack-frontend-compliance.md` section 9 "Compliance Gates" for all 6 required checks:
 > 1. CSS Variables (theme system)
 > 2. Forms as Pages (zero modals/drawers/slide-overs)
 > 3. I18n File Structure (4 languages, separate JSON files)
 > 4. Lazy Loading (React.lazy() — no static imports)
 > 5. useTranslation in Pages (all text translated)
+> 6. SmartStack Components (no raw HTML tables — DataTable/EntityCard required)
 
-Do not commit frontend changes until all 5 gates pass.
+Do not commit frontend changes until all 6 gates pass.
 
 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/`."
 
-### HARD RULE — /ui-components is NON-NEGOTIABLE
-
-> **VIOLATION CHECK:** If ANY .tsx page file was created by Write tool WITHOUT
-> a prior Skill("ui-components") call in this execution, the frontend layer is INVALID.
->
-> **You MUST NOT:**
-> - Generate .tsx page code in Agent prompts and dispatch to Snipper agents
-> - Write page content directly via the Write tool
-> - Copy-paste page templates from your knowledge
->
-> **You MUST:**
-> - Call Skill("ui-components") which loads the style guide, responsive guidelines,
->   accessibility rules, and pattern files (entity-card, data-table, dashboard-chart, grid-layout, kanban)
-> - Let /ui-components generate all pages with correct conventions
->
-> **Why this matters:** Without the skill, pages miss CSS variables, DataTable/EntityCard,
-> memo()/useCallback, responsive mobile-first design, and accessibility patterns.
->
-> **Agent boundary rule:** Snipper sub-agents DO NOT have access to the Skill tool.
-> Therefore, .tsx page generation MUST NEVER be delegated to Snipper agents.
-> Pages are ALWAYS generated by the principal agent via Skill("ui-components").
-> Snipper agents handle: API clients, routes, wiring, i18n, tests — NOT pages.
-
 ### Frontend Tests Inline
 
 > **Tests are scaffolded and run WITHIN Layer 3, not deferred to step-07.**