# Pipeline Business Analyse — 23 skills Business Analysis pipeline — 23 skills

SmartStack v5 introduit un pipeline d'analyse métier complet, basé sur des fichiers markdown sous `.smartstack/ba/`. Aucune base de données, aucune dépendance MCP, aucun envelope JSON : tout est lisible, diff-able et committable. SmartStack v5 ships a complete business analysis pipeline backed by markdown files under `.smartstack/ba/`. No database, no MCP dependency, no JSON envelopes: everything is readable, diff-able and committable.

## Pipeline en un coup d'œil Pipeline at a glance

8 phases séquentielles (7 phases métier + 1 synthèse PRD). Chaque phase a son audit dédié qui doit passer avant la suivante ; l'audit final `/ba-audit-prd` émet le verdict GO / NO-GO qui débloque (ou bloque) `/ba-develop`. 8 sequential phases (7 business phases + 1 PRD synthesis). Each phase has its dedicated audit that must pass before the next one; the final `/ba-audit-prd` audit emits the GO / NO-GO verdict that unblocks (or blocks) `/ba-develop`.

## Modèle de fichiers File model

Tout le pipeline écrit sous `.smartstack/ba/`. Chaque niveau de la hiérarchie a un fichier autoritaire dédié : The whole pipeline writes under `.smartstack/ba/`. Each level of the hierarchy owns a dedicated authoritative file:

Niveau Level | Chemin type Typical path | Fichiers Files
--- | --- | ---
Projet Project | `.smartstack/ba/` | racine, audits transverses root, cross-cutting audits
Application Application | `.smartstack/ba/<APP>/` | `index.md`, `acteur.md`
Module Module | `.smartstack/ba/<APP>/<MODULE>/` | `index.md`, `entité.md`, `rbac.md`, `prd.md`
Section Section | `.smartstack/ba/<APP>/<MODULE>/<SECTION>/` | `index.md`, `use-case.md`, `règles-métier.md`, `screen.md`

## Phases du pipeline Pipeline phases

Chaque phase « define / generate » est immédiatement vérifiable par son audit dédié — la colonne de droite. L'audit écrit un verdict sous `_audit/<dimension>.md` que vous relisez avant de passer à la phase suivante. Each define/generate phase is immediately verifiable through its dedicated audit — the right-hand column. The audit writes a verdict under `_audit/<dimension>.md` that you review before moving to the next phase.

Phase | Skill | Écrit Writes | Audit Audit
--- | --- | --- | ---
1 — Menu Menu | `/ba-create-menu` | arbre `index.md` `index.md` tree | `/ba-audit-menu` + `/ba-audit-sections`
2 — Acteurs Actors | `/ba-create-actors` | `acteur.md` | `/ba-audit-actors`
3 — Cas d'usage Use cases | `/ba-create-use-case` | `use-case.md` | `/ba-audit-use-cases`
4 — Règles métier Business rules | `/ba-create-business-rules` | `règles-métier.md` | `/ba-audit-rules`
5 — RBAC | `/ba-create-rbac` | `rbac.md` | `/ba-audit-rbac`
6 — Modèle de données Data model | `/ba-create-data-model` | `entité.md` | `/ba-audit-data-model` + `/ba-audit-cross-ref-code`
7 — Écrans Screens | `/ba-create-screen` | `screen.md` (actions CRUD + custom)(CRUD + custom actions) | `/ba-audit-screens` (SCR-001..013, dont SCR-011..013 sur les actions custom)(SCR-001..013, incl. SCR-011..013 for custom actions)
Synthèse Synthesis | `/ba-create-prd` | `prd.md` + 3 slices + `pagespecs/*.md` | `/ba-audit-prd` (70 checks, porte GO/NO-GO ; dont PRD-095..101 sur le contrat custom-action)(70 checks, GO/NO-GO gate; incl. PRD-095..101 for the custom-action contract)

## Actions custom — comment les déclarer Custom actions — how to declare them

À côté des actions CRUD standard (create / read / list / edit / delete), un écran peut exposer des actions custom métier — un bouton « Synchroniser depuis PCE », un bouton « Ouvrir l'historique ». La déclaration se fait dans `screen.md` sous forme de bullet structurée : Alongside standard CRUD actions (create / read / list / edit / delete), a screen can expose custom business actions — a "Sync from PCE" button, an "Open history" button. The declaration is a structured bullet in `screen.md`:

    - **Actions personnalisées** :
      - `syncFromPce` — kind: api, scope: header, endpoint: sync-from-proconcept,
        httpMethod: POST, permission: referentiels.types-affaire.execute,
        UC: UC-GAF-REF-TYPEAFFAIRE-007, label: « Synchroniser depuis PCE »
      - `openHistory` — kind: navigate, scope: row,
        targetScreen: SCR-GAF-HIST-001, permission: referentiels.types-affaire.read,
        label: « Ouvrir l'historique »

Deux discriminateurs `kind` : Two `kind` discriminators:

`kind` | Sémantique métier Business semantics | Champs requis Required fields
--- | --- | ---
`api` | Action qui déclenche une opération côté serveur (lecture, écriture, calcul…)Action triggering a server-side operation (read, write, computation…) | `endpoint`, `httpMethod`, `permission`, `UC`
`navigate` | Action qui ouvre un autre écran (navigation pure, pas d'appel serveur)Action opening another screen (pure navigation, no server call) | `targetScreen`, `permission`

Le champ `endpoint` est traité comme la source de vérité par le pipeline en aval — la déclaration BA est ainsi le seul endroit à modifier quand on renomme l'action. The `endpoint` field is treated as the source of truth by the downstream pipeline — the BA declaration is the single place to edit when an action is renamed.

Les audits BA `/ba-audit-screens` (SCR-011..013) et `/ba-audit-prd` (PRD-095..101) vérifient que la déclaration est complète, que l'`endpoint` est unique par entité, que le `targetScreen` est résoluble et que le contrat Zod est valide. The BA audits `/ba-audit-screens` (SCR-011..013) and `/ba-audit-prd` (PRD-095..101) verify that the declaration is complete, the `endpoint` is unique per entity, the `targetScreen` is resolvable, and the Zod contract is valid.

## Audits transverses Cross-cutting audits

Au-delà des audits par phase ci-dessus, deux audits vérifient la cohérence globale : Beyond the per-phase audits above, two audits verify the overall coherence:

- `/ba-audit-cross-dimension` — cohérence inter-dimensions (un champ d'état est-il bien couvert par une règle, un UC et un écran ?)cross-dimension coherence (is a state field properly covered by a rule, a UC and a screen?)
- `/ba-audit-pre-dev` — orchestrateur lecture-seule : agrège tous les verdicts `_audit/.md` et émet un GO/NO-GO projet read-only orchestrator: aggregates every `_audit/.md` verdict and emits a project-level GO/NO-GO

## Modélisation rapide (optionnel)Fast modelling (optional)

Pour les modules grands, le passage en deux étapes accélère l'inventaire : For large modules, the two-pass approach speeds up the inventory:

- `/ba-modeling-inventory` — pass 1 : listing rapide de tous les UC + règles avec un flag simple/moderate/complex pass 1: fast listing of all UCs + rules tagged simple/moderate/complex
- `/ba-modeling-detail` — pass 2 : expansion d'un item pass 2: expand a single item

Quand la phase de synthèse a écrit le PRD et que l'audit a renvoyé GO, l'analyse métier est terminée. Le passage au code se fait via `/ba-develop`, documenté sur sa page dédiée. When the synthesis phase has written the PRD and the audit returned GO, business analysis is done. Hand-off to code is documented on the dedicated `/ba-develop` page.

L'annuaire des 23 skills BA (avec leur fiche détaillée) est sur la page Skills BA dans l'Annuaire. The directory of the 23 BA skills (with their full cards) lives on the BA Skills page in the Directory.