Pipeline Business Analyse — 23 skillsBusiness 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'œilPipeline 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.

create / define audit writes 1 · Menu /ba-create-menu MENU-001..005 · SEC-001..006 · XAPP-001..003 /ba-audit-menu + /ba-audit-sections index.md tree App / Module / Section / Resource 2 · Actors /ba-create-actors ACT-001..006 /ba-audit-actors <APP>/acteur.md 3 · Use cases /ba-create-use-case UC-001..012 /ba-audit-use-cases <SECTION>/use-case.md 4 · Business rules /ba-create-business-rules BR-001..010 /ba-audit-rules règles-métier.md 5 · RBAC /ba-create-rbac RBAC-001..005 /ba-audit-rbac <MODULE>/rbac.md 6 · Data model /ba-create-data-model DM-001..017 · CODE-001..004 /ba-audit-data-model + cross-ref-code <MODULE>/entité.md 7 · Screens /ba-create-screen SCR-001..013 (incl. custom actions) /ba-audit-screens <SECTION>/screen.md Synthesis · PRD /ba-create-prd reads phases 1..7 PRD-001..101 · 70 checks across 7 dimensions /ba-audit-prd → GO / NO-GO gate prd.md + 3 slices pagespecs/*.md claude.md /ba-develop → code généré unblocked only if PRD audit returns GO (score ≥ 80)

Modèle de fichiersFile 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:

NiveauLevel Chemin typeTypical path FichiersFiles
ProjetProject .smartstack/ba/ racine, audits transversesroot, cross-cutting audits
ApplicationApplication .smartstack/ba/<APP>/ index.md, acteur.md
ModuleModule .smartstack/ba/<APP>/<MODULE>/ index.md, entité.md, rbac.md, prd.md
SectionSection .smartstack/ba/<APP>/<MODULE>/<SECTION>/ index.md, use-case.md, règles-métier.md, screen.md
Authoritative files by hierarchy level Every audit reads its level's file + the files of the levels above (e.g. screen audit reads section + module + app). 📁 .smartstack/ba/ Project — cross-cutting _audit/menu.md · sections.md · cross-dimension.md · pre-dev.md 📁 <APP>/ Application — actors live here index.md · acteur.md 📁 <MODULE>/ Module — data model + RBAC + PRD index.md · entité.md · rbac.md · prd.md (+ 3 slices) 📁 pagespecs/ Machine-readable per-screen contracts <ScreenCode>.md (one per screen, fenced JSON) 📁 _audit/ Module-level audit verdicts (one .md per dimension) entité.md · rbac.md · prd.md · cross-ref-code.md 📁 <SECTION>/ Section — UCs + rules + screens index.md · use-case.md · règles-métier.md · screen.md 📁 _audit/ Section-level audit verdicts use-case.md · règles-métier.md · screen.md Folder Authoritative file (written by a phase) Audit verdict (written by an audit, read by the next phase)

Phases du pipelinePipeline 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 ÉcritWrites AuditAudit
1 — MenuMenu /ba-create-menu arbre index.mdindex.md tree /ba-audit-menu + /ba-audit-sections
2 — ActeursActors /ba-create-actors acteur.md /ba-audit-actors
3 — Cas d'usageUse cases /ba-create-use-case use-case.md /ba-audit-use-cases
4 — Règles métierBusiness 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éesData model /ba-create-data-model entité.md /ba-audit-data-model + /ba-audit-cross-ref-code
7 — ÉcransScreens /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èseSynthesis /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éclarerCustom 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étierBusiness semantics Champs requisRequired 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 transversesCross-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 projetread-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/complexpass 1: fast listing of all UCs + rules tagged simple/moderate/complex
  • /ba-modeling-detail — pass 2 : expansion d'un itempass 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.