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
54 lines
2.5 KiB
Markdown
54 lines
2.5 KiB
Markdown
# 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
|