---
name: business-analyse
description: |
  Analyses business requirements and generates functional specifications (FRD) for SmartStack.
  Produces HTML documentation in the web project. Restricted to Business context only.
  Use when:
  - User asks to analyze a business need or requirement
  - User mentions "specification", "FRD", "user story", "business rules"
  - User wants to document a new module or feature in Business context
  - User needs functional documentation for client-facing features
  Context: Business > Application > Module > Section only
---

# Skill Business Analyse SmartStack

> **Workflow orienté projet:** Business > Application > Module > Section
> **Output:** Composants React dans `web/smartstack-web/src/pages/docs/business/`

## PHASE 0: VALIDATION CONTEXTE BUSINESS (CRITIQUE)

```
╔══════════════════════════════════════════════════════════════════════════════╗
║  RESTRICTION: CONTEXTE BUSINESS UNIQUEMENT                                   ║
╠══════════════════════════════════════════════════════════════════════════════╣
║                                                                              ║
║  AVANT toute analyse, VÉRIFIER:                                              ║
║                                                                              ║
║  ❌ REFUSER si contexte = "platform" (réservé core SmartStack)               ║
║  ❌ REFUSER si contexte = "personal" (réservé espace utilisateur)            ║
║  ❌ REFUSER si contexte = "system" (réservé infrastructure)                  ║
║                                                                              ║
║  ✅ ACCEPTER uniquement contexte = "business"                                ║
║                                                                              ║
║  MESSAGE ERREUR:                                                             ║
║  "La Business Analyse est réservée au contexte 'business' pour les          ║
║   modules client. Les contextes platform/personal/system sont gérés          ║
║   par l'équipe core SmartStack."                                             ║
║                                                                              ║
║  Contact: support@atlshub.ch                                                 ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝
```

## QUAND CE SKILL S'ACTIVE

| Déclencheur | Exemple |
|-------------|---------|
| Demande explicite | "Analyse le besoin de gestion des tickets" |
| Mention spec/FRD | "Il faut créer les specs pour le module CRM" |
| Nouveau module business | "Ajouter un module de facturation client" |
| Documentation fonctionnelle | "Documenter les règles métier du SLA" |

---

## WORKFLOW 7 PHASES (FRD → HTML)

```
════════════════════════════════════════════════════════════════════════════════

   INIT       DISCOVER      ANALYSE       SPECIFY      VALIDATE      HANDOFF      DOC-HTML
  ┌─────┐    ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌────────┐   ┌─────────┐  ┌─────────┐
  │Setup│───►│Elicit   │──►│Model    │──►│FRD      │──►│Approve │──►│Prompt   │─►│React    │
  └─────┘    └─────────┘   └─────────┘   └─────────┘   └────────┘   └─────────┘  └─────────┘
     │            │             │             │             │             │            │
     ▼            ▼             ▼             ▼             ▼             ▼            ▼
 Structure   Discovery     BRD.md        FRD.md       Approval     Dev Prompt    FrdDocPage
 Validate    (40+ Q)       Process       Use Cases     Gate        Autonomous    .tsx
 Context7                  Rules         Wireframes    ↓ NOK                     i18n
                                                       → ANALYSE
                                                       (revise)

             [OPUS]       [SONNET]      [SONNET]                   [OPUS]       [SONNET]

════════════════════════════════════════════════════════════════════════════════
```

---

## STRUCTURE HIÉRARCHIQUE (Alignée navigation)

```
business/                          # Contexte (SEUL autorisé)
├── {application}/                 # Ex: crm, support, billing
│   ├── context.md                 # Description application
│   └── {module}/                  # Ex: tickets, customers, invoices
│       ├── context.md             # Description module
│       └── {section}/             # Ex: settings, reports (optionnel)
│           └── features/
│               └── FEAT-XXX-name/
│                   ├── 1-discovery.md
│                   ├── 2-brd.md
│                   ├── 3-frd.md
│                   ├── 4-handoff.md
│                   └── validation.json
```

---

## OUTPUT HTML - DESTINATION

| Type | Chemin | Exemple |
|------|--------|---------|
| FRD Module | `web/.../pages/docs/business/{app}/{module}/FrdPage.tsx` | `docs/business/support/tickets/FrdPage.tsx` |
| i18n | `web/.../i18n/locales/{lang}/docs-business.json` | FR, EN, IT, DE obligatoires |
| Index | `web/.../pages/docs/business/{app}/index.tsx` | Index application |

---

## STRATÉGIE MODÈLES (Qualité optimale)

| Phase | Modèle | Raison | Coût estimé |
|-------|--------|--------|-------------|
| 1-init | **Haiku** | Setup structure, pas de décision | ~$0.02 |
| 2-discover | **Opus** | Elicitation exhaustive, ULTRATHINK | ~$0.30 |
| 3-analyse | **Sonnet** | Modélisation, règles métier | ~$0.15 |
| 4-specify | **Sonnet** | FRD complet, use cases | ~$0.18 |
| 5-validate | **Haiku** | Gate approbation, oui/non | ~$0.01 |
| 6-handoff | **Opus** | Prompt one-shot, zéro ambiguïté | ~$0.35 |
| 7-doc-html | **Sonnet** | Génération React + i18n + Context7 | ~$0.20 |
| **Total** | | | **~$1.21** |

---

## RÈGLES ABSOLUES

1. **Contexte BUSINESS uniquement** - Refuser platform/personal/system
2. **JAMAIS de code dans les specs** - Tables, diagrammes textuels, pas de C#/JS
3. **Context7 pour génération React** - Toujours utiliser pour code frontend
4. **4 langues obligatoires** - FR, EN, IT, DE dans i18n
5. **Permission path aligné** - `business.{app}.{module}.{action}`
6. **Validation Phase 5 obligatoire** - Avant handoff

---

## UTILISATION CONTEXT7 (OBLIGATOIRE pour code)

```
╔══════════════════════════════════════════════════════════════════════════════╗
║  CONTEXT7: Documentation à jour pour génération de code                      ║
╠══════════════════════════════════════════════════════════════════════════════╣
║                                                                              ║
║  QUAND utiliser Context7:                                                    ║
║  • Phase 7 (doc-html): Génération composants React                           ║
║  • Templates React: Patterns actuels React 19                                ║
║  • i18n: API react-i18next                                                   ║
║  • Routing: React Router v7                                                  ║
║                                                                              ║
║  COMMENT utiliser:                                                           ║
║  • Ajouter "use context7" dans les prompts de génération                     ║
║  • Ou utiliser library ID: "/facebook/react", "/i18next/react-i18next"       ║
║                                                                              ║
║  EXEMPLE prompt phase 7:                                                     ║
║  "use context7 with /facebook/react to generate a FRD documentation          ║
║   page component following SmartStack patterns"                              ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝
```

---

## COMMANDES DISPONIBLES

| Phase | Commande | Description |
|-------|----------|-------------|
| 1 | `/business-analyse:1-init` | Initialiser structure + valider contexte |
| 2 | `/business-analyse:2-discover` | Elicitation besoins (ULTRATHINK) |
| 3 | `/business-analyse:3-analyse` | Analyse métier BRD |
| 4 | `/business-analyse:4-specify` | Spécifications FRD |
| 5 | `/business-analyse:5-validate` | Gate validation utilisateur |
| 6 | `/business-analyse:6-handoff` | Prompt développement |
| 7 | `/business-analyse:7-doc-html` | Génération documentation React |
| + | `/business-analyse:bug` | Documentation bug |
| ⚡ | `/business-analyse:hotfix` | Fix urgent léger |
| 🔄 | `/business-analyse:change-request` | Changement post-handoff |

---

## FICHIERS RÉFÉRENCE

- **Templates FRD:** [templates-frd.md](templates-frd.md)
- **Templates React:** [templates-react.md](templates-react.md)
- **Questionnaire élicitation:** [questionnaire.md](questionnaire.md)
- **Commande complète:** `.claude/commands/business-analyse.md`

---

## SUPPORT

> **Questions sur la Business Analyse SmartStack?**
>
> 📧 **support@atlshub.ch**
