@atlashub/smartstack-cli 1.13.1 → 1.14.0

package/templates/skills/business-analyse/_shared.md

@@ -0,0 +1,258 @@
+# Business Analysis - Shared Functions (v2 - Progressive Loading)
+
+> **Ref:** This file contains common functions for all BA phases.
+> **Version:** 2.0 - Optimized for progressive loading
+
+---
+
+## Architecture Progressive
+
+Le skill BusinessAnalyse utilise le **chargement progressif** pour minimiser le contexte:
+
+```
+SKILL.md (entry point)
+    ↓
+steps/step-00-init.md (parse flags, create state)
+    ↓
+steps/step-01-discover.md (charge questionnaire/XX.md on-demand)
+    ↓
+steps/step-02-analyse.md (charge templates/frd-brd.md)
+    ↓
+steps/step-03-specify.md (charge templates/frd-spec.md)
+    ↓
+steps/step-04-validate.md (validation gate)
+    ↓
+steps/step-05-handoff.md (charge templates/frd-handoff.md)
+    ↓
+steps/step-06-doc-html.md (charge react/*.md on-demand)
+```
+
+**Benefit:** ~70% context reduction per phase
+
+---
+
+## Business Context Validation
+
+```
+validate_business_context(context):
+  IF context IN ['platform', 'personal', 'system'] THEN
+    ERROR "BA restricted to 'business' context. Contact: support@atlshub.ch"
+    RETURN false
+  END IF
+  RETURN true
+```
+
+**CRITICAL:** BusinessAnalyze works ONLY for the `business` context.
+
+---
+
+## Feature Directory Structure
+
+```
+.business-analyse/
+├── config.json                    # Global config
+└── business/
+    └── {application}/
+        └── modules/
+            └── {module}/
+                └── features/
+                    └── {FEAT-NNN}/
+                        ├── 00-context.md      # State persistence
+                        ├── 1-discovery.md
+                        ├── 2-business-requirements.md
+                        ├── 3-functional-specification.md
+                        ├── validation.json
+                        ├── 4-development-handoff.md
+                        └── tracking/
+                            ├── changes/
+                            ├── bugs/
+                            └── hotfixes/
+```
+
+---
+
+## Feature ID Generation
+
+```
+generate_feature_id():
+  last_id = read_config(".business-analyse/config.json", "lastFeatureId") OR 0
+  new_id = last_id + 1
+  update_config(".business-analyse/config.json", "lastFeatureId", new_id)
+  RETURN format("FEAT-%03d", new_id)
+```
+
+---
+
+## Models by Phase (Step)
+
+| Step | Model | Reason |
+|------|-------|--------|
+| 00-init | Haiku | Quick structure setup |
+| 01-discover | **Opus** | ULTRATHINK elicitation |
+| 02-analyse | Sonnet | BRD modeling |
+| 03-specify | Sonnet | FRD + Use Cases |
+| 04-validate | Haiku | Binary gate |
+| 05-handoff | **Opus** | Zero-ambiguity prompt |
+| 06-doc-html | Sonnet | React + Context7 |
+
+---
+
+## ULTRATHINK
+
+Behavioral mode for critical phases (01, 02, 03, 05):
+
+```
+ULTRATHINK MODE:
+- Consider ALL edge cases
+- Challenge EVERY assumption
+- Anticipate UNEXPRESSED needs
+- Validate completeness before output
+
+DO NOT:
+- Accept vague answers
+- Skip question categories
+- Assume stakeholder thought of everything
+```
+
+**DO NOT invoke** as a skill/tool - it is a thinking mode.
+
+---
+
+## Context7 (Step 06)
+
+```
+Prompt pattern:
+"use context7 with /facebook/react and /i18next/react-i18next
+ to generate {component} following SmartStack patterns"
+```
+
+Libraries:
+- `/facebook/react` - React 19 patterns
+- `/i18next/react-i18next` - Internationalization
+- `/remix-run/react-router` - React Router v7
+- `/lucide-icons/lucide-react` - Icons
+
+---
+
+## Permission Path Format
+
+**Format:** `business.{application}.{module}.{action}`
+
+| Action | Permission | Usage |
+|--------|------------|-------|
+| Read | `.read` | GET endpoints |
+| Create | `.create` | POST endpoints |
+| Update | `.update` | PUT endpoints |
+| Delete | `.delete` | DELETE endpoints |
+| Export | `.export` | Export data |
+| Import | `.import` | Import data |
+| Admin | `.admin` | Administrative |
+
+---
+
+## i18n (4 required languages)
+
+| Language | File | Code |
+|----------|------|------|
+| French | `fr/docs-{app}-{module}.json` | fr |
+| English | `en/docs-{app}-{module}.json` | en |
+| Italian | `it/docs-{app}-{module}.json` | it |
+| German | `de/docs-{app}-{module}.json` | de |
+
+---
+
+## Output Paths
+
+| Type | Path |
+|------|------|
+| Documentation | `web/smartstack-web/src/pages/docs/business/{app}/{module}/` |
+| i18n | `web/smartstack-web/src/i18n/locales/{lang}/` |
+| Route | `/docs/business/{app}/{module}` |
+
+---
+
+## State Persistence
+
+The `00-context.md` file persists state between steps:
+
+```markdown
+# Business Analysis: {{feature_id}}
+
+## Progress
+| Step | Status | Started | Completed |
+|------|--------|---------|-----------|
+| 00-init | Complete | ... | ... |
+| 01-discover | In Progress | ... | - |
+...
+
+## State Variables
+| Variable | Value |
+|----------|-------|
+| feature_id | FEAT-001 |
+| application_name | Sales |
+...
+```
+
+**Read:** Each step starts by reading 00-context.md
+**Write:** Each step updates 00-context.md at the end
+
+---
+
+## Resume Workflow
+
+```
+resume_workflow(task_id):
+  1. Search .business-analyse/ for matching feature
+  2. Read 00-context.md
+  3. Find last "Complete" step in Progress table
+  4. Return next step to load
+
+Example:
+  /business-analyse -r FEAT-001
+  → Reads .business-analyse/.../FEAT-001/00-context.md
+  → Finds "01-discover: Complete, 02-analyse: Pending"
+  → Loads step-02-analyse.md
+```
+
+---
+
+## Standard Summary (End of Step)
+
+```
+{STEP_NAME} - {feature_id}
+├── Status: {Complete/In Progress}
+├── Key metric: {value}
+├── Output: {file created}
+└── Next: {next step name}
+```
+
+---
+
+## Config Template
+
+```json
+{
+  "project": "{Name}",
+  "lastFeatureId": 0,
+  "context": "business",
+  "standards": ["BABOK-v3", "IEEE-830"],
+  "contact": "support@atlshub.ch"
+}
+```
+
+---
+
+## Progressive Loading Benefits
+
+| Aspect | Before | After | Gain |
+|--------|--------|-------|------|
+| Questionnaire | 283 L (all) | 40-60 L (per category) | ~75% |
+| FRD Templates | 477 L (all) | 80-150 L (per type) | ~70% |
+| React Templates | 580 L (all) | 250-350 L (per need) | ~45% |
+| **Total/step** | ~1,340 L | ~300-400 L | **~70%** |
+
+---
+
+## Support
+
+Contact: **support@atlshub.ch**

package/templates/skills/business-analyse/questionnaire/01-context.md

@@ -0,0 +1,33 @@
+# Category 1: Business Context
+
+> **Usage:** Fundamental questions about the business need
+> **When to load:** ALWAYS (core)
+
+---
+
+## 1.1 Fundamental Need
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q1.1 | What business problem should this module/feature solve? | Free text |
+| Q1.2 | What is the current situation (AS-IS)? | Description |
+| Q1.3 | What is the target situation (TO-BE)? | Description |
+| Q1.4 | What are the measurable success KPIs? | List + values |
+
+## 1.2 Business Value
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q1.5 | What ROI do you expect? (time, money, efficiency) | Quantitative |
+| Q1.6 | What savings or gains will this module bring? | Estimation |
+| Q1.7 | What happens if this module is NOT developed? | Impact |
+| Q1.8 | What is the priority compared to other needs? | High/Medium/Low |
+
+---
+
+## Follow-up Questions
+
+For each vague answer:
+- "Can you give a concrete example?"
+- "How do you measure that today?"
+- "What happens if this rule is not respected?"

package/templates/skills/business-analyse/questionnaire/02-stakeholders.md

@@ -0,0 +1,35 @@
+# Category 2: Stakeholders
+
+> **Usage:** Identification of stakeholders and their needs
+> **When to load:** ALWAYS (core)
+
+---
+
+## 2.1 Identification
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q2.1 | Who are the direct end users? | List of roles |
+| Q2.2 | Who are the indirect beneficiaries? | List |
+| Q2.3 | Who is the sponsor/final decision maker? | Name + role |
+| Q2.4 | Who can block the project? | List + reasons |
+
+## 2.2 Needs by Role
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q2.5 | For each role: What tasks should they accomplish? | Per role |
+| Q2.6 | What frequency of use per role? | Daily/Weekly/Monthly |
+| Q2.7 | What level of technical expertise per role? | Novice/Intermediate/Expert |
+| Q2.8 | What current frustrations per role? | List of pain points |
+
+---
+
+## Role -> Permission Mapping
+
+| Discovered Role | SmartStack Permission |
+|-----------------|----------------------|
+| Admin | `*.admin` |
+| Manager | `*.read,create,update` |
+| User | `*.read,create` |
+| ReadOnly | `*.read` |

package/templates/skills/business-analyse/questionnaire/03-scope.md

@@ -0,0 +1,35 @@
+# Category 3: Functional Scope
+
+> **Usage:** Scope definition with MoSCoW
+> **When to load:** ALWAYS (core)
+
+---
+
+## 3.1 Functionality (MoSCoW)
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q3.1 | List ESSENTIAL features (Must-Have) | List |
+| Q3.2 | List DESIRED features (Should-Have) | List |
+| Q3.3 | List OPTIONAL features (Could-Have) | List |
+| Q3.4 | What is EXPLICITLY excluded? | List of exclusions |
+
+## 3.2 Business Process
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q3.5 | Describe the main user flow | Steps |
+| Q3.6 | What are the decision points in the flow? | List |
+| Q3.7 | What alternative flows exist? | Per condition |
+| Q3.8 | What are the possible error cases? | List |
+
+---
+
+## Prioritization
+
+| Priority | Criterion |
+|----------|-----------|
+| Must | Without this feature, the module has no value |
+| Should | Brings significant value but can wait for v2 |
+| Could | Nice-to-have, can be implemented if time available |
+| Won't | Explicitly excluded from scope |

package/templates/skills/business-analyse/questionnaire/04-data.md

@@ -0,0 +1,36 @@
+# Category 4: Data
+
+> **Usage:** Definition of entities and data rules
+> **When to load:** If feature is data-centric or full module
+
+---
+
+## 4.1 Entities
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q4.1 | What are the main entities handled? | List |
+| Q4.2 | For each entity: important attributes? | Per entity |
+| Q4.3 | What relationships exist between entities? | Text schema |
+| Q4.4 | Expected data volume? | Estimation |
+
+## 4.2 Data Rules
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q4.5 | What validations on data? | List of rules |
+| Q4.6 | Which fields are required vs optional? | Per field |
+| Q4.7 | What specific formats/constraints? | List |
+| Q4.8 | Sensitive data to protect? | List + level |
+
+---
+
+## SmartStack Mapping
+
+| Business Concept | SmartStack |
+|-----------------|------------|
+| Main entity | Domain Entity |
+| Required attribute | `[Required]` |
+| Unique attribute | `HasIndex().IsUnique()` |
+| 1:N relationship | Navigation property |
+| Sensitive data | Encryption + audit |

package/templates/skills/business-analyse/questionnaire/05-integrations.md

@@ -0,0 +1,36 @@
+# Category 5: Integrations
+
+> **Usage:** Connections with internal and external systems
+> **When to load:** If feature involves integrations
+
+---
+
+## 5.1 Existing Systems
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q5.1 | What internal systems should we integrate with? | List |
+| Q5.2 | What external systems? | List |
+| Q5.3 | Existing APIs to use? | Documentation |
+| Q5.4 | Data to import from another system? | List + format |
+
+## 5.2 Data Flows
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q5.5 | Flow direction? (inbound/outbound/bidirectional) | Per system |
+| Q5.6 | Synchronization frequency? | Real-time/Batch |
+| Q5.7 | Data conflict management? | Strategy |
+| Q5.8 | Fallback if external system unavailable? | Behavior |
+
+---
+
+## SmartStack Patterns
+
+| Integration Type | Pattern |
+|-----------------|---------|
+| REST API | HttpClient + Polly |
+| Message Queue | MassTransit |
+| Webhook | Controller endpoint |
+| Real-time | SignalR |
+| Batch import | Background job |

package/templates/skills/business-analyse/questionnaire/06-security.md

@@ -0,0 +1,40 @@
+# Category 6: Security & Permissions
+
+> **Usage:** Definition of access and restrictions
+> **When to load:** ALWAYS (core, minimal)
+
+---
+
+## 6.1 Access
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q6.1 | Who can VIEW data? | List of roles |
+| Q6.2 | Who can CREATE entries? | List of roles |
+| Q6.3 | Who can MODIFY? | List of roles |
+| Q6.4 | Who can DELETE? | List of roles |
+
+## 6.2 Restrictions
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q6.5 | Geographic restrictions? | Countries/regions |
+| Q6.6 | Time-based restrictions? (hours, periods) | Ranges |
+| Q6.7 | Audit trail required? Which actions? | List |
+| Q6.8 | Regulatory compliance? (GDPR, etc.) | List of standards |
+
+---
+
+## SmartStack Permission
+
+**Format:** `business.{application}.{module}.{action}`
+
+| Action | Permission |
+|--------|------------|
+| Read | `.read` |
+| Create | `.create` |
+| Update | `.update` |
+| Delete | `.delete` |
+| Export | `.export` |
+| Import | `.import` |
+| Admin | `.admin` |

package/templates/skills/business-analyse/questionnaire/07-ui.md

@@ -0,0 +1,36 @@
+# Category 7: User Interface
+
+> **Usage:** Definition of user experience
+> **When to load:** If feature is UI-centric or full module
+
+---
+
+## 7.1 Experience
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q7.1 | Target devices? (desktop, mobile, tablet) | List |
+| Q7.2 | Browsers to support? | List + versions |
+| Q7.3 | Accessibility required? (WCAG level) | A/AA/AAA |
+| Q7.4 | Dark/light mode required? | Yes/No |
+
+## 7.2 Screens
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q7.5 | Main screens needed? | List |
+| Q7.6 | Existing mockups/wireframes? | Documents |
+| Q7.7 | Key information per screen? | Per screen |
+| Q7.8 | Possible actions per screen? | Per screen |
+
+---
+
+## SmartStack Components
+
+| Need | Component |
+|------|-----------|
+| List with pagination | DataTable |
+| Creation form | Form + Modal |
+| Edit form | Form + Modal |
+| Filters | FilterBar |
+| Export | ExportButton |

package/templates/skills/business-analyse/questionnaire/08-performance.md

@@ -0,0 +1,35 @@
+# Category 8: Performance & Quality
+
+> **Usage:** Non-functional performance requirements
+> **When to load:** If feature is performance-critical or reporting
+
+---
+
+## 8.1 Performance
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q8.1 | Acceptable response time? | Milliseconds |
+| Q8.2 | Number of concurrent users? | Estimation |
+| Q8.3 | Expected load peaks? | When + volume |
+| Q8.4 | Required availability? (SLA) | Percentage |
+
+## 8.2 Quality
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q8.5 | Acceptable error rate? | Percentage |
+| Q8.6 | Specific tests required? | Types |
+| Q8.7 | Available test environments? | List |
+| Q8.8 | Overall acceptance criteria? | List |
+
+---
+
+## SmartStack Thresholds
+
+| Metric | Acceptable Threshold |
+|--------|---------------------|
+| API response time | < 200ms (P95) |
+| Page load | < 2s |
+| Concurrent users | Per license |
+| Uptime | 99.5% |

package/templates/skills/business-analyse/questionnaire/09-constraints.md

@@ -0,0 +1,35 @@
+# Category 9: Constraints
+
+> **Usage:** Technical and organizational constraints
+> **When to load:** If constraints identified or workflow feature
+
+---
+
+## 9.1 Technical
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q9.1 | Mandated tech stack? | Technologies |
+| Q9.2 | Infrastructure limitations? | Description |
+| Q9.3 | Technology dependencies? | List |
+| Q9.4 | Compatibility constraints? | List |
+
+## 9.2 Organizational
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q9.5 | Available budget? | Amount |
+| Q9.6 | Fixed or flexible deadline? | Date + flexibility |
+| Q9.7 | Available resources? | Team |
+| Q9.8 | Approval process? | Steps |
+
+---
+
+## SmartStack Constraints
+
+| Constraint | Impact |
+|-----------|--------|
+| Multi-tenant | TenantId required |
+| .NET 8+ | Minimum version |
+| React 19+ | Frontend version |
+| SQL Server/PostgreSQL | Supported databases |

package/templates/skills/business-analyse/questionnaire/10-documentation.md

@@ -0,0 +1,35 @@
+# Category 10: Documentation & Support
+
+> **Usage:** Documentation and support needs
+> **When to load:** If documentation explicitly required
+
+---
+
+## 10.1 Documentation
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q10.1 | User documentation needed? | Yes/No + type |
+| Q10.2 | Technical documentation needed? | Yes/No + type |
+| Q10.3 | User training planned? | Plan |
+| Q10.4 | Knowledge base to create? | Scope |
+
+## 10.2 Support
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q10.5 | Expected support level? | SLA |
+| Q10.6 | Who provides level 1 support? | Team |
+| Q10.7 | Escalation to level 2? | Process |
+| Q10.8 | Monitoring and alerts required? | List |
+
+---
+
+## SmartStack Documentation
+
+| Type | Generated by |
+|------|-------------|
+| FRD Documentation | `/business-analyse:6-doc-html` |
+| Swagger API | Automatic |
+| User guide | Manual or AI |
+| Release notes | `/gitflow:11-finish` |