@atlashub/smartstack-cli 3.39.0 → 3.41.0

package/templates/skills/business-analyse/schemas/sections/analysis-schema.json

@@ -1,201 +1,201 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "analysis-schema.json",
-  "title": "SmartStack BA - Analysis",
-  "description": "Module-level analysis: objectives, business rules, entities, process flows, integrations, data lifecycle. Enriched by step-03a-data.",
-  "type": "object",
-  "properties": {
-    "objectives": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "objective"],
-        "properties": {
-          "id": { "type": "string", "pattern": "^OBJ-\\d{3}$" },
-          "objective": { "type": "string" },
-          "metric": { "type": "string" },
-          "target": { "type": "string" }
-        }
-      }
-    },
-    "businessRules": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "name", "category", "statement"],
-        "properties": {
-          "id": { "type": "string", "pattern": "^BR-(VAL|CALC|WF|SEC|DATA)-[A-Z]{2,4}-\\d{3}$", "description": "Module-prefixed BR ID (e.g., BR-VAL-RM-001)" },
-          "name": { "type": "string" },
-          "category": { "type": "string", "enum": ["validation", "calculation", "workflow", "security", "data"] },
-          "statement": { "type": "string", "description": "IF ... THEN ... ELSE ..." },
-          "priority": { "type": "string", "enum": ["must", "should", "could"] },
-          "conditions": { "type": "array", "items": { "type": "string" } },
-          "examples": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "input": { "type": "string" },
-                "expected": { "type": "string" }
-              }
-            }
-          },
-          "testability": { "type": "string" }
-        }
-      }
-    },
-    "entities": {
-      "type": "array",
-      "description": "Business-view entities only. NO technical fields (Id, TenantId, CreatedBy, etc.)",
-      "items": {
-        "type": "object",
-        "required": ["name"],
-        "properties": {
-          "name": { "type": "string", "description": "PascalCase entity name" },
-          "description": { "type": "string" },
-          "attributes": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "required": ["name"],
-              "properties": {
-                "name": { "type": "string" },
-                "description": { "type": "string" },
-                "required": { "type": "boolean", "default": false },
-                "unique": { "type": "boolean", "default": false },
-                "validation": { "type": "string" }
-              }
-            }
-          },
-          "relationships": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "required": ["target", "type"],
-              "properties": {
-                "target": { "type": "string" },
-                "type": { "type": "string", "enum": ["1:1", "1:N", "N:1", "N:M"] },
-                "description": { "type": "string" }
-              }
-            }
-          },
-          "codePattern": {
-            "type": "object",
-            "description": "Code auto-generation strategy for this entity. Defines how entity codes are automatically generated (e.g., acme-emp-00001).",
-            "properties": {
-              "strategy": {
-                "type": "string",
-                "enum": ["sequential", "timestamp-daily", "timestamp-minute", "year-sequential", "uuid-short", "manual"],
-                "default": "sequential",
-                "description": "Code generation strategy. sequential: {tenant}-{prefix}-{N}. timestamp-daily: {tenant}-{prefix}-{YYYYMMDD}-{N}. timestamp-minute: {tenant}-{prefix}-{YYYYMMDDHHmm}-{N}. year-sequential: {tenant}-{prefix}-{YYYY}-{N}. uuid-short: {tenant}-{prefix}-{8hex}. manual: user-provided."
-              },
-              "prefix": {
-                "type": "string",
-                "pattern": "^[a-z]{2,6}$",
-                "description": "Entity prefix in the code (e.g., emp for Employee, inv for Invoice)"
-              },
-              "includeTenantSlug": {
-                "type": "boolean",
-                "default": true,
-                "description": "Whether to include the tenant slug as prefix (e.g., acme-emp-00001 vs emp-00001)"
-              },
-              "separator": {
-                "type": "string",
-                "enum": ["-", "_"],
-                "default": "-",
-                "description": "Separator between code segments"
-              },
-              "estimatedVolume": {
-                "type": "integer",
-                "minimum": 10,
-                "maximum": 10000000,
-                "description": "Estimated number of records per tenant. Used to calculate digit count via x10 rule: digits = max(4, ceil(log10(volume * 10)))"
-              },
-              "digits": {
-                "type": "integer",
-                "minimum": 4,
-                "maximum": 7,
-                "description": "Number of digits for sequential part. Auto-calculated from estimatedVolume if omitted."
-              },
-              "example": {
-                "type": "string",
-                "description": "Example generated code for documentation (e.g., acme-emp-00001)"
-              }
-            }
-          }
-        }
-      }
-    },
-    "processFlow": {
-      "type": "object",
-      "properties": {
-        "entryPoints": { "type": "array", "items": { "type": "string" } },
-        "mainFlow": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "step": { "type": "integer" },
-              "actor": { "type": "string" },
-              "action": { "type": "string" },
-              "system": { "type": "string" }
-            }
-          }
-        },
-        "decisionPoints": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "condition": { "type": "string" },
-              "ifTrue": { "type": "string" },
-              "ifFalse": { "type": "string" },
-              "rule": { "type": "string", "description": "Reference to BR-XXX" }
-            }
-          }
-        },
-        "alternativeFlows": { "type": "array", "items": { "type": "object" } }
-      }
-    },
-    "integrations": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "system": { "type": "string" },
-          "direction": { "type": "string", "enum": ["in", "out", "bidirectional"] },
-          "data": { "type": "string" },
-          "frequency": { "type": "string" },
-          "errorStrategy": { "type": "string" }
-        }
-      }
-    },
-    "dataLifecycle": {
-      "type": "object",
-      "properties": {
-        "retentionPeriod": { "type": "string" },
-        "archiveStrategy": { "type": "string" },
-        "gdprCompliance": { "type": "string" },
-        "states": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "name": { "type": "string" },
-              "transitions": { "type": "array", "items": { "type": "string" } }
-            }
-          }
-        }
-      }
-    },
-    "crossModuleImpact": {
-      "type": "object",
-      "properties": {
-        "existingModules": { "type": "array", "items": { "type": "string" } },
-        "sharedData": { "type": "array", "items": { "type": "string" } },
-        "events": { "type": "array", "items": { "type": "string" } },
-        "modifications": { "type": "array", "items": { "type": "string" } }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "analysis-schema.json",
+  "title": "SmartStack BA - Analysis",
+  "description": "Module-level analysis: objectives, business rules, entities, process flows, integrations, data lifecycle. Enriched by step-03a-data.",
+  "type": "object",
+  "properties": {
+    "objectives": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "objective"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^OBJ-\\d{3}$" },
+          "objective": { "type": "string" },
+          "metric": { "type": "string" },
+          "target": { "type": "string" }
+        }
+      }
+    },
+    "businessRules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "name", "category", "statement"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^BR-(VAL|CALC|WF|SEC|DATA)-[A-Z]{2,4}-\\d{3}$", "description": "Module-prefixed BR ID (e.g., BR-VAL-RM-001)" },
+          "name": { "type": "string" },
+          "category": { "type": "string", "enum": ["validation", "calculation", "workflow", "security", "data"] },
+          "statement": { "type": "string", "description": "IF ... THEN ... ELSE ..." },
+          "priority": { "type": "string", "enum": ["must", "should", "could"] },
+          "conditions": { "type": "array", "items": { "type": "string" } },
+          "examples": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "input": { "type": "string" },
+                "expected": { "type": "string" }
+              }
+            }
+          },
+          "testability": { "type": "string" }
+        }
+      }
+    },
+    "entities": {
+      "type": "array",
+      "description": "Business-view entities only. NO technical fields (Id, TenantId, CreatedBy, etc.)",
+      "items": {
+        "type": "object",
+        "required": ["name"],
+        "properties": {
+          "name": { "type": "string", "description": "PascalCase entity name" },
+          "description": { "type": "string" },
+          "attributes": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["name"],
+              "properties": {
+                "name": { "type": "string" },
+                "description": { "type": "string" },
+                "required": { "type": "boolean", "default": false },
+                "unique": { "type": "boolean", "default": false },
+                "validation": { "type": "string" }
+              }
+            }
+          },
+          "relationships": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["target", "type"],
+              "properties": {
+                "target": { "type": "string" },
+                "type": { "type": "string", "enum": ["1:1", "1:N", "N:1", "N:M"] },
+                "description": { "type": "string" }
+              }
+            }
+          },
+          "codePattern": {
+            "type": "object",
+            "description": "Code auto-generation strategy for this entity. Defines how entity codes are automatically generated (e.g., acme-emp-00001).",
+            "properties": {
+              "strategy": {
+                "type": "string",
+                "enum": ["sequential", "timestamp-daily", "timestamp-minute", "year-sequential", "uuid-short", "manual"],
+                "default": "sequential",
+                "description": "Code generation strategy. sequential: {tenant}-{prefix}-{N}. timestamp-daily: {tenant}-{prefix}-{YYYYMMDD}-{N}. timestamp-minute: {tenant}-{prefix}-{YYYYMMDDHHmm}-{N}. year-sequential: {tenant}-{prefix}-{YYYY}-{N}. uuid-short: {tenant}-{prefix}-{8hex}. manual: user-provided."
+              },
+              "prefix": {
+                "type": "string",
+                "pattern": "^[a-z]{2,6}$",
+                "description": "Entity prefix in the code (e.g., emp for Employee, inv for Invoice)"
+              },
+              "includeTenantSlug": {
+                "type": "boolean",
+                "default": true,
+                "description": "Whether to include the tenant slug as prefix (e.g., acme-emp-00001 vs emp-00001)"
+              },
+              "separator": {
+                "type": "string",
+                "enum": ["-", "_"],
+                "default": "-",
+                "description": "Separator between code segments"
+              },
+              "estimatedVolume": {
+                "type": "integer",
+                "minimum": 10,
+                "maximum": 10000000,
+                "description": "Estimated number of records per tenant. Used to calculate digit count via x10 rule: digits = max(4, ceil(log10(volume * 10)))"
+              },
+              "digits": {
+                "type": "integer",
+                "minimum": 4,
+                "maximum": 7,
+                "description": "Number of digits for sequential part. Auto-calculated from estimatedVolume if omitted."
+              },
+              "example": {
+                "type": "string",
+                "description": "Example generated code for documentation (e.g., acme-emp-00001)"
+              }
+            }
+          }
+        }
+      }
+    },
+    "processFlow": {
+      "type": "object",
+      "properties": {
+        "entryPoints": { "type": "array", "items": { "type": "string" } },
+        "mainFlow": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "step": { "type": "integer" },
+              "actor": { "type": "string" },
+              "action": { "type": "string" },
+              "system": { "type": "string" }
+            }
+          }
+        },
+        "decisionPoints": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "condition": { "type": "string" },
+              "ifTrue": { "type": "string" },
+              "ifFalse": { "type": "string" },
+              "rule": { "type": "string", "description": "Reference to BR-XXX" }
+            }
+          }
+        },
+        "alternativeFlows": { "type": "array", "items": { "type": "object" } }
+      }
+    },
+    "integrations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "system": { "type": "string" },
+          "direction": { "type": "string", "enum": ["in", "out", "bidirectional"] },
+          "data": { "type": "string" },
+          "frequency": { "type": "string" },
+          "errorStrategy": { "type": "string" }
+        }
+      }
+    },
+    "dataLifecycle": {
+      "type": "object",
+      "properties": {
+        "retentionPeriod": { "type": "string" },
+        "archiveStrategy": { "type": "string" },
+        "gdprCompliance": { "type": "string" },
+        "states": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "transitions": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    },
+    "crossModuleImpact": {
+      "type": "object",
+      "properties": {
+        "existingModules": { "type": "array", "items": { "type": "string" } },
+        "sharedData": { "type": "array", "items": { "type": "string" } },
+        "events": { "type": "array", "items": { "type": "string" } },
+        "modifications": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/templates/skills/business-analyse/schemas/sections/discovery-schema.json

@@ -1,82 +1,82 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "discovery-schema.json",
-  "title": "SmartStack BA - Discovery",
-  "description": "Module-level discovery: problem, stakeholders, scope, risks. Enriched by step-01-cadrage (module mode) or derived from application cadrage.",
-  "type": "object",
-  "properties": {
-    "problem": { "type": "string", "description": "Q1.1 - Business problem to solve" },
-    "asIs": { "type": "string", "description": "Q1.2 - Current situation" },
-    "toBe": { "type": "string", "description": "Q1.3 - Target situation" },
-    "trigger": { "type": "string", "description": "Q1.4 - 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" } }
-        }
-      }
-    },
-    "scope": {
-      "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" } },
-        "mainFlow": { "type": "string" },
-        "decisionPoints": { "type": "array", "items": { "type": "string" } },
-        "alternativeFlows": { "type": "array", "items": { "type": "string" } },
-        "errorCases": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "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" },
-    "openQuestions": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "id": { "type": "string" },
-          "question": { "type": "string" },
-          "answer": { "type": ["string", "null"] },
-          "status": { "type": "string", "enum": ["pending", "answered", "deferred"] }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "discovery-schema.json",
+  "title": "SmartStack BA - Discovery",
+  "description": "Module-level discovery: problem, stakeholders, scope, risks. Enriched by step-01-cadrage (module mode) or derived from application cadrage.",
+  "type": "object",
+  "properties": {
+    "problem": { "type": "string", "description": "Q1.1 - Business problem to solve" },
+    "asIs": { "type": "string", "description": "Q1.2 - Current situation" },
+    "toBe": { "type": "string", "description": "Q1.3 - Target situation" },
+    "trigger": { "type": "string", "description": "Q1.4 - 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" } }
+        }
+      }
+    },
+    "scope": {
+      "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" } },
+        "mainFlow": { "type": "string" },
+        "decisionPoints": { "type": "array", "items": { "type": "string" } },
+        "alternativeFlows": { "type": "array", "items": { "type": "string" } },
+        "errorCases": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "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" },
+    "openQuestions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string" },
+          "question": { "type": "string" },
+          "answer": { "type": ["string", "null"] },
+          "status": { "type": "string", "enum": ["pending", "answered", "deferred"] }
+        }
+      }
+    }
+  }
+}