Workflow
Un workflow est le contrat dans lequel travaille votre agent : les statuts qu’une task peut porter, les transitions gardées entre eux, et le playbook qui indique à l’agent quoi faire à chaque étape.
Statuts
Chaque task parcourt un ensemble ordonné de statuts. Le premier est là où atterrit le travail neuf ; le statut terminal boucle la boucle.
| Statut | Catégorie | Signification |
|---|---|---|
| À faire | todo | Récupérée, pas démarrée. Le statut initial. |
| En cours | in_progress | L’agent travaille — branche attachée, commits qui tombent. |
| En revue | in_review | Une PR est ouverte et attend une relecture humaine. |
| Bloqué | blocked | Arrêtée sur une dépendance. Une raison est requise. |
| Terminé | done | Validée et close. Terminal. |
Transitions gardées
Les transitions décident quels mouvements sont légaux, et certaines portent une garde — une condition que l’agent doit satisfaire avant que le mouvement soit permis. C’est la couture du contrôle humain : rien ne passe en revue sans change request, ni en bloqué sans raison énoncée.
| De → Vers | Garde |
|---|---|
in_progress → in_review | Exige un artefact change_request |
in_progress → blocked | Exige une raison |
in_review → done | Décision humaine à la porte de validation |
in_review → in_progress | Renvoyée pour corrections |
Le playbook
Le playbook est le runbook de l’agent. Chaque entrée se déclenche sur une étape et liste les gestes exacts à faire — pour que l’agent reflète le travail dans CodBoard au moment où il arrive, pas en lot à la fin. Ce sont des conventions que vous ajustez par projet : « une PR par task », par exemple, est un défaut du playbook, pas une transition gardée.
sur request.created : → découper le ticket en tasks par couche · une PR par tasksur task.started : → créer la branche {type}/{slug}, l’attacher, passer en in_progresssur task.finished : → ouvrir la PR, passer en in_review, régénérer le rapport du jour
Statuts, transitions et playbook se configurent dans CodBoard, pas dans votre dépôt. L’agent les charge avec get_workflow au démarrage de la session et les suit à la lettre.