Corentin JOGUET
460f7effe0
Some checks are pending
CI / Lint bridge (Biome) (push) Waiting to run
CI / Type-check bridge (push) Blocked by required conditions
CI / Tests unit bridge (push) Blocked by required conditions
CI / Tests integration bridge (push) Blocked by required conditions
CI / Security scan (push) Waiting to run
CI / Docker build + healthcheck (push) Blocked by required conditions
Workflows (playbooks markdown) pour orchestrer les 4 agents specialises : - README.md : index + conventions communes + integration BYAN web futur - build-story.md : cycle complet livrer 1 story Phase 2 (bridge-dev → bridge-tester → review → CI → deploy staging → validation metier) - sync-bidirec.md : sync Docmost ↔ Baserow event-driven (idempotence + anti-loop X-Bridge-Origin) - release.md : process release semver (E2E staging → tag → approval → deploy prod → watch 30min) - incident.md : SEV1/2/3 response + post-mortem blameless + runbooks - bump-deps.md : Dependabot PRs + major bumps + Docmost/Baserow upstream Chaque workflow specifie : trigger, acteurs (agents + humains), sequence ordonnee avec outputs, gates humains bloquants, rollback, comm templates. Workflows = playbooks declaratifs pour Claude main qui orchestre les agents via Agent tool sequentiel. A migrer plus tard vers BYAN web workflow runs quand le runtime BYAN sera fix. Equipe complete pour formation-hub : - 4 agents specialises (bridge-dev, bridge-tester, acadenice-devops, docmost-fork-dev) - 5 workflows orchestrant leur collaboration
2.5 KiB
2.5 KiB
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 |
Nouvelle story Phase 2 a livrer | 1-3 jours |
sync-bidirec.md |
Webhook Baserow OU action Docmost custom | < 5s par event |
release.md |
Tag semver v* |
30 min + 30 min watch |
incident.md |
Alerte SEV1/2/3 detectee | depend severite |
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-builderskill pour les modeliser- Workflow runs traces dans
byan_api_workflow_runs - Trigger via
byan_api_workflows_runou 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