@atlashub/smartstack-cli 3.39.0 → 3.40.0

package/templates/skills/business-analyse/schemas/application-schema.json

@@ -1,453 +1,453 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "application-schema.json",
-  "title": "SmartStack Business Analysis - Application Level",
-  "description": "Master feature.json for multi-module application analysis. Published to docs/{app}/business-analyse/v{X.Y}/feature.json",
-  "type": "object",
-  "required": ["id", "version", "status", "scope", "metadata"],
-  "properties": {
-    "id": {
-      "type": "string",
-      "pattern": "^FEAT-\\d{3,}$",
-      "description": "Unique feature identifier (e.g., FEAT-001)"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+$",
-      "description": "Document version (e.g., 1.0, 1.1)"
-    },
-    "status": {
-      "type": "string",
-      "enum": ["draft", "framed", "decomposed", "specified", "consolidated", "handed-off"],
-      "description": "Application-level lifecycle status"
-    },
-    "scope": {
-      "type": "string",
-      "const": "application",
-      "description": "Marks this as an application-level feature.json"
-    },
-
-    "metadata": {
-      "type": "object",
-      "required": ["createdAt", "updatedAt", "application", "language", "featureDescription"],
-      "properties": {
-        "createdAt": { "type": "string", "format": "date-time" },
-        "updatedAt": { "type": "string", "format": "date-time" },
-        "application": { "type": "string", "description": "Application name (PascalCase)" },
-        "projectRef": { "type": ["string", "null"], "description": "Parent project ID (PROJ-XXX) when part of a multi-application project, null for standalone" },
-        "language": { "type": "string", "enum": ["fr", "en", "it", "de"] },
-        "featureDescription": { "type": "string" },
-        "workflowType": {
-          "type": "string",
-          "enum": ["new", "update"],
-          "description": "Whether this is a new application or an update"
-        },
-        "mcpAvailable": { "type": "boolean" },
-        "analysisMode": {
-          "type": "string",
-          "const": "interactive",
-          "description": "Analysis mode — always interactive (AI listens, reformulates, challenges, validates)"
-        },
-        "tablePrefix": {
-          "type": "string",
-          "pattern": "^[a-z]{2,5}_$",
-          "description": "Application table prefix for database tables (e.g., rh_, fi_, crm_). Defined during cadrage, used by all entities in this application."
-        },
-        "applicationCode": {
-          "type": "string",
-          "description": "PascalCase application code for navigation hierarchy (e.g., HumanResources). Confirmed in step-01b."
-        },
-        "applicationRoute": {
-          "type": "string",
-          "pattern": "^/[a-z-/]+$",
-          "description": "Kebab-case route path for navigation (e.g., /human-resources). Confirmed in step-01b."
-        },
-        "applicationIcon": {
-          "type": "string",
-          "description": "Lucide icon name for application navigation entry (e.g., users, shopping-cart). Confirmed in step-01b."
-        },
-        "workflow": {
-          "type": "object",
-          "description": "Iterative module loop state",
-          "properties": {
-            "mode": { "type": "string", "enum": ["application", "module"] },
-            "moduleOrder": {
-              "type": "array",
-              "items": { "type": "string" },
-              "description": "Topologically sorted module codes"
-            },
-            "currentModuleIndex": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Index into moduleOrder for current module being specified"
-            },
-            "completedModules": {
-              "type": "array",
-              "items": { "type": "string" },
-              "description": "Module codes that have been fully specified"
-            },
-            "currentModule": {
-              "type": ["string", "null"],
-              "description": "Code of the module currently being specified"
-            }
-          }
-        },
-        "steps": {
-          "type": "object",
-          "description": "Progress tracking per step",
-          "properties": {
-            "init": { "$ref": "#/$defs/stepStatus" },
-            "cadrage": { "$ref": "#/$defs/stepStatus" },
-            "decomposition": { "$ref": "#/$defs/stepStatus" },
-            "specify": { "$ref": "#/$defs/stepStatus" },
-            "consolidation": { "$ref": "#/$defs/stepStatus" },
-            "handoff": { "$ref": "#/$defs/stepStatus" }
-          }
-        }
-      }
-    },
-
-    "cadrage": {
-      "type": "object",
-      "description": "Enriched by step-01-cadrage: application-level framing",
-      "properties": {
-        "problem": { "type": "string", "description": "Business problem to solve" },
-        "asIs": { "type": "string", "description": "Current situation" },
-        "toBe": { "type": "string", "description": "Target situation" },
-        "trigger": { "type": "string", "description": "What triggered this need" },
-        "stakeholders": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["role"],
-            "properties": {
-              "role": { "type": "string" },
-              "function": { "type": "string" },
-              "involvement": { "type": "string", "enum": ["approver", "decision-maker", "consulted", "informed", "end-user"] },
-              "tasks": { "type": "array", "items": { "type": "string" } },
-              "frequency": { "type": "string" },
-              "painPoints": { "type": "array", "items": { "type": "string" } }
-            }
-          }
-        },
-        "globalScope": {
-          "type": "object",
-          "properties": {
-            "mustHave": { "type": "array", "items": { "type": "string" } },
-            "shouldHave": { "type": "array", "items": { "type": "string" } },
-            "couldHave": { "type": "array", "items": { "type": "string" } },
-            "outOfScope": { "type": "array", "items": { "type": "string" } }
-          }
-        },
-        "applicationRoles": {
-          "type": "array",
-          "description": "Application-level roles (defined once, inherited by all modules)",
-          "items": {
-            "type": "object",
-            "required": ["role", "level"],
-            "properties": {
-              "role": { "type": "string", "description": "Role name (e.g., Sales Admin)" },
-              "description": { "type": "string" },
-              "level": { "type": "string", "enum": ["admin", "manager", "contributor", "viewer"], "description": "Permission hierarchy level" },
-              "permissionPattern": { "type": "string", "description": "Permission pattern (e.g., sales.* for admin)" }
-            }
-          }
-        },
-        "risks": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["id", "type", "description"],
-            "properties": {
-              "id": { "type": "string", "pattern": "^RISK-\\d{3}$" },
-              "type": { "type": "string", "enum": ["business", "technical", "organizational"] },
-              "description": { "type": "string" },
-              "probability": { "type": "string", "enum": ["high", "medium", "low"] },
-              "impact": { "type": "string", "enum": ["high", "medium", "low"] },
-              "priority": { "type": "string", "enum": ["critical", "medium", "low"] },
-              "mitigation": { "type": "string" }
-            }
-          }
-        },
-        "acceptanceCriteria": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["id", "criterion"],
-            "properties": {
-              "id": { "type": "string", "pattern": "^AC-\\d{3}$" },
-              "criterion": { "type": "string" },
-              "validated": { "type": "boolean", "default": false }
-            }
-          }
-        },
-        "codebaseContext": {
-          "type": "string",
-          "description": "Summary of existing modules/patterns found during pre-research"
-        },
-        "coverageMatrix": {
-          "type": "array",
-          "description": "Maps every requirement from the original brief/prompt to a scope category. Ensures nothing is lost silently.",
-          "items": {
-            "type": "object",
-            "required": ["item", "category", "module"],
-            "properties": {
-              "item": { "type": "string", "description": "Requirement from the original brief" },
-              "category": { "type": "string", "enum": ["mustHave", "shouldHave", "couldHave", "outOfScope", "implicit"] },
-              "module": { "type": ["string", "null"], "description": "Module code that covers this requirement (null if cross-cutting)" },
-              "ucRef": { "type": ["string", "null"], "description": "UC ID if already assigned" },
-              "notes": { "type": "string" },
-              "anticipatedSections": {
-                "type": "array",
-                "items": { "type": "string" },
-                "description": "Anticipated sections (Level 4) for this requirement — e.g., list, detail, create, edit, dashboard"
-              },
-              "anticipatedResources": {
-                "type": "array",
-                "items": { "type": "string" },
-                "description": "Anticipated resources (Level 5) for this requirement — e.g., user-grid, user-form, user-card"
-              }
-            }
-          }
-        }
-      }
-    },
-
-    "modules": {
-      "type": "array",
-      "description": "Enriched by step-02-decomposition: module registry with dependencies",
-      "items": {
-        "type": "object",
-        "required": ["code", "description"],
-        "properties": {
-          "code": { "type": "string", "description": "Module code (PascalCase, e.g., Customers)" },
-          "description": { "type": "string" },
-          "featureType": {
-            "type": "string",
-            "enum": ["data-centric", "integration", "ui-centric", "workflow", "reporting", "full-module"],
-            "description": "Estimated module type"
-          },
-          "dependencies": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Module codes this module depends on (FK, events)"
-          },
-          "dependents": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Module codes that depend on this module"
-          },
-          "status": {
-            "type": "string",
-            "enum": ["pending", "in-progress", "specified", "validated"],
-            "description": "Module specification status within the iterative loop"
-          },
-          "featureJsonPath": {
-            "type": ["string", "null"],
-            "description": "Path to the module-level feature.json once created"
-          },
-          "priority": {
-            "type": "string",
-            "enum": ["must", "should", "could"],
-            "description": "Priority level from global scope"
-          },
-          "sortOrder": {
-            "type": "integer",
-            "description": "Position in topological order (0-based)"
-          },
-          "entities": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Anticipated entity names (from decomposition, refined in specification)"
-          },
-          "estimatedComplexity": {
-            "type": "string",
-            "enum": ["simple", "medium", "complex"]
-          },
-          "anticipatedSections": {
-            "type": "array",
-            "description": "Anticipated sections (Level 4) with their resources (Level 5), from cadrage coverage matrix",
-            "items": {
-              "type": "object",
-              "required": ["code"],
-              "properties": {
-                "code": { "type": "string", "description": "Section code (e.g., list, detail, create, edit, dashboard)" },
-                "description": { "type": "string" },
-                "resources": {
-                  "type": "array",
-                  "items": { "type": "string" },
-                  "description": "Anticipated resource codes for this section"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-
-    "dependencyGraph": {
-      "type": "object",
-      "description": "Enriched by step-02-decomposition: module dependency graph",
-      "properties": {
-        "edges": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["from", "to", "type"],
-            "properties": {
-              "from": { "type": "string", "description": "Dependent module code" },
-              "to": { "type": "string", "description": "Dependency module code" },
-              "type": { "type": "string", "enum": ["FK", "event", "shared-entity", "lookup"], "description": "Nature of the dependency" }
-            }
-          }
-        },
-        "topologicalOrder": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Modules sorted by dependency (foundations first)"
-        },
-        "layers": {
-          "type": "array",
-          "description": "Modules grouped by dependency depth",
-          "items": {
-            "type": "object",
-            "properties": {
-              "layer": { "type": "integer" },
-              "modules": { "type": "array", "items": { "type": "string" } }
-            }
-          }
-        }
-      }
-    },
-
-    "consolidation": {
-      "type": "object",
-      "description": "Enriched by step-04-consolidation: cross-module validation",
-      "properties": {
-        "crossModuleInteractions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "fromModule": { "type": "string" },
-              "toModule": { "type": "string" },
-              "interactionType": { "type": "string", "enum": ["FK-reference", "event-publish", "event-subscribe", "shared-lookup", "cascade-delete", "cascade-update"] },
-              "description": { "type": "string" },
-              "entities": { "type": "array", "items": { "type": "string" } }
-            }
-          }
-        },
-        "sharedEntities": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "entity": { "type": "string" },
-              "ownerModule": { "type": "string" },
-              "referencedBy": { "type": "array", "items": { "type": "string" } },
-              "sharedFields": { "type": "array", "items": { "type": "string" } }
-            }
-          }
-        },
-        "permissionCoherence": {
-          "type": "object",
-          "properties": {
-            "rolesConsistent": { "type": "boolean" },
-            "pathFormatConsistent": { "type": "boolean" },
-            "hierarchyRespected": { "type": "boolean" },
-            "conflicts": { "type": "array", "items": { "type": "string" } },
-            "warnings": { "type": "array", "items": { "type": "string" } }
-          }
-        },
-        "e2eFlows": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "name": { "type": "string", "description": "Flow name (e.g., Create Order to Invoice)" },
-              "modules": { "type": "array", "items": { "type": "string" } },
-              "steps": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "module": { "type": "string" },
-                    "action": { "type": "string" },
-                    "permission": { "type": "string" },
-                    "dataFlow": { "type": "string" }
-                  }
-                }
-              }
-            }
-          }
-        },
-        "globalRiskAssessment": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "risk": { "type": "string" },
-              "category": { "type": "string", "enum": ["coupling", "complexity", "dependency-chain", "security", "scope"] },
-              "severity": { "type": "string", "enum": ["critical", "high", "medium", "low"] },
-              "mitigation": { "type": "string" }
-            }
-          }
-        },
-        "decision": {
-          "type": "object",
-          "properties": {
-            "approved": { "type": "boolean" },
-            "reason": { "type": "string" },
-            "approvedBy": { "type": "string" },
-            "approvedAt": { "type": "string", "format": "date-time" }
-          }
-        }
-      }
-    },
-
-    "suggestions": {
-      "type": "array",
-      "description": "Proactive AI suggestions for complementary modules/sections",
-      "items": {
-        "type": "object",
-        "required": ["type", "code", "reason"],
-        "properties": {
-          "type": { "type": "string", "enum": ["module", "section", "integration", "enhancement"] },
-          "code": { "type": "string" },
-          "title": { "type": "string" },
-          "reason": { "type": "string" },
-          "accepted": { "type": ["boolean", "null"] }
-        }
-      }
-    },
-
-    "changelog": {
-      "type": "array",
-      "description": "Version history and change tracking",
-      "items": {
-        "type": "object",
-        "required": ["timestamp", "changes"],
-        "properties": {
-          "step": { "type": "string" },
-          "version": { "type": "string" },
-          "timestamp": { "type": "string", "format": "date-time" },
-          "author": { "type": "string" },
-          "changes": { "type": "array", "items": { "type": "string" } },
-          "warnings": { "type": "array", "items": { "type": "string" } },
-          "decision": { "type": "string" }
-        }
-      }
-    }
-  },
-
-  "$defs": {
-    "stepStatus": {
-      "type": "object",
-      "properties": {
-        "status": { "type": "string", "enum": ["pending", "in-progress", "completed", "skipped"] },
-        "startedAt": { "type": ["string", "null"], "format": "date-time" },
-        "completedAt": { "type": ["string", "null"], "format": "date-time" }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "application-schema.json",
+  "title": "SmartStack Business Analysis - Application Level",
+  "description": "Master feature.json for multi-module application analysis. Published to docs/{app}/business-analyse/v{X.Y}/feature.json",
+  "type": "object",
+  "required": ["id", "version", "status", "scope", "metadata"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{3,}$",
+      "description": "Unique feature identifier (e.g., FEAT-001)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+$",
+      "description": "Document version (e.g., 1.0, 1.1)"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "framed", "decomposed", "specified", "consolidated", "handed-off"],
+      "description": "Application-level lifecycle status"
+    },
+    "scope": {
+      "type": "string",
+      "const": "application",
+      "description": "Marks this as an application-level feature.json"
+    },
+
+    "metadata": {
+      "type": "object",
+      "required": ["createdAt", "updatedAt", "application", "language", "featureDescription"],
+      "properties": {
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" },
+        "application": { "type": "string", "description": "Application name (PascalCase)" },
+        "projectRef": { "type": ["string", "null"], "description": "Parent project ID (PROJ-XXX) when part of a multi-application project, null for standalone" },
+        "language": { "type": "string", "enum": ["fr", "en", "it", "de"] },
+        "featureDescription": { "type": "string" },
+        "workflowType": {
+          "type": "string",
+          "enum": ["new", "update"],
+          "description": "Whether this is a new application or an update"
+        },
+        "mcpAvailable": { "type": "boolean" },
+        "analysisMode": {
+          "type": "string",
+          "const": "interactive",
+          "description": "Analysis mode — always interactive (AI listens, reformulates, challenges, validates)"
+        },
+        "tablePrefix": {
+          "type": "string",
+          "pattern": "^[a-z]{2,5}_$",
+          "description": "Application table prefix for database tables (e.g., rh_, fi_, crm_). Defined during cadrage, used by all entities in this application."
+        },
+        "applicationCode": {
+          "type": "string",
+          "description": "PascalCase application code for navigation hierarchy (e.g., HumanResources). Confirmed in step-01b."
+        },
+        "applicationRoute": {
+          "type": "string",
+          "pattern": "^/[a-z-/]+$",
+          "description": "Kebab-case route path for navigation (e.g., /human-resources). Confirmed in step-01b."
+        },
+        "applicationIcon": {
+          "type": "string",
+          "description": "Lucide icon name for application navigation entry (e.g., users, shopping-cart). Confirmed in step-01b."
+        },
+        "workflow": {
+          "type": "object",
+          "description": "Iterative module loop state",
+          "properties": {
+            "mode": { "type": "string", "enum": ["application", "module"] },
+            "moduleOrder": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Topologically sorted module codes"
+            },
+            "currentModuleIndex": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Index into moduleOrder for current module being specified"
+            },
+            "completedModules": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Module codes that have been fully specified"
+            },
+            "currentModule": {
+              "type": ["string", "null"],
+              "description": "Code of the module currently being specified"
+            }
+          }
+        },
+        "steps": {
+          "type": "object",
+          "description": "Progress tracking per step",
+          "properties": {
+            "init": { "$ref": "#/$defs/stepStatus" },
+            "cadrage": { "$ref": "#/$defs/stepStatus" },
+            "decomposition": { "$ref": "#/$defs/stepStatus" },
+            "specify": { "$ref": "#/$defs/stepStatus" },
+            "consolidation": { "$ref": "#/$defs/stepStatus" },
+            "handoff": { "$ref": "#/$defs/stepStatus" }
+          }
+        }
+      }
+    },
+
+    "cadrage": {
+      "type": "object",
+      "description": "Enriched by step-01-cadrage: application-level framing",
+      "properties": {
+        "problem": { "type": "string", "description": "Business problem to solve" },
+        "asIs": { "type": "string", "description": "Current situation" },
+        "toBe": { "type": "string", "description": "Target situation" },
+        "trigger": { "type": "string", "description": "What triggered this need" },
+        "stakeholders": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["role"],
+            "properties": {
+              "role": { "type": "string" },
+              "function": { "type": "string" },
+              "involvement": { "type": "string", "enum": ["approver", "decision-maker", "consulted", "informed", "end-user"] },
+              "tasks": { "type": "array", "items": { "type": "string" } },
+              "frequency": { "type": "string" },
+              "painPoints": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "globalScope": {
+          "type": "object",
+          "properties": {
+            "mustHave": { "type": "array", "items": { "type": "string" } },
+            "shouldHave": { "type": "array", "items": { "type": "string" } },
+            "couldHave": { "type": "array", "items": { "type": "string" } },
+            "outOfScope": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "applicationRoles": {
+          "type": "array",
+          "description": "Application-level roles (defined once, inherited by all modules)",
+          "items": {
+            "type": "object",
+            "required": ["role", "level"],
+            "properties": {
+              "role": { "type": "string", "description": "Role name (e.g., Sales Admin)" },
+              "description": { "type": "string" },
+              "level": { "type": "string", "enum": ["admin", "manager", "contributor", "viewer"], "description": "Permission hierarchy level" },
+              "permissionPattern": { "type": "string", "description": "Permission pattern (e.g., sales.* for admin)" }
+            }
+          }
+        },
+        "risks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "type", "description"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^RISK-\\d{3}$" },
+              "type": { "type": "string", "enum": ["business", "technical", "organizational"] },
+              "description": { "type": "string" },
+              "probability": { "type": "string", "enum": ["high", "medium", "low"] },
+              "impact": { "type": "string", "enum": ["high", "medium", "low"] },
+              "priority": { "type": "string", "enum": ["critical", "medium", "low"] },
+              "mitigation": { "type": "string" }
+            }
+          }
+        },
+        "acceptanceCriteria": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "criterion"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^AC-\\d{3}$" },
+              "criterion": { "type": "string" },
+              "validated": { "type": "boolean", "default": false }
+            }
+          }
+        },
+        "codebaseContext": {
+          "type": "string",
+          "description": "Summary of existing modules/patterns found during pre-research"
+        },
+        "coverageMatrix": {
+          "type": "array",
+          "description": "Maps every requirement from the original brief/prompt to a scope category. Ensures nothing is lost silently.",
+          "items": {
+            "type": "object",
+            "required": ["item", "category", "module"],
+            "properties": {
+              "item": { "type": "string", "description": "Requirement from the original brief" },
+              "category": { "type": "string", "enum": ["mustHave", "shouldHave", "couldHave", "outOfScope", "implicit"] },
+              "module": { "type": ["string", "null"], "description": "Module code that covers this requirement (null if cross-cutting)" },
+              "ucRef": { "type": ["string", "null"], "description": "UC ID if already assigned" },
+              "notes": { "type": "string" },
+              "anticipatedSections": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Anticipated sections (Level 4) for this requirement — e.g., list, detail, create, edit, dashboard"
+              },
+              "anticipatedResources": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Anticipated resources (Level 5) for this requirement — e.g., user-grid, user-form, user-card"
+              }
+            }
+          }
+        }
+      }
+    },
+
+    "modules": {
+      "type": "array",
+      "description": "Enriched by step-02-decomposition: module registry with dependencies",
+      "items": {
+        "type": "object",
+        "required": ["code", "description"],
+        "properties": {
+          "code": { "type": "string", "description": "Module code (PascalCase, e.g., Customers)" },
+          "description": { "type": "string" },
+          "featureType": {
+            "type": "string",
+            "enum": ["data-centric", "integration", "ui-centric", "workflow", "reporting", "full-module"],
+            "description": "Estimated module type"
+          },
+          "dependencies": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Module codes this module depends on (FK, events)"
+          },
+          "dependents": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Module codes that depend on this module"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["pending", "in-progress", "specified", "validated"],
+            "description": "Module specification status within the iterative loop"
+          },
+          "featureJsonPath": {
+            "type": ["string", "null"],
+            "description": "Path to the module-level feature.json once created"
+          },
+          "priority": {
+            "type": "string",
+            "enum": ["must", "should", "could"],
+            "description": "Priority level from global scope"
+          },
+          "sortOrder": {
+            "type": "integer",
+            "description": "Position in topological order (0-based)"
+          },
+          "entities": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Anticipated entity names (from decomposition, refined in specification)"
+          },
+          "estimatedComplexity": {
+            "type": "string",
+            "enum": ["simple", "medium", "complex"]
+          },
+          "anticipatedSections": {
+            "type": "array",
+            "description": "Anticipated sections (Level 4) with their resources (Level 5), from cadrage coverage matrix",
+            "items": {
+              "type": "object",
+              "required": ["code"],
+              "properties": {
+                "code": { "type": "string", "description": "Section code (e.g., list, detail, create, edit, dashboard)" },
+                "description": { "type": "string" },
+                "resources": {
+                  "type": "array",
+                  "items": { "type": "string" },
+                  "description": "Anticipated resource codes for this section"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+
+    "dependencyGraph": {
+      "type": "object",
+      "description": "Enriched by step-02-decomposition: module dependency graph",
+      "properties": {
+        "edges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["from", "to", "type"],
+            "properties": {
+              "from": { "type": "string", "description": "Dependent module code" },
+              "to": { "type": "string", "description": "Dependency module code" },
+              "type": { "type": "string", "enum": ["FK", "event", "shared-entity", "lookup"], "description": "Nature of the dependency" }
+            }
+          }
+        },
+        "topologicalOrder": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Modules sorted by dependency (foundations first)"
+        },
+        "layers": {
+          "type": "array",
+          "description": "Modules grouped by dependency depth",
+          "items": {
+            "type": "object",
+            "properties": {
+              "layer": { "type": "integer" },
+              "modules": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    },
+
+    "consolidation": {
+      "type": "object",
+      "description": "Enriched by step-04-consolidation: cross-module validation",
+      "properties": {
+        "crossModuleInteractions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "fromModule": { "type": "string" },
+              "toModule": { "type": "string" },
+              "interactionType": { "type": "string", "enum": ["FK-reference", "event-publish", "event-subscribe", "shared-lookup", "cascade-delete", "cascade-update"] },
+              "description": { "type": "string" },
+              "entities": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "sharedEntities": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "entity": { "type": "string" },
+              "ownerModule": { "type": "string" },
+              "referencedBy": { "type": "array", "items": { "type": "string" } },
+              "sharedFields": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "permissionCoherence": {
+          "type": "object",
+          "properties": {
+            "rolesConsistent": { "type": "boolean" },
+            "pathFormatConsistent": { "type": "boolean" },
+            "hierarchyRespected": { "type": "boolean" },
+            "conflicts": { "type": "array", "items": { "type": "string" } },
+            "warnings": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "e2eFlows": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string", "description": "Flow name (e.g., Create Order to Invoice)" },
+              "modules": { "type": "array", "items": { "type": "string" } },
+              "steps": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "module": { "type": "string" },
+                    "action": { "type": "string" },
+                    "permission": { "type": "string" },
+                    "dataFlow": { "type": "string" }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "globalRiskAssessment": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "risk": { "type": "string" },
+              "category": { "type": "string", "enum": ["coupling", "complexity", "dependency-chain", "security", "scope"] },
+              "severity": { "type": "string", "enum": ["critical", "high", "medium", "low"] },
+              "mitigation": { "type": "string" }
+            }
+          }
+        },
+        "decision": {
+          "type": "object",
+          "properties": {
+            "approved": { "type": "boolean" },
+            "reason": { "type": "string" },
+            "approvedBy": { "type": "string" },
+            "approvedAt": { "type": "string", "format": "date-time" }
+          }
+        }
+      }
+    },
+
+    "suggestions": {
+      "type": "array",
+      "description": "Proactive AI suggestions for complementary modules/sections",
+      "items": {
+        "type": "object",
+        "required": ["type", "code", "reason"],
+        "properties": {
+          "type": { "type": "string", "enum": ["module", "section", "integration", "enhancement"] },
+          "code": { "type": "string" },
+          "title": { "type": "string" },
+          "reason": { "type": "string" },
+          "accepted": { "type": ["boolean", "null"] }
+        }
+      }
+    },
+
+    "changelog": {
+      "type": "array",
+      "description": "Version history and change tracking",
+      "items": {
+        "type": "object",
+        "required": ["timestamp", "changes"],
+        "properties": {
+          "step": { "type": "string" },
+          "version": { "type": "string" },
+          "timestamp": { "type": "string", "format": "date-time" },
+          "author": { "type": "string" },
+          "changes": { "type": "array", "items": { "type": "string" } },
+          "warnings": { "type": "array", "items": { "type": "string" } },
+          "decision": { "type": "string" }
+        }
+      }
+    }
+  },
+
+  "$defs": {
+    "stepStatus": {
+      "type": "object",
+      "properties": {
+        "status": { "type": "string", "enum": ["pending", "in-progress", "completed", "skipped"] },
+        "startedAt": { "type": ["string", "null"], "format": "date-time" },
+        "completedAt": { "type": ["string", "null"], "format": "date-time" }
+      }
+    }
+  }
+}