@atlashub/smartstack-cli 2.6.3 → 2.7.0

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

@@ -0,0 +1,157 @@
+{
+  "$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-03-specify.",
+  "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" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "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

@@ -0,0 +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"] }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "handoff-schema.json",
+  "title": "SmartStack BA - Handoff",
+  "description": "Module-level handoff: file mapping (7 categories), BR-to-code mapping, API endpoint summary. Used by step-05-handoff.",
+  "type": "object",
+  "properties": {
+    "complexity": { "type": "string", "enum": ["simple", "medium", "complex"] },
+    "filesToCreate": {
+      "type": "object",
+      "properties": {
+        "domain": { "type": "array", "items": { "$ref": "../shared/common-defs.json#/$defs/fileSpec" } },
+        "application": { "type": "array", "items": { "$ref": "../shared/common-defs.json#/$defs/fileSpec" } },
+        "infrastructure": { "type": "array", "items": { "$ref": "../shared/common-defs.json#/$defs/fileSpec" } },
+        "api": { "type": "array", "items": { "$ref": "../shared/common-defs.json#/$defs/fileSpec" } },
+        "frontend": { "type": "array", "items": { "$ref": "../shared/common-defs.json#/$defs/fileSpec" } },
+        "seedData": { "type": "array", "items": { "$ref": "../shared/common-defs.json#/$defs/fileSpec" } },
+        "tests": { "type": "array", "items": { "$ref": "../shared/common-defs.json#/$defs/fileSpec" } }
+      }
+    },
+    "brToCodeMapping": {
+      "type": "array",
+      "description": "Maps each business rule to its implementation points across layers",
+      "items": {
+        "type": "object",
+        "required": ["ruleId", "implementationPoints"],
+        "properties": {
+          "ruleId": { "type": "string", "description": "BR-XXX identifier from analysis.businessRules" },
+          "title": { "type": "string" },
+          "implementationPoints": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["layer", "component"],
+              "properties": {
+                "layer": { "type": "string", "description": "Architecture layer (Domain, Application, Infrastructure, API, Frontend)" },
+                "component": { "type": "string", "description": "File name (e.g., Order.cs, OrdersController.cs)" },
+                "method": { "type": "string" },
+                "implementation": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "apiEndpointSummary": {
+      "type": "array",
+      "description": "Subset of specification.apiEndpoints enriched with linkedUC. MUST use EXACT same routes as specification.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "operation": { "type": "string" },
+          "method": { "type": "string", "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"] },
+          "route": { "type": "string" },
+          "linkedUC": { "type": "string" },
+          "permissions": { "type": "string" }
+        }
+      }
+    },
+    "ralphPrd": {
+      "type": "object",
+      "description": "Embedded Ralph Loop task breakdown (also exported to .ralph/prd.json by ss derive-prd)",
+      "properties": {
+        "tasks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": { "type": "integer" },
+              "description": { "type": "string" },
+              "category": { "type": "string", "enum": ["domain", "seedData", "seedDataCore", "application", "infrastructure", "api", "frontend", "i18n", "test", "validation"] },
+              "dependencies": { "type": "array", "items": { "type": "integer" } },
+              "acceptanceCriteria": { "type": "string" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "metadata-schema.json",
+  "title": "SmartStack BA - Metadata & Application Context",
+  "description": "Module metadata and inherited application context. Used by step-00-init.",
+
+  "properties": {
+    "metadata": {
+      "type": "object",
+      "required": ["createdAt", "updatedAt", "application", "module", "context", "language", "featureDescription"],
+      "properties": {
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" },
+        "application": { "type": "string", "description": "Application name (PascalCase)" },
+        "module": { "type": "string", "description": "Module name (PascalCase)" },
+        "context": { "type": "string", "const": "business" },
+        "language": { "type": "string", "enum": ["fr", "en", "it", "de"] },
+        "featureDescription": { "type": "string" },
+        "featureType": {
+          "type": "string",
+          "enum": ["data-centric", "integration", "ui-centric", "workflow", "reporting", "full-module", "micro"]
+        },
+        "useCase": { "type": "string", "enum": ["new", "refactoring", "micro"] },
+        "permissionBase": { "type": "string", "description": "e.g., business.sales.orders" },
+        "previousVersion": { "type": ["string", "null"] },
+        "changeReason": { "type": ["string", "null"] },
+        "mcpAvailable": { "type": "boolean" },
+        "economyMode": { "type": "boolean" },
+        "scope": { "type": "string", "enum": ["application", "module"], "default": "module" },
+        "applicationRef": { "type": ["string", "null"], "description": "Parent application feature ID (FEAT-XXX)" },
+        "applicationPath": { "type": ["string", "null"], "description": "Path to parent application-level feature.json" },
+        "moduleIndex": { "type": ["integer", "null"], "description": "Position in topological order (0-based)" },
+        "totalModules": { "type": ["integer", "null"] },
+        "inheritsRoles": { "type": "boolean", "default": false },
+        "steps": {
+          "type": "object",
+          "properties": {
+            "init": { "$ref": "../shared/common-defs.json#/$defs/stepStatus" },
+            "cadrage": { "$ref": "../shared/common-defs.json#/$defs/stepStatus" },
+            "specify": { "$ref": "../shared/common-defs.json#/$defs/stepStatus" },
+            "validate": { "$ref": "../shared/common-defs.json#/$defs/stepStatus" },
+            "handoff": { "$ref": "../shared/common-defs.json#/$defs/stepStatus" }
+          }
+        }
+      }
+    },
+
+    "applicationContext": {
+      "type": "object",
+      "description": "Inherited from parent application feature.json when part of multi-module analysis",
+      "properties": {
+        "applicationRoles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "role": { "type": "string" },
+              "description": { "type": "string" },
+              "level": { "$ref": "../shared/common-defs.json#/$defs/roleLevel" },
+              "permissionPattern": { "type": "string" }
+            }
+          }
+        },
+        "permissionBase": { "type": "string" },
+        "relatedModules": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}