@atlashub/smartstack-cli 1.13.2 → 1.14.0

package/templates/skills/business-analyse/react/schema.md

@@ -0,0 +1,151 @@
+# TypeScript Schema - FRD Data Types
+
+> **Usage:** TypeScript interfaces for FRD documentation
+> **Loaded in:** step-06-doc-html.md
+
+---
+
+## Type Definitions
+
+```typescript
+// web/smartstack-web/src/pages/docs/business/{app}/{module}/types.ts
+
+/**
+ * Use Case definition from FRD
+ */
+export interface UseCase {
+  /** Unique identifier (e.g., "UC-001") */
+  id: string;
+  /** Use case name */
+  name: string;
+  /** Primary actor role */
+  actor: string;
+  /** Required permission path */
+  permission: string;
+  /** Brief description */
+  description: string;
+}
+
+/**
+ * Business Rule from BRD
+ */
+export interface BusinessRule {
+  /** Unique identifier (e.g., "BR-001") */
+  id: string;
+  /** Rule description */
+  rule: string;
+  /** Category: Validation, Calculation, Workflow, Security, Data */
+  category: 'Validation' | 'Calculation' | 'Workflow' | 'Security' | 'Data';
+  /** MoSCoW priority */
+  priority: 'Must' | 'Should' | 'Could';
+}
+
+/**
+ * Permission definition
+ */
+export interface Permission {
+  /** Full permission path (e.g., "business.sales.orders.read") */
+  path: string;
+  /** Human-readable description */
+  description: string;
+  /** Roles that have this permission */
+  roles: string[];
+}
+
+/**
+ * Complete FRD data structure
+ */
+export interface FrdData {
+  /** Feature identifier (e.g., "FEAT-001") */
+  featureId: string;
+  /** Module name in PascalCase */
+  moduleName: string;
+  /** Application name in PascalCase */
+  applicationName: string;
+  /** Document version */
+  version: string;
+  /** List of use cases */
+  useCases: UseCase[];
+  /** List of business rules */
+  businessRules: BusinessRule[];
+  /** List of permissions */
+  permissions: Permission[];
+}
+```
+
+---
+
+## Data File Template
+
+```typescript
+// web/smartstack-web/src/pages/docs/business/{app}/{module}/frdData.ts
+
+import type { FrdData } from './types';
+
+/**
+ * FRD data extracted from 3-functional-specification.md
+ * Generated by /business-analyse:6-doc-html
+ */
+export const frdData: FrdData = {
+  featureId: '{{feature_id}}',
+  moduleName: '{{module_name}}',
+  applicationName: '{{application_name}}',
+  version: '1.0',
+
+  useCases: [
+    {
+      id: 'UC-001',
+      name: '{{use_case_name}}',
+      actor: '{{actor}}',
+      permission: 'business.{{app}}.{{module}}.{{action}}',
+      description: '{{description}}'
+    }
+    // Add more use cases...
+  ],
+
+  businessRules: [
+    {
+      id: 'BR-001',
+      rule: '{{rule_description}}',
+      category: 'Validation',
+      priority: 'Must'
+    }
+    // Add more business rules...
+  ],
+
+  permissions: [
+    {
+      path: 'business.{{app}}.{{module}}.read',
+      description: 'View {{module}} data',
+      roles: ['Admin', 'Manager', 'User', 'ReadOnly']
+    },
+    {
+      path: 'business.{{app}}.{{module}}.create',
+      description: 'Create new {{module}}',
+      roles: ['Admin', 'Manager']
+    },
+    {
+      path: 'business.{{app}}.{{module}}.update',
+      description: 'Update existing {{module}}',
+      roles: ['Admin', 'Manager']
+    },
+    {
+      path: 'business.{{app}}.{{module}}.delete',
+      description: 'Delete {{module}}',
+      roles: ['Admin']
+    }
+  ]
+};
+```
+
+---
+
+## Index Export
+
+```typescript
+// web/smartstack-web/src/pages/docs/business/{app}/{module}/index.ts
+
+export { {ModuleName}FrdDocPage } from './FrdDocPage';
+export type { FrdData, UseCase, BusinessRule, Permission } from './types';
+export { frdData } from './frdData';
+```

package/templates/skills/business-analyse/steps/step-00-init.md

@@ -0,0 +1,293 @@
+---
+name: step-00-init
+description: Initialize Business Analysis - Parse flags, create structure, setup state
+model: haiku
+next_step: steps/step-01-discover.md
+---
+
+<objective>
+Parse command-line flags, create feature directory structure, and initialize state variables for the Business Analysis workflow.
+</objective>
+
+<defaults>
+```yaml
+auto_mode: false
+save_mode: true      # BA always saves by default
+economy_mode: false
+context: business    # BA is RESTRICTED to business context
+```
+</defaults>
+
+## EXECUTION SEQUENCE
+
+### 1. Parse Flags and Input
+
+**Step 1: Load defaults**
+```
+{auto_mode}    = false
+{save_mode}    = true
+{economy_mode} = false
+{context}      = "business"
+```
+
+**Step 2: Parse user input and override defaults:**
+
+Enable flags (lowercase - turn ON):
+- `-a` or `--auto`     -> `{auto_mode}` = true
+- `-s` or `--save`     -> `{save_mode}` = true (already default)
+- `-e` or `--economy`  -> `{economy_mode}` = true
+
+Disable flags (UPPERCASE - turn OFF):
+- `-A` or `--no-auto`     -> `{auto_mode}` = false
+- `-S` or `--no-save`     -> `{save_mode}` = false
+- `-E` or `--no-economy`  -> `{economy_mode}` = false
+
+Other:
+- `-r` or `--resume`      -> `{resume_task}` = <next argument>
+- `-i` or `--interactive` -> `{interactive_mode}` = true
+
+**Step 3: Extract feature description**
+After removing flags, remaining text becomes `{feature_description}`
+
+---
+
+### 2. Check Resume Mode
+
+**ONLY execute if `{resume_task}` is set!**
+
+If `{resume_task}` is set:
+1. Search for matching feature in `.business-analyse/`
+   ```bash
+   find .business-analyse -type d -name "*{resume_task}*" 2>/dev/null | head -1
+   ```
+2. If found: Read `00-context.md` to restore state variables
+3. Find last completed step (look for "Status: Complete" in progress table)
+4. Load next incomplete step
+5. **STOP** - do not continue with fresh init
+
+If NOT found:
+- Display error: "Feature {resume_task} not found"
+- List available features for selection
+- Exit or prompt for new task
+
+---
+
+### 3. Interactive Mode (if -i flag)
+
+If `{interactive_mode}` = true:
+
+Use AskUserQuestion with these questions:
+
+```json
+{
+  "questions": [
+    {
+      "question": "What execution mode do you prefer?",
+      "header": "Mode",
+      "options": [
+        {"label": "Autonomous (-a)", "description": "No confirmations, smooth execution"},
+        {"label": "Interactive", "description": "Confirmation at each step"}
+      ],
+      "multiSelect": false
+    },
+    {
+      "question": "Use economy mode (without subagents)?",
+      "header": "Economy",
+      "options": [
+        {"label": "No (Recommended)", "description": "Better quality with subagents"},
+        {"label": "Yes (-e)", "description": "Token savings, lower quality"}
+      ],
+      "multiSelect": false
+    }
+  ]
+}
+```
+
+---
+
+### 4. Validate Business Context
+
+**CRITICAL: BA is RESTRICTED to 'business' context only!**
+
+```
+IF {context} IN ['platform', 'personal', 'system'] THEN
+  DISPLAY ERROR:
+  "Business Analysis is restricted to 'business' context only.
+   Platform/Personal/System modules use different processes.
+   Contact: support@atlshub.ch"
+  EXIT
+END IF
+```
+
+---
+
+### 5. Determine Application and Module
+
+Ask user to specify:
+
+```json
+{
+  "questions": [
+    {
+      "question": "Which business application to target?",
+      "header": "Application",
+      "options": [
+        {"label": "New application", "description": "Create a new business application"},
+        {"label": "Existing application", "description": "Add a module to an existing application"}
+      ],
+      "multiSelect": false
+    }
+  ]
+}
+```
+
+If "Existing application":
+- Scan `.business-analyse/business/` for existing applications
+- Present list for selection
+
+Store in:
+- `{application_name}` - PascalCase (e.g., "Sales", "HR", "Inventory")
+- `{module_name}` - PascalCase (e.g., "Clients", "Orders", "Products")
+
+---
+
+### 6. Generate Feature ID
+
+```bash
+# Read last ID from config
+LAST_ID=$(grep -oP '"lastFeatureId":\s*\K\d+' .business-analyse/config.json 2>/dev/null || echo "0")
+
+# Increment
+NEW_ID=$((LAST_ID + 1))
+
+# Format as FEAT-NNN
+{feature_id} = printf "FEAT-%03d" $NEW_ID
+```
+
+---
+
+### 7. Create Output Structure
+
+**Create directory structure:**
+
+```
+.business-analyse/
+├── config.json                    # Global config (update lastFeatureId)
+└── business/
+    └── {application_name}/
+        └── modules/
+            └── {module_name}/
+                └── features/
+                    └── {feature_id}/
+                        ├── 00-context.md      # State + progress
+                        └── tracking/
+                            ├── changes/
+                            ├── bugs/
+                            └── hotfixes/
+```
+
+**Set output_dir:**
+```
+{output_dir} = .business-analyse/business/{application_name}/modules/{module_name}/features/{feature_id}
+```
+
+---
+
+### 8. Write 00-context.md
+
+Create initial context file with state variables:
+
+```markdown
+# Business Analysis: {{feature_id}}
+
+**Created:** {{timestamp}}
+**Feature:** {{feature_description}}
+**Application:** business/{{application_name}}/{{module_name}}
+
+## Configuration
+
+| Setting | Value |
+|---------|-------|
+| Auto mode | {{auto_mode}} |
+| Save mode | {{save_mode}} |
+| Economy mode | {{economy_mode}} |
+
+## Progress
+
+| Step | Status | Started | Completed |
+|------|--------|---------|-----------|
+| 00-init | Complete | {{timestamp}} | {{timestamp}} |
+| 01-discover | Pending | - | - |
+| 02-analyse | Pending | - | - |
+| 03-specify | Pending | - | - |
+| 04-validate | Pending | - | - |
+| 05-handoff | Pending | - | - |
+| 06-doc-html | Pending | - | - |
+
+## State Variables
+
+| Variable | Value |
+|----------|-------|
+| feature_id | {{feature_id}} |
+| feature_description | {{feature_description}} |
+| application_name | {{application_name}} |
+| module_name | {{module_name}} |
+| context | business |
+| permission_base | business.{{application_name}}.{{module_name}} |
+
+## Acceptance Criteria
+
+To be defined in step-01-discover.
+
+---
+
+## Notes
+
+(Add notes during analysis)
+```
+
+---
+
+### 9. Update Global Config
+
+Update `.business-analyse/config.json`:
+
+```json
+{
+  "project": "{ProjectName}",
+  "lastFeatureId": {NEW_ID},
+  "context": "business",
+  "standards": ["BABOK-v3", "IEEE-830"],
+  "contact": "support@atlshub.ch"
+}
+```
+
+---
+
+### 10. Display Summary and Load Next Step
+
+**Display:**
+```
+INIT - {{feature_id}}
+├── Application: business/{{application_name}}
+├── Module: {{module_name}}
+├── Output: {{output_dir}}
+├── Mode: {{auto_mode ? "Autonomous" : "Interactive"}}
+└── Next: step-01-discover (ULTRATHINK elicitation)
+```
+
+**Load next step:**
+```
+Read and execute: steps/step-01-discover.md
+```
+
+---
+
+## OUTPUT
+
+This step produces:
+- `.business-analyse/config.json` (updated)
+- `{output_dir}/00-context.md` (created)
+- `{output_dir}/tracking/` directories (created)
+
+State variables persisted for next steps.

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

@@ -0,0 +1,267 @@
+---
+name: step-01-discover
+description: Discovery phase - Elicitation with ULTRATHINK (load questionnaire progressively)
+model: opus
+prev_step: steps/step-00-init.md
+next_step: steps/step-02-analyse.md
+---
+
+<objective>
+Conduct comprehensive requirements elicitation using ULTRATHINK mode.
+Load questionnaire categories progressively based on feature type.
+</objective>
+
+<ultrathink>
+ULTRATHINK MODE ACTIVE - Critical thinking required:
+- Consider ALL edge cases before formulating questions
+- Challenge EVERY stakeholder assumption
+- Anticipate UNEXPRESSED needs
+- Validate completeness before proceeding
+- DO NOT accept vague answers
+- DO NOT skip question categories
+</ultrathink>
+
+## EXECUTION SEQUENCE
+
+### 1. Read Current State
+
+Read `{output_dir}/00-context.md` to restore:
+- `{feature_id}`
+- `{feature_description}`
+- `{application_name}`
+- `{module_name}`
+- `{auto_mode}`
+- `{economy_mode}`
+
+Update progress: `01-discover` -> "In Progress"
+
+---
+
+### 2. Determine Feature Type
+
+Analyze `{feature_description}` to categorize:
+
+| Type | Indicators | Load Categories |
+|------|------------|-----------------|
+| **Data-centric** | "management", "CRUD", "entity", "data" | 01, 02, 03, 04, 06 |
+| **Integration** | "API", "sync", "import", "export", "external" | 01, 02, 03, 05, 06 |
+| **UI-centric** | "screen", "form", "dashboard", "interface" | 01, 02, 03, 06, 07 |
+| **Workflow** | "process", "validation", "workflow", "steps" | 01, 02, 03, 06, 09 |
+| **Reporting** | "report", "export", "statistics", "KPI" | 01, 02, 03, 04, 08 |
+| **Full module** | "module", "complete", "feature" | ALL categories |
+
+Store: `{feature_type}`
+
+---
+
+### 3. Load Questionnaire Categories (Progressive)
+
+**IMPORTANT: Load ONLY relevant categories to minimize context!**
+
+#### Always load (core):
+```
+Read: questionnaire/01-context.md      # ~50 lines
+Read: questionnaire/02-stakeholders.md # ~40 lines
+Read: questionnaire/03-scope.md        # ~35 lines
+Read: questionnaire/06-security.md     # ~30 lines (minimal)
+```
+
+#### Conditional loading based on feature_type:
+```
+IF {feature_type} = "Data-centric" OR "Full module":
+  Read: questionnaire/04-data.md       # ~45 lines
+
+IF {feature_type} = "Integration" OR "Full module":
+  Read: questionnaire/05-integrations.md # ~30 lines
+
+IF {feature_type} = "UI-centric" OR "Full module":
+  Read: questionnaire/07-ui.md         # ~20 lines
+
+IF {feature_type} = "Reporting" OR performance-critical:
+  Read: questionnaire/08-performance.md # ~25 lines
+
+IF {feature_type} = "Workflow" OR constraints exist:
+  Read: questionnaire/09-constraints.md # ~25 lines
+
+IF documentation required:
+  Read: questionnaire/10-documentation.md # ~20 lines
+```
+
+**Maximum context per discovery: ~150-200 lines** (vs 283 lines before)
+
+---
+
+### 4. Conduct Elicitation
+
+#### 4.1 Category 1: Business Context (ALWAYS)
+
+Ask questions from `01-context.md`:
+- Q1.1: Business problem to solve?
+- Q1.2: Current situation (AS-IS)?
+- Q1.3: Target situation (TO-BE)?
+- Q1.4: Measurable KPIs?
+- Q1.5-Q1.8: Business value questions
+
+**ULTRATHINK checkpoint:**
+- Is the problem clearly defined?
+- Are success criteria measurable?
+- What happens if NOT developed?
+
+#### 4.2 Category 2: Stakeholders (ALWAYS)
+
+Ask questions from `02-stakeholders.md`:
+- Q2.1-Q2.4: Identification
+- Q2.5-Q2.8: Needs per role
+
+**ULTRATHINK checkpoint:**
+- All user types identified?
+- Pain points documented per role?
+- Decision maker confirmed?
+
+#### 4.3 Category 3: Scope (ALWAYS)
+
+Ask questions from `03-scope.md`:
+- Q3.1-Q3.4: MoSCoW prioritization
+- Q3.5-Q3.8: Process flows
+
+**ULTRATHINK checkpoint:**
+- Must-Have vs Should-Have clear?
+- Exclusions explicit?
+- Main flow documented?
+
+#### 4.4 Additional Categories (CONDITIONAL)
+
+For each loaded category, conduct targeted elicitation.
+Document responses with:
+- Source (who answered)
+- Confidence level (Confirmed/To validate/Hypothesis)
+- Follow-up questions
+
+---
+
+### 5. Explore Codebase (if economy_mode = false)
+
+**Launch parallel exploration agents:**
+
+```
+Agent 1: Existing patterns
+  "Search for similar modules in src/SmartStack.Domain/Entities/
+   and src/SmartStack.Application/Features/ to understand patterns"
+
+Agent 2: Related integrations
+  "Search for existing APIs and integrations that this module
+   might need to connect with"
+
+Agent 3: UI patterns (if UI-centric)
+  "Search for similar pages in web/smartstack-web/src/pages/business/
+   to understand React patterns"
+```
+
+If `{economy_mode}` = true:
+- Use direct Glob/Grep tools only
+- Read 3-5 most relevant files
+- Skip subagents
+
+---
+
+### 6. Synthesize Discovery
+
+Compile all findings into structured format:
+
+```markdown
+# Discovery - {feature_id} {feature_description}
+
+> **Module:** business/{application_name}/{module_name}
+> **Version:** 1.0
+> **Date:** {timestamp}
+> **Author:** Business Analyst (Claude)
+
+## 1. Business Context
+
+### 1.1 Need Description
+{Synthesized from Q1.1-Q1.4}
+
+### 1.2 Current Problem
+{From Q1.2}
+
+### 1.3 Expected Value
+{From Q1.5-Q1.7, quantified if possible}
+
+## 2. Stakeholders
+
+| Role | Function | Involvement | Decision Level |
+|------|----------|-------------|-----------------|
+{Table from Q2.x responses}
+
+## 3. Scope
+
+### 3.1 In Scope (Must-Have)
+{From Q3.1}
+
+### 3.2 Should-Have
+{From Q3.2}
+
+### 3.3 Out of Scope
+{From Q3.4 - EXPLICIT exclusions}
+
+## 4. Open Questions
+
+| # | Question | Answer | Status |
+|---|----------|--------|--------|
+{Any unresolved questions}
+
+## 5. Identified Constraints
+
+| Type | Constraint | Impact |
+|------|------------|--------|
+{From loaded constraint categories}
+
+## 6. Acceptance Criteria (Inferred)
+
+- [ ] AC-001: {criterion 1}
+- [ ] AC-002: {criterion 2}
+...
+```
+
+---
+
+### 7. Save Output
+
+Write to: `{output_dir}/1-discovery.md`
+
+Update `00-context.md`:
+- Progress: `01-discover` -> "Complete"
+- Add acceptance criteria to state
+
+---
+
+### 8. Display Summary and Load Next Step
+
+**Display:**
+```
+DISCOVERY - {feature_id}
+├── Status: Complete
+├── Categories loaded: {list of loaded categories}
+├── Questions answered: {count}
+├── Open questions: {count}
+├── Output: {output_dir}/1-discovery.md
+└── Next: step-02-analyse (BRD formalization)
+```
+
+**If NOT auto_mode:**
+Ask: "Proceed with business rules analysis?"
+
+**Load next step:**
+```
+Read and execute: steps/step-02-analyse.md
+```
+
+---
+
+## OUTPUT
+
+This step produces:
+- `{output_dir}/1-discovery.md` (created)
+- `{output_dir}/00-context.md` (updated with AC)
+
+Questionnaire categories loaded: **~150-200 lines max** (70% reduction)