@atlashub/smartstack-cli 2.7.1 → 2.7.3

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

@@ -222,7 +222,75 @@ If a feature is in mustHave → it MUST have at least one UC in the correspondin
 
 ### 10. Write Cadrage to Feature.json
 
-Use ba-writer to enrich master feature.json:
+Use ba-writer to enrich master feature.json. **Follow the STRUCTURE CARDS below exactly.**
+
+> **STRUCTURE CARD: cadrage.stakeholders[]**
+> ```json
+> {
+>   "role": "Fleet Manager",
+>   "function": "Manages daily fleet operations",
+>   "involvement": "decision-maker",
+>   "tasks": ["Monitor vehicles", "Approve repairs", "Export reports"],
+>   "frequency": "Daily",
+>   "painPoints": ["Manual tracking in spreadsheets", "No real-time visibility"]
+> }
+> ```
+> **MANDATORY fields:** `role`, `function`, `involvement`, `tasks`
+> **involvement values:** `approver`, `decision-maker`, `consulted`, `informed`, `end-user`
+> **FORBIDDEN fields:** Do NOT use `expertise`, `systemRole`, `description` (use `function` instead).
+
+> **STRUCTURE CARD: cadrage.applicationRoles[]**
+> ```json
+> {
+>   "role": "{App} Admin",
+>   "description": "Full access to all modules",
+>   "level": "admin",
+>   "permissionPattern": "business.{app}.*"
+> }
+> ```
+> **MANDATORY fields:** `role`, `level`, `permissionPattern`
+> **level values:** `admin`, `manager`, `contributor`, `viewer`
+> **FORBIDDEN fields:** Do NOT use `permissions` (use `permissionPattern`), `isDefault`.
+
+> **STRUCTURE CARD: cadrage.risks[]**
+> ```json
+> {
+>   "id": "RISK-001",
+>   "type": "business|technical|organizational",
+>   "description": "CSV data may contain duplicates and errors",
+>   "probability": "high|medium|low",
+>   "impact": "high|medium|low",
+>   "priority": "critical|medium|low",
+>   "mitigation": "Data cleaning phase before import, detailed error reports"
+> }
+> ```
+> **MANDATORY fields:** `id` (pattern: RISK-NNN), `type`, `description`, `mitigation`
+> **FORBIDDEN fields:** Do NOT use `risk` (name), `severity`. Use `id` + `description` + `priority`.
+
+> **STRUCTURE CARD: cadrage.acceptanceCriteria[]**
+> ```json
+> { "id": "AC-001", "criterion": "All must-have features delivered and tested", "validated": false }
+> ```
+> **MANDATORY:** This section must NOT be omitted.
+
+> **STRUCTURE CARD: cadrage.coverageMatrix[]**
+> ```json
+> {
+>   "item": "User management with CRUD",
+>   "category": "mustHave|shouldHave|couldHave|outOfScope|implicit",
+>   "module": "Users",
+>   "ucRef": "UC-UM-001",
+>   "notes": "Foundation module, must be implemented first"
+> }
+> ```
+> **MANDATORY fields:** `item`, `category`, `module`
+> **category values:** `mustHave`, `shouldHave`, `couldHave`, `outOfScope`, `implicit` (camelCase)
+> **FORBIDDEN fields:** Do NOT use `id`, `feature`, `priority`. Use `item` + `category`.
+
+> **STRUCTURE CARD: cadrage.codebaseContext** — Must be a string, NOT an object.
+> ```json
+> "codebaseContext": "Greenfield project, no existing entities. SmartStack 2.1.0 with Extensions DbContext."
+> ```
 
 ```
 ba-writer.enrichSection({
@@ -233,18 +301,18 @@ ba-writer.enrichSection({
     asIs: {Q1.2 answer},
     toBe: {Q1.3 answer},
     trigger: {Q1.4 answer},
-    stakeholders: [{mapped from Q2.x answers}],
+    stakeholders: [{mapped from Q2.x — use STRUCTURE CARD format}],
     globalScope: {
       mustHave: [{from Q3.x}],
       shouldHave: [{from Q3.x}],
       couldHave: [{from Q3.x}],
       outOfScope: [{from Q3.x}]
     },
-    applicationRoles: [{from section 6}],
-    risks: [{from section 8}],
-    acceptanceCriteria: [{derived from scope}],
-    coverageMatrix: [{from section 9}],
-    codebaseContext: {codebase_context}
+    applicationRoles: [{from section 6 — use STRUCTURE CARD format}],
+    risks: [{from section 8 — use STRUCTURE CARD format}],
+    acceptanceCriteria: [{derived from scope — use STRUCTURE CARD format}],
+    coverageMatrix: [{from section 9 — use STRUCTURE CARD format}],
+    codebaseContext: "{string summary of codebase findings}"
   }
 })
 

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

@@ -54,16 +54,27 @@ For each mustHave/shouldHave scope item:
 - "Does the codebase already have modules that should be extended vs. created new?"
 
 **For each module, determine:**
-```json
-{
-  "code": "PascalCase module name",
-  "description": "1-2 sentence description",
-  "featureType": "data-centric | integration | ui-centric | workflow | reporting | full-module",
-  "entities": ["Anticipated entity names"],
-  "priority": "must | should | could",
-  "estimatedComplexity": "simple | medium | complex"
-}
-```
+
+> **STRUCTURE CARD: modules[]** — Field names are EXACT. Include ALL fields below.
+> ```json
+> {
+>   "code": "PascalCase",
+>   "description": "1-2 sentence description",
+>   "featureType": "data-centric|integration|ui-centric|workflow|reporting|full-module",
+>   "dependencies": ["OtherModule"],
+>   "dependents": ["DependentModule"],
+>   "status": "pending",
+>   "featureJsonPath": null,
+>   "priority": "must|should|could",
+>   "sortOrder": 0,
+>   "entities": ["Anticipated entity names"],
+>   "estimatedComplexity": "simple|medium|complex"
+> }
+> ```
+> **MANDATORY fields:** `code`, `description`, `featureType`, `dependencies`, `dependents`, `status`, `priority`, `sortOrder`, `entities`, `estimatedComplexity`
+> **status:** Always `"pending"` at creation (updated to `"in-progress"` → `"specified"` → `"validated"` by step-03/04)
+> **sortOrder:** Integer from topological sort (0 = foundation layer)
+> **featureJsonPath:** Set to null at creation; updated to actual path when module feature.json is created in step-03
 
 **Complexity estimation rules:**
 | Criteria | Simple | Medium | Complex |