@atlashub/smartstack-cli 2.5.3 → 2.6.1

package/package.json

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

package/templates/mcp-scaffolding/component.tsx.hbs

@@ -134,8 +134,8 @@ export const {{name}}: React.FC<{{name}}Props> = ({
   if (isLoading && !data.id) {
     return (
       <div className="flex items-center justify-center p-8">
-        <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-500" />
-        <span className="ml-2 text-gray-600">Loading...</span>
+        <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-[var(--color-accent-500)]" />
+        <span className="ml-2 text-[var(--text-secondary)]">Loading...</span>
       </div>
     );
   }
@@ -143,16 +143,16 @@ export const {{name}}: React.FC<{{name}}Props> = ({
   // Render error state
   if (error) {
     return (
-      <div className="p-4 bg-red-50 border border-red-200 rounded-lg">
+      <div className="p-4 bg-[var(--error-bg)] border border-[var(--error-border)] rounded-[var(--radius-card)]">
         <div className="flex items-center">
-          <svg className="h-5 w-5 text-red-400" viewBox="0 0 20 20" fill="currentColor">
+          <svg className="h-5 w-5 text-[var(--error-text)]" viewBox="0 0 20 20" fill="currentColor">
             <path fillRule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z" clipRule="evenodd" />
           </svg>
-          <span className="ml-2 text-red-700">{error}</span>
+          <span className="ml-2 text-[var(--error-text)]">{error}</span>
         </div>
         <button
           onClick={() => id && fetchData(id)}
-          className="mt-2 text-sm text-red-600 hover:text-red-800 underline"
+          className="mt-2 text-sm text-[var(--error-text)] hover:opacity-80 underline"
         >
           Try again
         </button>
@@ -161,33 +161,33 @@ export const {{name}}: React.FC<{{name}}Props> = ({
   }
 
   return (
-    <div className="bg-white rounded-lg shadow-sm border border-gray-200">
+    <div className="bg-[var(--bg-card)] rounded-[var(--radius-card)] shadow-sm border border-[var(--border-color)]">
       {/* Header */}
-      <div className="px-6 py-4 border-b border-gray-200">
-        <h2 className="text-xl font-semibold text-gray-900">
+      <div className="px-6 py-4 border-b border-[var(--border-color)]">
+        <h2 className="text-xl font-semibold text-[var(--text-primary)]">
           {id ? 'Edit' : 'Create'} {{name}}
         </h2>
         {isDirty && (
-          <span className="text-sm text-amber-600">Unsaved changes</span>
+          <span className="text-sm text-[var(--warning-text)]">Unsaved changes</span>
         )}
       </div>
 
       {/* Form */}
       <form onSubmit={handleSubmit} className="p-6 space-y-6">
         {/* TODO: Add form fields */}
-        <div className="text-gray-500 text-center py-8">
+        <div className="text-[var(--text-secondary)] text-center py-8">
           Add your form fields here
         </div>
 
         {/* Actions */}
         {!readOnly && (
-          <div className="flex items-center justify-end gap-3 pt-4 border-t border-gray-200">
+          <div className="flex items-center justify-end gap-3 pt-4 border-t border-[var(--border-color)]">
             {onCancel && (
               <button
                 type="button"
                 onClick={handleCancel}
                 disabled={isLoading}
-                className="px-4 py-2 text-gray-700 bg-white border border-gray-300 rounded-lg hover:bg-gray-50 disabled:opacity-50"
+                className="px-4 py-2 text-[var(--text-secondary)] bg-[var(--bg-secondary)] border border-[var(--border-color)] rounded-[var(--radius-button)] hover:bg-[var(--bg-hover)] disabled:opacity-50"
               >
                 Cancel
               </button>
@@ -195,7 +195,7 @@ export const {{name}}: React.FC<{{name}}Props> = ({
             <button
               type="submit"
               disabled={isLoading || !isDirty}
-              className="px-4 py-2 text-white bg-blue-600 rounded-lg hover:bg-blue-700 disabled:opacity-50 disabled:cursor-not-allowed"
+              className="px-4 py-2 text-white bg-[var(--color-accent-600)] rounded-[var(--radius-button)] hover:bg-[var(--color-accent-700)] disabled:opacity-50 disabled:cursor-not-allowed"
             >
               {isLoading ? 'Saving...' : 'Save'}
             </button>

package/templates/mcp-scaffolding/controller.cs.hbs

@@ -5,6 +5,7 @@ using System.Threading.Tasks;
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.Extensions.Logging;
+using SmartStack.Api.Authorization;
 
 namespace {{namespace}}.Controllers;
 
@@ -39,7 +40,7 @@ public class {{name}}Controller : ControllerBase
     /// <returns>List of {{namePlural}}</returns>
     [HttpGet]
 {{#if navRoute}}
-    [Authorize(Policy = "{{navRoute}}.read")]
+    [RequirePermission("{{navRoute}}.read")]
 {{/if}}
     [ProducesResponseType(typeof(IEnumerable<{{name}}Dto>), 200)]
     public async Task<ActionResult<IEnumerable<{{name}}Dto>>> GetAll(CancellationToken cancellationToken = default)
@@ -61,7 +62,7 @@ public class {{name}}Controller : ControllerBase
     /// <returns>{{name}} details</returns>
     [HttpGet("{id:guid}")]
 {{#if navRoute}}
-    [Authorize(Policy = "{{navRoute}}.read")]
+    [RequirePermission("{{navRoute}}.read")]
 {{/if}}
     [ProducesResponseType(typeof({{name}}Dto), 200)]
     [ProducesResponseType(404)]
@@ -87,7 +88,7 @@ public class {{name}}Controller : ControllerBase
     /// <returns>Created {{nameCamel}}</returns>
     [HttpPost]
 {{#if navRoute}}
-    [Authorize(Policy = "{{navRoute}}.create")]
+    [RequirePermission("{{navRoute}}.create")]
 {{/if}}
     [ProducesResponseType(typeof({{name}}Dto), 201)]
     [ProducesResponseType(400)]
@@ -113,7 +114,7 @@ public class {{name}}Controller : ControllerBase
     /// <param name="cancellationToken">Cancellation token</param>
     [HttpPut("{id:guid}")]
 {{#if navRoute}}
-    [Authorize(Policy = "{{navRoute}}.update")]
+    [RequirePermission("{{navRoute}}.update")]
 {{/if}}
     [ProducesResponseType(204)]
     [ProducesResponseType(404)]
@@ -138,7 +139,7 @@ public class {{name}}Controller : ControllerBase
     /// <param name="cancellationToken">Cancellation token</param>
     [HttpDelete("{id:guid}")]
 {{#if navRoute}}
-    [Authorize(Policy = "{{navRoute}}.delete")]
+    [RequirePermission("{{navRoute}}.delete")]
 {{/if}}
     [ProducesResponseType(204)]
     [ProducesResponseType(404)]

package/templates/skills/_resources/docs-manifest-schema.md

@@ -23,7 +23,7 @@ The `docs-manifest.json` file maps code modules to their documentation artifacts
         "src/SmartStack.Api/Controllers/Business/{Module}Controller.cs"
       ],
       "docFiles": [
-        "web/smartstack-web/src/pages/docs/business/{app}/{module}/frd-data.ts",
+        "web/smartstack-web/src/pages/docs/business/{app}/{module}/doc-data.ts",
         "web/smartstack-web/src/i18n/locales/fr/docs-{app}-{module}.json"
       ],
       "baOutputs": [
@@ -58,7 +58,7 @@ The `docs-manifest.json` file maps code modules to their documentation artifacts
 | `featureId` | string | Yes | BA feature ID (FEAT-NNN) |
 | `displayName` | string | Yes | Human-readable module name |
 | `codeFiles` | string[] | Yes | Source code files for this module |
-| `docFiles` | string[] | Yes | Documentation files (frd-data.ts, i18n) |
+| `docFiles` | string[] | Yes | Documentation files (doc-data.ts, i18n) |
 | `baOutputs` | string[] | No | Business Analysis output directory |
 | `screenshots` | object | No | Map of stepKey → image path |
 | `lastCodeChange` | ISO date | Yes | Last code modification timestamp |
@@ -119,7 +119,7 @@ ELSE:
         "src/SmartStack.Api/Controllers/Business/SlaController.cs"
       ],
       "docFiles": [
-        "web/smartstack-web/src/pages/docs/business/support/sla/frd-data.ts",
+        "web/smartstack-web/src/pages/docs/business/support/sla/doc-data.ts",
         "web/smartstack-web/src/i18n/locales/fr/docs-support-sla.json"
       ],
       "baOutputs": [

package/templates/skills/_resources/mcp-validate-documentation-spec.md

@@ -65,11 +65,11 @@ FOR each module in manifest:
 ### completeness
 Verify that documented modules have all 8 business-first sections.
 
-**Input:** frd-data.ts files, i18n JSON files
+**Input:** doc-data.ts files, i18n JSON files
 **Logic:**
 ```
 FOR each module with documentation:
-  Read frd-data.ts
+  Read doc-data.ts
   Check presence of:
     1. overview (valeur métier)
     2. useCases (cas d'usage)
@@ -99,21 +99,21 @@ FOR each module with documentation:
 ### accuracy
 Compare documented permissions, endpoints, and entities against actual code.
 
-**Input:** frd-data.ts, controllers, PermissionConfiguration.cs, entities
+**Input:** doc-data.ts, controllers, PermissionConfiguration.cs, entities
 **Logic:**
 ```
 FOR each module:
-  documentedPermissions = frdData.permissions
+  documentedPermissions = docData.permissions
   actualPermissions = scan PermissionConfiguration.cs for module path
   IF documentedPermissions != actualPermissions:
     issues.push("permission mismatch")
 
-  documentedEndpoints = frdData.apiEndpoints
+  documentedEndpoints = docData.apiEndpoints
   actualEndpoints = scan Controller for [Http*] attributes
   IF documentedEndpoints != actualEndpoints:
     issues.push("endpoint mismatch")
 
-  documentedEntities = frdData (entity references)
+  documentedEntities = docData (entity references)
   actualEntities = scan Domain/Entities for module
   IF documentedEntities != actualEntities:
     issues.push("entity mismatch")

package/templates/skills/apex/steps/step-04b-doc-sync.md

@@ -92,14 +92,14 @@ For each affected module:
 - Agent returns structured summary of current doc state
 
 **If {economy_mode} = true:**
-- Read `frd-data.ts` directly
+- Read `doc-data.ts` directly
 - Read i18n FR file directly
 
 ### 5. Update Documentation Data
 
 For each affected module and impacted section:
 
-1. Read current `frd-data.ts`
+1. Read current `doc-data.ts`
 2. Compare with actual code state
 3. Update affected fields:
    - **apiEndpoints**: Scan controller for `[Http*]` attributes
@@ -107,7 +107,7 @@ For each affected module and impacted section:
    - **businessRules**: Scan validators and entity methods
    - **useCases**: Update if commands/queries changed
    - **features**: Update if new functionality added
-4. Write updated `frd-data.ts`
+4. Write updated `doc-data.ts`
 5. Update i18n FR file if label keys changed
 
 ### 6. Update Documentation Manifest
@@ -144,7 +144,7 @@ Write `{output_dir}/04b-doc-sync.md` with:
 ## FAILURE MODES:
 
 - docs-manifest.json absent → skip gracefully (not a failure)
-- frd-data.ts has unexpected format → report warning, skip module
+- doc-data.ts has unexpected format → report warning, skip module
 - No modules affected → display "No documented modules affected by changes"
 
 ---

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

@@ -77,7 +77,7 @@ Self-review with checklist:
 - [ ] Clear naming
 
 ## Documentation Checklist
-- [ ] Documented modules updated (frd-data.ts reflects code changes)
+- [ ] Documented modules updated (doc-data.ts reflects code changes)
 - [ ] API endpoints reflected in documentation
 - [ ] Documented permissions match code
 - [ ] i18n keys added for new labels

package/templates/skills/apex/templates/04b-doc-sync.md

@@ -17,7 +17,7 @@
 ## Documentation Updates
 
 ### Module: {{module_path}}
-- **frd-data.ts:** Updated fields: {{fields}}
+- **doc-data.ts:** Updated fields: {{fields}}
 - **i18n FR:** {{updated|no_change}}
 - **Manifest:** Status → synced
 

package/templates/skills/application/SKILL.md

@@ -21,15 +21,18 @@ This skill uses progressive step loading. Each step calls MCP tools for generati
 
 ## STEP FILES
 
-| Step | File | MCP Tool Called |
-|------|------|-----------------|
-| 00 | `steps/step-00-init.md` | `validate_conventions` (MCP check) |
-| 01 | `steps/step-01-navigation.md` | `scaffold_navigation` |
-| 02 | `steps/step-02-permissions.md` | `generate_permissions` |
-| 03 | `steps/step-03-roles.md` | `scaffold_role_permissions` |
-| 04 | `steps/step-04-backend.md` | `scaffold_extension` |
-| 05 | `steps/step-05-frontend.md` | `scaffold_api_client`, `scaffold_routes` |
-| 06 | `steps/step-06-migration.md` | `suggest_migration` |
+| Step | File | MCP Tool Called | Condition |
+|------|------|-----------------|-----------|
+| 00 | `steps/step-00-init.md` | `validate_conventions` (MCP check) | Always |
+| 01 | `steps/step-01-navigation.md` | `scaffold_navigation` | Always |
+| 02 | `steps/step-02-permissions.md` | `generate_permissions` | Always |
+| 03 | `steps/step-03-roles.md` | `scaffold_role_permissions` | Always |
+| 03b | `steps/step-03b-provider.md` | (none - direct generation) | Client projects only |
+| 04 | `steps/step-04-backend.md` | `scaffold_extension` | Always |
+| 05 | `steps/step-05-frontend.md` | `scaffold_api_client`, `scaffold_routes` | Always |
+| 06 | `steps/step-06-migration.md` | `suggest_migration` | Always |
+| 07 | `steps/step-07-tests.md` | `scaffold_tests` | Always |
+| 08 | `steps/step-08-documentation.md` | `/documentation` skill | If userDocRequired |
 
 ## MCP INTEGRATION
 
@@ -45,6 +48,7 @@ This skill uses progressive step loading. Each step calls MCP tools for generati
 | `mcp__smartstack__scaffold_api_client` | TypeScript API client |
 | `mcp__smartstack__scaffold_routes` | React Router configuration |
 | `mcp__smartstack__suggest_migration` | Migration name suggestion |
+| `mcp__smartstack__scaffold_tests` | Test suite generation |
 
 ## WHEN THIS SKILL ACTIVATES
 
@@ -81,15 +85,24 @@ WEB (React) → API (.NET) → Application → Infrastructure → Database
 ```
 1. DB SEED (Navigation + Translations 4 languages)
 2. PERMISSIONS (Permissions.cs + PermissionConfiguration.cs) ← 2 files!
-3. API (Controller + DTOs via /controller:create)
-4. SERVICES (Interface + Implementation)
-5. FRONTEND (Page + Components + Hooks)
-6. I18N (fr, en, it, de)
-7. ROUTES (nested routes mandatory)
-8. PREFERENCES (Hook pattern)
-9. MIGRATION (/efcore:migration)
+3. ROLES (RolePermission mappings)
+3b. CLIENT SEED PROVIDER (client projects only - IClientSeedDataProvider)
+4. API (Controller + DTOs via /controller:create)
+5. SERVICES (Interface + Implementation)
+6. FRONTEND (Page + Components + Hooks)
+7. I18N (fr, en, it, de)
+8. ROUTES (nested routes mandatory)
+9. PREFERENCES (Hook pattern)
+10. MIGRATION (/efcore:migration)
+11. TESTS (scaffold_tests - 6 categories)
+12. DOCUMENTATION (in-app user doc via /documentation - if userDocRequired)
 ```
 
+### 3b. Client Seed Provider (client projects only)
+Generates `IClientSeedDataProvider` implementation that wires navigation + permissions + roles
+into the SmartStack Core seeding pipeline. Only runs when `{seeding_strategy}` = "provider".
+Core projects skip this step entirely.
+
 ### 4. Automatic Chaining
 - `/controller:create` → API Controllers
 - `/efcore:migration` → DB Migrations
@@ -138,6 +151,7 @@ export function use{Module}Preferences() {
 | `/workflow` | Automated emails | IWorkflowService.TriggerAsync |
 | `/ai-prompt` | AI assistance | IAiCompletionService |
 | `/feature-full` | Complete feature | Orchestration all skills |
+| `/documentation` | In-app user doc | Documentation page via doc-data.ts + DocRenderer |
 
 ### Notification Integration Pattern
 ```csharp
@@ -172,9 +186,12 @@ await _workflowService.TriggerAsync("{entity}.created", new Dictionary<string, o
 - [steps/step-01-navigation.md](steps/step-01-navigation.md) - Generate navigation
 - [steps/step-02-permissions.md](steps/step-02-permissions.md) - Generate permissions
 - [steps/step-03-roles.md](steps/step-03-roles.md) - Assign roles
+- [steps/step-03b-provider.md](steps/step-03b-provider.md) - Client seed provider (client projects only)
 - [steps/step-04-backend.md](steps/step-04-backend.md) - Generate backend
 - [steps/step-05-frontend.md](steps/step-05-frontend.md) - Generate frontend
 - [steps/step-06-migration.md](steps/step-06-migration.md) - Create migration
+- [steps/step-07-tests.md](steps/step-07-tests.md) - Generate test suite
+- [steps/step-08-documentation.md](steps/step-08-documentation.md) - Generate in-app documentation
 
 ### Templates (REFERENCE ONLY - Do Not Use Directly)
 > These templates are kept for documentation purposes.

package/templates/skills/application/steps/step-00-init.md

@@ -89,7 +89,79 @@ Args: { checks: ["tables"] }
 **DO NOT** proceed with step files.
 **STOP the skill immediately.**
 
-### 4. Build Full Path
+### 4. Detect Project Type
+
+Read `.smartstack/config.json` at the project root to determine the seeding strategy:
+
+```
+Read: .smartstack/config.json
+Extract: projectType, dbContext
+```
+
+| projectType | dbContext | Seeding Strategy |
+|-------------|----------|-----------------|
+| `core` | `core` | HasData() in Configuration files (existing pattern) |
+| `client` | `extensions` | IClientSeedDataProvider (runtime seeding) |
+
+**If file not found or projectType missing:** Default to `core` / `hasdata`.
+
+Store:
+```
+{project_type} = "core" or "client"
+{db_context} = "core" or "extensions"
+{seeding_strategy} = "hasdata" or "provider"
+```
+
+### 4b. Detect Feature.json Context (Optional Enrichment)
+
+Search for a Business Analysis feature.json for the target module:
+
+```
+Glob: docs/business/*/{code}/business-analyse/v*/feature.json
+      .business-analyse/business/*/modules/{code}/features/*/feature.json
+```
+
+**If found (status = "handed-off" or "consolidated"):**
+
+Read the feature.json and extract context for subsequent steps:
+
+| feature.json Section | Used In Step | Extracted Data |
+|----------------------|-------------|----------------|
+| `analysis.entities[]` | step-04 (backend) | Entity names, attributes, relationships, validations |
+| `specification.useCases[]` | step-04 (backend) | API endpoint definitions beyond basic CRUD |
+| `specification.permissionMatrix` | step-02 (permissions) | Custom permission paths and role assignments |
+| `specification.apiEndpoints[]` | step-04 (backend) | Exact HTTP methods, routes, DTOs |
+| `specification.navigation` | step-01 (navigation) | Navigation hierarchy with labels and icons |
+| `specification.i18nKeys` | step-05 (frontend) | Pre-defined translation keys |
+| `specification.validations[]` | step-04 (backend) | Field-level validation rules |
+| `specification.uiWireframes[]` | step-05 (frontend) | UI layout guidance |
+| `specification.seedDataCore` | step-01, step-02, step-03 | Pre-computed seeds |
+| `analysis.businessRules[]` | step-04, step-07 | Business rules for service logic and tests |
+| `specification.lifeCycles[]` | step-04 (backend) | Entity state machines |
+| `specification.dashboards` | step-05 (frontend) | Dashboard KPIs and chart specs |
+| `documentation` | step-08 | userDocRequired / techDocRequired flags |
+
+Store:
+```
+{feature_json_path} = "path/to/feature.json" or null
+{has_feature_context} = true or false
+{feature_data} = parsed feature.json object (if found)
+```
+
+**If NOT found or status not in ["handed-off", "consolidated"]:**
+
+```
+{has_feature_context} = false
+```
+
+Continue normally. All subsequent steps use their standard generation logic (generic CRUD).
+
+> **When `{has_feature_context} = true`**, subsequent steps SHOULD use the feature.json data
+> to generate more accurate code: entities with correct attributes and relationships, custom
+> permissions beyond basic CRUD, specific API routes, validation rules, and business logic
+> in services. This reduces post-generation manual corrections significantly.
+
+### 5. Build Full Path
 
 ```
 {full_path} = {parentPath}.{code}  (if parentPath exists)
@@ -102,7 +174,7 @@ Example:
   → full_path: erp.sales.products
 ```
 
-### 5. Infer Descriptions (if not provided)
+### 6. Infer Descriptions (if not provided)
 
 ```yaml
 descriptions:
@@ -112,7 +184,7 @@ descriptions:
   de: "Verwaltung von {labels.de}"
 ```
 
-### 6. Show Summary
+### 7. Show Summary
 
 ```
 ## Application Skill: {level} - {code}
@@ -125,6 +197,9 @@ descriptions:
 | Parent | {parentPath} |
 | Icon | {icon} |
 | Display Order | {displayOrder} |
+| Project Type | {project_type} |
+| Seeding Strategy | {seeding_strategy} |
+| Feature.json | {has_feature_context ? feature_json_path : "Not found (standard generation)"} |
 
 ### Labels
 | Language | Label |
@@ -152,6 +227,12 @@ descriptions:
 | `{icon}` | Lucide icon name |
 | `{display_order}` | Numeric display order |
 | `{mcp_available}` | Boolean - MCP connectivity status |
+| `{project_type}` | "core" or "client" (from .smartstack/config.json) |
+| `{db_context}` | "core" or "extensions" (from .smartstack/config.json) |
+| `{seeding_strategy}` | "hasdata" (core) or "provider" (client) |
+| `{feature_json_path}` | Path to feature.json (null if not found) |
+| `{has_feature_context}` | Boolean - whether BA context is available |
+| `{feature_data}` | Parsed feature.json object (null if not found) |
 
 ---
 
@@ -160,6 +241,8 @@ descriptions:
 - Level correctly detected
 - All required parameters extracted
 - MCP availability verified
+- Project type and seeding strategy detected
+- Feature.json detected if available (enrichment context loaded)
 - Full path computed correctly
 - Summary displayed
 - Proceeded to step-01-navigation.md

package/templates/skills/application/steps/step-01-navigation.md

@@ -38,11 +38,16 @@ From step-00-init:
 | `{icon}` | Lucide icon name |
 | `{display_order}` | Numeric display order |
 | `{mcp_available}` | Boolean - MCP connectivity status |
+| `{project_type}` | "core" or "client" |
+| `{seeding_strategy}` | "hasdata" or "provider" |
 
 ---
 
 ## EXECUTION SEQUENCE (MCP Primary)
 
+> **Branch:** If `{seeding_strategy}` = "provider", jump to **CLIENT PROJECT HANDLING** section below.
+> The MCP and FALLBACK sections apply only when `{seeding_strategy}` = "hasdata" (core projects).
+
 ### 1. Call MCP scaffold_navigation
 
 ```
@@ -106,10 +111,39 @@ If MCP call fails or `{mcp_available}` = false:
 
 ---
 
+## CLIENT PROJECT HANDLING
+
+> **Condition:** `{seeding_strategy}` = "provider"
+
+For client projects, navigation is NOT seeded via HasData() in Configuration files.
+It will be seeded at runtime via `IClientSeedDataProvider` generated at step 03b.
+
+### Actions for a client project:
+
+1. **Generate the navigation GUID** (deterministic, same method as core)
+2. **Create the SeedData file** (same pattern as existing)
+   - `Infrastructure/Persistence/Seeding/Data/{Domain}/{Module}NavigationSeedData.cs`
+   - Contains static GUIDs and `GetNavigationEntries()`
+3. **Create the translations file**
+   - `Infrastructure/Persistence/Seeding/Data/{Domain}/{Module}NavigationTranslationSeedData.cs`
+4. **DO NOT search for** `NavigationModuleConfiguration.cs` (does not exist in client projects)
+5. **DO NOT write** HasData() in Configuration files
+6. **Store** `{navigation_guid}` for subsequent steps
+
+The SeedData files will be consumed by the `IClientSeedDataProvider` generated at step 03b.
+
+**After creating SeedData files:** Store `{navigation_guid}` and proceed to step-02-permissions.md.
+
+---
+
 ## FALLBACK PROCEDURE (When MCP Unavailable)
 
 > This procedure generates navigation seeds following SmartStack.app patterns.
 > Reference: `templates-seed.md` for code templates.
+>
+> **Branch by Project Type:**
+> - If `{seeding_strategy}` = "hasdata" (core project): Follow F1-F8 below (existing pattern)
+> - If `{seeding_strategy}` = "provider" (client project): Follow **CLIENT PROJECT HANDLING** above (create SeedData classes only, no HasData)
 
 ### F1. Read Existing Configuration Files
 

package/templates/skills/application/steps/step-02-permissions.md

@@ -32,6 +32,8 @@ From previous steps:
 | `{full_path}` | Complete navigation path (navRoute) |
 | `{navigation_guid}` | GUID of the navigation entity |
 | `{labels}` | Object with fr, en, it, de |
+| `{project_type}` | "core" or "client" |
+| `{seeding_strategy}` | "hasdata" or "provider" |
 
 ---
 
@@ -105,6 +107,38 @@ Store the permission GUIDs for use in step-03-roles:
 
 ---
 
+## CLIENT PROJECT HANDLING
+
+> **Condition:** `{seeding_strategy}` = "provider"
+
+### 1. Call MCP generate_permissions normally
+
+The tool always returns:
+- Permissions.cs constants (Application layer) - **ALWAYS generated** (identical for core and client)
+- PermissionConfiguration.cs HasData - **REDIRECT for client projects**
+
+### 2. Permissions.cs: IDENTICAL
+
+The `Permissions.cs` file in the Application layer is generated identically regardless of project type.
+Write it as usual.
+
+### 3. PermissionConfiguration.cs: REDIRECT
+
+**For core (`{seeding_strategy}` = "hasdata"):** Write HasData() in `PermissionConfiguration.cs` (existing pattern)
+
+**For client (`{seeding_strategy}` = "provider"):** DO NOT write in PermissionConfiguration.cs (does not exist in client projects).
+Instead, create:
+- `Infrastructure/Persistence/Seeding/Data/{Domain}/{Module}PermissionSeedData.cs`
+
+Content: static class with deterministic GUIDs and method `GetPermissionEntries()`.
+These entries will be consumed by the `IClientSeedDataProvider` at step 03b.
+
+### 4. Store Permission GUIDs
+
+Identical to the existing pattern - store `{permission_guids}` for step-03.
+
+---
+
 ## TWO-FILE REQUIREMENT
 
 **CRITICAL:** SmartStack requires permissions in TWO files:
@@ -116,6 +150,9 @@ Store the permission GUIDs for use in step-03-roles:
 
 Both MUST be kept in sync. Missing one = runtime 403 errors.
 
+> **Client project exception:** For `{seeding_strategy}` = "provider", `PermissionConfiguration.cs` is replaced by
+> `{Module}PermissionSeedData.cs` + `IClientSeedDataProvider`. The `Permissions.cs` constants file is still required.
+
 ---
 
 ## MCP RESPONSE HANDLING

package/templates/skills/application/steps/step-03-roles.md

@@ -2,7 +2,7 @@
 name: step-03-roles
 description: Generate role-permission mappings using MCP scaffold_role_permissions (with fallback)
 prev_step: steps/step-02-permissions.md
-next_step: steps/step-04-backend.md
+next_step: steps/step-03b-provider.md
 ---
 
 # Step 3: Role-Permission Mapping
@@ -34,6 +34,8 @@ From previous steps:
 | `{level}` | context, application, module, or section |
 | `{permission_guids}` | GUIDs for generated permissions |
 | `{mcp_available}` | Boolean - MCP connectivity status |
+| `{project_type}` | "core" or "client" |
+| `{seeding_strategy}` | "hasdata" or "provider" |
 
 ---
 
@@ -122,6 +124,23 @@ If MCP call fails or `{mcp_available}` = false:
 
 ---
 
+## CLIENT PROJECT HANDLING
+
+> **Condition:** `{seeding_strategy}` = "provider"
+
+**For core (`{seeding_strategy}` = "hasdata"):** Write in RolePermissionConfiguration.cs (existing pattern)
+
+**For client (`{seeding_strategy}` = "provider"):** DO NOT write in RolePermissionConfiguration.cs (does not exist in client projects).
+Instead, create:
+- `Infrastructure/Persistence/Seeding/Data/{Domain}/{Module}RolePermissionSeedData.cs`
+
+Content: static class with method `GetRolePermissionEntries()` that returns the role-permission mapping data.
+These entries will be consumed by the `IClientSeedDataProvider` at step 03b.
+
+**After creating RolePermission SeedData:** Proceed to step-03b-provider.md (which will skip for core projects).
+
+---
+
 ## FALLBACK PROCEDURE (When MCP Unavailable)
 
 > This procedure generates role-permission HasData entries following SmartStack.app patterns.
@@ -277,4 +296,6 @@ If user selects "Custom adjustments", ask which roles/permissions to change and
 ## NEXT STEP
 
 After role-permission mappings are generated (via MCP or fallback) and written to files,
-proceed to `./step-04-backend.md`
+proceed to `./step-03b-provider.md`
+
+> **Note:** step-03b will automatically skip if `{seeding_strategy}` = "hasdata" and proceed directly to step-04-backend.