# Workflows formation-hub

Orchestration des agents specialises (`bridge-dev`, `bridge-tester`, `acadenice-devops`, `docmost-fork-dev`) pour realiser les operations recurrentes du projet.

## Comment lire ces workflows

Chaque workflow `<nom>.md` decrit :
- **Trigger** : evenement qui declenche le workflow
- **Sequence** : etapes ordonnees avec acteur (agent ou humain) + output attendu
- **Gates** : points de validation humaine bloquants
- **Rollback** : scenarios d'echec + actions
- **Outputs** : artefacts produits

## Comment les declencher

**Manuellement** : tu me dis "lance WF BUILD pour story S-XX" et j'invoque les agents en sequence selon le workflow.

**Idealement (futur)** : creer ces workflows aussi dans BYAN web (`byan-bmb-workflow-builder`) pour avoir l'orchestration native + tracking runs. Pas encore fait — workflows actuels sont des **playbooks markdown**.

## Workflows disponibles

| Workflow | Trigger | Duree typique |
|----------|---------|---------------|
| [`build-story.md`](./build-story.md) | Nouvelle story Phase 2 a livrer | 1-3 jours |
| [`sync-bidirec.md`](./sync-bidirec.md) | Webhook Baserow OU action Docmost custom | < 5s par event |
| [`release.md`](./release.md) | Tag semver `v*` | 30 min + 30 min watch |
| [`incident.md`](./incident.md) | Alerte SEV1/2/3 detectee | depend severite |
| [`bump-deps.md`](./bump-deps.md) | Dependabot PR ou bump manuel | 1-2h |

## Principes communs a tous les workflows

- **Gates humains explicites** : un agent ne peut pas merger en main sans approbation Corentin (ou Yan)
- **Reproductibilite** : chaque workflow est testable en staging avant prod
- **Logs traces** : chaque etape loggue son output (qui a fait quoi, quand, resultat)
- **Idempotence** : re-running un workflow = pas de side effect indesirable
- **Rollback documente** : si etape N echoue, le workflow indique comment revenir

## Integration avec BYAN web

A terme, ces workflows pourront etre crees dans BYAN web :
- `byan-bmb-workflow-builder` skill pour les modeliser
- Workflow runs traces dans `byan_api_workflow_runs`
- Trigger via `byan_api_workflows_run` ou MCP

Pour l'instant, c'est moi (Claude main) qui orchestre via Agent tool sequentiel.

## Conventions agents communes

Tous les agents respectent :
- **Tao Acadenice** : direct, structures avec tirets, zero emoji, orientation solution
- **Conventions commits** : `type(scope): description` (feat/fix/docs/refactor/test/chore/ops/sec)
- **Branches courtes** : max 3j de vie
- **Code prod-like** : tests + lint + types + security gates
- **Pas de modif docs conception** sans ADR explicite