@atlashub/smartstack-cli 3.39.0 → 3.40.0

package/templates/skills/apex/references/planning-layer-mapping.md

@@ -1,151 +1,151 @@
-# Planning — Layer Mapping, Skill Assignment, Parallelization Strategy
-
-> **Loaded by:** step-02-plan.md (sections 1-4)
-> **Purpose:** Map analyzed elements to layers, assign skills/MCP tools, and identify parallelization opportunities.
-
----
-
-## Map Changes to Layers
-
-For each element identified in step-01, assign to a SmartStack layer:
-
-| Layer | Category | Order |
-|-------|----------|-------|
-| 0 | Domain (entities, enums, exceptions) | Sequential |
-| 0 | Infrastructure - EF Configs | Sequential |
-| 0 | Infrastructure - Migration (BLOCKING) | Sequential |
-| 1 | Application (services, DTOs, validators) | Parallel |
-| 1 | API (controllers) | Parallel |
-| 1 | Infrastructure - Seed Data | Parallel |
-| 2 | Frontend (pages, components) | Parallel |
-| 2 | I18n (translations) | Parallel |
-| 3 | Tests | Sequential |
-
----
-
-## Entity Definition Template
-
-Each entity in the plan MUST include:
-
-```yaml
-Entity: {EntityName}
-  - tenantMode: strict | optional | scoped | none
-  - codePattern: auto-generated strategy (if applicable)
-  - fkFields: [{field, targetEntity}] (if applicable)
-  - acceptance criteria: [AC1, AC2, ...]
-```
-
-The `tenantMode` decision (from step-01) drives:
-- EF query filters
-- Seed data approach
-- API authorization
-
-See `smartstack-layers.md` for tenant mode seed data strategies.
-
----
-
-## Assign Skill/MCP per File
-
-For EACH file in the plan, specify HOW it will be created/modified.
-
-**Format:**
-
-```markdown
-| # | File | Action | Tool |
-|---|------|--------|------|
-| 1 | Domain/Entities/.../MyEntity.cs | create | MCP scaffold_extension |
-| 2 | Infrastructure/.../MyEntityConfiguration.cs | create | MCP scaffold_extension |
-| 3 | Migration | create | MCP suggest_migration + dotnet ef |
-```
-
----
-
-## Layer 0 — Domain + Infrastructure (sequential)
-
-| # | File | Action | Tool |
-|---|------|--------|------|
-| 1 | Domain/Entities/.../Entity.cs | create | MCP scaffold_extension |
-| 2 | Infrastructure/.../EntityConfiguration.cs | create | MCP scaffold_extension |
-| 3 | Infrastructure/Migrations/ | create | MCP suggest_migration + dotnet ef |
-
----
-
-## Layer 1 — Application + API + Seed Data (parallel)
-
-**Backend:** Application/API/Seed Data
-
-| # | File | Action | Tool |
-|---|------|--------|------|
-| 4 | Application/Services/.../Service.cs | create | MCP scaffold_extension |
-| 5 | Application/DTOs/.../Dto.cs | create | MCP scaffold_extension |
-| 6 | Api/Controllers/.../Controller.cs | create | /controller skill or MCP scaffold_extension |
-| 7 | Seeding/Data/NavigationApplicationSeedData.cs | create | Reference smartstack-layers.md (once per app) |
-| 7b | Seeding/Data/ApplicationRolesSeedData.cs | create | Reference smartstack-layers.md (once per app) |
-| 7c | Infrastructure/Services/CodeGeneration/ | create | Reference code-generation.md (per entity with codePattern != manual) |
-| 8 | Seeding/Data/.../NavigationModuleSeedData.cs | create | Reference core-seed-data.md (4 langs: fr, en, it, de) |
-| 8c | ↳ (same file) Section methods | add | Reference core-seed-data.md §2b (if sections exist) |
-| 8d | ↳ (same file) Resource methods | add | Reference core-seed-data.md §2b (if resources exist) |
-| 8b | Application/Authorization/Permissions.cs | create | MCP generate_permissions |
-| 9 | Seeding/Data/.../PermissionsSeedData.cs | create | MCP generate_permissions |
-| 10 | Seeding/Data/.../RolesSeedData.cs | create | Reference smartstack-layers.md |
-| 10b | Seeding/{App}SeedDataProvider.cs | create | Reference core-seed-data.md (IClientSeedDataProvider + DI) |
-
-**Frontend:** API Client, Routes, Pages, I18n
-
-| # | File | Action | Tool |
-|---|------|--------|------|
-| 11 | src/pages/{App}/{Mod}/ListPage.tsx | create | /ui-components skill |
-| 11b | src/pages/{App}/{Mod}/CreatePage.tsx | create | /ui-components skill (FK: EntityLookup) |
-| 11c | src/pages/{App}/{Mod}/EditPage.tsx | create | /ui-components skill (FK: EntityLookup) |
-| 11d | src/pages/{App}/{Mod}/{Section}Page.tsx | create | /ui-components skill (per section in `{sections}`) |
-| 11e | src/pages/{App}/{Mod}/{Section}DetailPage.tsx | create | /ui-components skill (per section) |
-| 12 | src/services/api/{module}Api.ts | create | MCP scaffold_api_client |
-| 13 | src/routes/{module}.tsx | create | MCP scaffold_routes |
-| 14 | src/i18n/locales/{lang}/{module}.json | create | Reference smartstack-frontend.md (4 languages) |
-
-**FK Field Guidance:** If step-01 identified `fkFields[]`, every Create/Edit page MUST use `EntityLookup` for those fields (see `smartstack-frontend.md` section 6). The corresponding backend GetAll endpoints (Layer 1) MUST support `?search=` parameter.
-
----
-
-## Layer 2b — Documentation (after frontend pages exist)
-
-| # | File | Action | Tool |
-|---|------|--------|------|
-| 14b | src/pages/docs/business/{app}/{module}/doc-data.ts | create | /documentation skill |
-| 14c | src/pages/docs/business/{app}/{module}/index.tsx | create | /documentation skill |
-
----
-
-## Layer 3 — Tests (sequential)
-
-| # | File | Action | Tool |
-|---|------|--------|------|
-| 15 | tests/.../EntityTests.cs | create | MCP scaffold_tests |
-| 16 | tests/.../ServiceTests.cs | create | MCP scaffold_tests |
-
----
-
-## Identify Parallelization (Agent Teams)
-
-If NOT economy_mode AND Layer 1 has both backend and frontend work:
-
-**Create agent teams to execute Layer 1 backend and frontend in parallel.**
-
-See `references/agent-teams-protocol.md` for team creation, teammate spawning, task coordination, and shutdown procedures.
-
----
-
-## Delegate Mode Fast Path
-
-When `/ralph-loop` invokes `/apex -d {prd_path}`, PRD tasks already define the scope:
-
-Map each PRD task to a layer based on `task.category`:
-- `domain` → Layer 0
-- `infrastructure` → Layer 0
-- `application` → Layer 1
-- `api` → Layer 1
-- `seedData` → Layer 1
-- `frontend` → Layer 2
-- `test` → Layer 3
-
-For each task: infer file_path, action, and tool from category. SKIP user checkpoint. Jump to "Estimated Commits" section.
+# Planning — Layer Mapping, Skill Assignment, Parallelization Strategy
+
+> **Loaded by:** step-02-plan.md (sections 1-4)
+> **Purpose:** Map analyzed elements to layers, assign skills/MCP tools, and identify parallelization opportunities.
+
+---
+
+## Map Changes to Layers
+
+For each element identified in step-01, assign to a SmartStack layer:
+
+| Layer | Category | Order |
+|-------|----------|-------|
+| 0 | Domain (entities, enums, exceptions) | Sequential |
+| 0 | Infrastructure - EF Configs | Sequential |
+| 0 | Infrastructure - Migration (BLOCKING) | Sequential |
+| 1 | Application (services, DTOs, validators) | Parallel |
+| 1 | API (controllers) | Parallel |
+| 1 | Infrastructure - Seed Data | Parallel |
+| 2 | Frontend (pages, components) | Parallel |
+| 2 | I18n (translations) | Parallel |
+| 3 | Tests | Sequential |
+
+---
+
+## Entity Definition Template
+
+Each entity in the plan MUST include:
+
+```yaml
+Entity: {EntityName}
+  - tenantMode: strict | optional | scoped | none
+  - codePattern: auto-generated strategy (if applicable)
+  - fkFields: [{field, targetEntity}] (if applicable)
+  - acceptance criteria: [AC1, AC2, ...]
+```
+
+The `tenantMode` decision (from step-01) drives:
+- EF query filters
+- Seed data approach
+- API authorization
+
+See `smartstack-layers.md` for tenant mode seed data strategies.
+
+---
+
+## Assign Skill/MCP per File
+
+For EACH file in the plan, specify HOW it will be created/modified.
+
+**Format:**
+
+```markdown
+| # | File | Action | Tool |
+|---|------|--------|------|
+| 1 | Domain/Entities/.../MyEntity.cs | create | MCP scaffold_extension |
+| 2 | Infrastructure/.../MyEntityConfiguration.cs | create | MCP scaffold_extension |
+| 3 | Migration | create | MCP suggest_migration + dotnet ef |
+```
+
+---
+
+## Layer 0 — Domain + Infrastructure (sequential)
+
+| # | File | Action | Tool |
+|---|------|--------|------|
+| 1 | Domain/Entities/.../Entity.cs | create | MCP scaffold_extension |
+| 2 | Infrastructure/.../EntityConfiguration.cs | create | MCP scaffold_extension |
+| 3 | Infrastructure/Migrations/ | create | MCP suggest_migration + dotnet ef |
+
+---
+
+## Layer 1 — Application + API + Seed Data (parallel)
+
+**Backend:** Application/API/Seed Data
+
+| # | File | Action | Tool |
+|---|------|--------|------|
+| 4 | Application/Services/.../Service.cs | create | MCP scaffold_extension |
+| 5 | Application/DTOs/.../Dto.cs | create | MCP scaffold_extension |
+| 6 | Api/Controllers/.../Controller.cs | create | /controller skill or MCP scaffold_extension |
+| 7 | Seeding/Data/NavigationApplicationSeedData.cs | create | Reference smartstack-layers.md (once per app) |
+| 7b | Seeding/Data/ApplicationRolesSeedData.cs | create | Reference smartstack-layers.md (once per app) |
+| 7c | Infrastructure/Services/CodeGeneration/ | create | Reference code-generation.md (per entity with codePattern != manual) |
+| 8 | Seeding/Data/.../NavigationModuleSeedData.cs | create | Reference core-seed-data.md (4 langs: fr, en, it, de) |
+| 8c | ↳ (same file) Section methods | add | Reference core-seed-data.md §2b (if sections exist) |
+| 8d | ↳ (same file) Resource methods | add | Reference core-seed-data.md §2b (if resources exist) |
+| 8b | Application/Authorization/Permissions.cs | create | MCP generate_permissions |
+| 9 | Seeding/Data/.../PermissionsSeedData.cs | create | MCP generate_permissions |
+| 10 | Seeding/Data/.../RolesSeedData.cs | create | Reference smartstack-layers.md |
+| 10b | Seeding/{App}SeedDataProvider.cs | create | Reference core-seed-data.md (IClientSeedDataProvider + DI) |
+
+**Frontend:** API Client, Routes, Pages, I18n
+
+| # | File | Action | Tool |
+|---|------|--------|------|
+| 11 | src/pages/{App}/{Mod}/ListPage.tsx | create | /ui-components skill |
+| 11b | src/pages/{App}/{Mod}/CreatePage.tsx | create | /ui-components skill (FK: EntityLookup) |
+| 11c | src/pages/{App}/{Mod}/EditPage.tsx | create | /ui-components skill (FK: EntityLookup) |
+| 11d | src/pages/{App}/{Mod}/{Section}Page.tsx | create | /ui-components skill (per section in `{sections}`) |
+| 11e | src/pages/{App}/{Mod}/{Section}DetailPage.tsx | create | /ui-components skill (per section) |
+| 12 | src/services/api/{module}Api.ts | create | MCP scaffold_api_client |
+| 13 | src/routes/{module}.tsx | create | MCP scaffold_routes |
+| 14 | src/i18n/locales/{lang}/{module}.json | create | Reference smartstack-frontend.md (4 languages) |
+
+**FK Field Guidance:** If step-01 identified `fkFields[]`, every Create/Edit page MUST use `EntityLookup` for those fields (see `smartstack-frontend.md` section 6). The corresponding backend GetAll endpoints (Layer 1) MUST support `?search=` parameter.
+
+---
+
+## Layer 2b — Documentation (after frontend pages exist)
+
+| # | File | Action | Tool |
+|---|------|--------|------|
+| 14b | src/pages/docs/business/{app}/{module}/doc-data.ts | create | /documentation skill |
+| 14c | src/pages/docs/business/{app}/{module}/index.tsx | create | /documentation skill |
+
+---
+
+## Layer 3 — Tests (sequential)
+
+| # | File | Action | Tool |
+|---|------|--------|------|
+| 15 | tests/.../EntityTests.cs | create | MCP scaffold_tests |
+| 16 | tests/.../ServiceTests.cs | create | MCP scaffold_tests |
+
+---
+
+## Identify Parallelization (Agent Teams)
+
+If NOT economy_mode AND Layer 1 has both backend and frontend work:
+
+**Create agent teams to execute Layer 1 backend and frontend in parallel.**
+
+See `references/agent-teams-protocol.md` for team creation, teammate spawning, task coordination, and shutdown procedures.
+
+---
+
+## Delegate Mode Fast Path
+
+When `/ralph-loop` invokes `/apex -d {prd_path}`, PRD tasks already define the scope:
+
+Map each PRD task to a layer based on `task.category`:
+- `domain` → Layer 0
+- `infrastructure` → Layer 0
+- `application` → Layer 1
+- `api` → Layer 1
+- `seedData` → Layer 1
+- `frontend` → Layer 2
+- `test` → Layer 3
+
+For each task: infer file_path, action, and tool from category. SKIP user checkpoint. Jump to "Estimated Commits" section.