Gouvernance
Les modèles et les fournisseurs changent tous les quelques mois, et la raison d'un choix disparaît avant le code. Un court registre par décision la conserve.
5 nov. 2026 · 4 min de lecture
Le schéma et les sources sont en anglais.
Six mois après le début d'un projet d'agents, quelqu'un demande pourquoi les tâches de soutien vont à un modèle de gamme moyenne, ou pourquoi les approbations se trouvent dans la passerelle d'outils et non dans l'agent. Le code montre ce qui a été construit. Il ne montre pas ce qui a été envisagé. C'est le vide que comble un registre de décision d'architecture, ou ADR.
Michael Nygard a proposé ce format en 2011 : un court document par décision importante, avec un titre, un statut, le contexte, la décision et ses conséquences. Les registres sont numérotés en séquence, et un numéro n'est jamais réutilisé.
Si une décision est renversée, conservez l'ancien registre et marquez-le comme remplacé, avec un renvoi vers son remplaçant. Les solutions écartées sont souvent la partie la plus utile pour un lecteur futur, car elles évitent à l'équipe de refaire le même débat.
Exemple inventé à titre d'illustration : ADR-007, Acheminer la classification vers un petit modèle. Statut : accepté. Contexte : la classification domine le volume et n'exige pas de raisonnement poussé. Décision : nous enverrons la classification au plus petit niveau et escaladerons lorsque la confiance est faible. Solutions écartées : un seul grand modèle pour tout, en raison du coût. Conséquences : nous devons maintenir un jeu d'évaluation pour détecter les régressions lorsque le petit modèle change.
Parlez-nous d'un processus. Nous vous montrerons comment un agent pourrait le prendre en charge et quoi mesurer pour savoir qu'il fonctionne.