Alias
ADR, relevé de décision d'architecture.
Définition
Un ADR explique pourquoi un choix significatif a été retenu. Il permet de comprendre les contraintes et compromis sans reconstruire la discussion depuis les messages de l'équipe.
Lorsqu'un choix est remplacé, conserver l'ancien ADR et le relier au nouveau rend l'évolution intelligible.
Exemple
Exemple pédagogique : pour transmettre des commandes à l'ERP, l'équipe retient une file de messages afin de les conserver quand l'ERP est indisponible. L'ADR consigne les options écartées, le choix validé et ses conséquences : transmission différée, surveillance de la file et traitement des messages en échec.
À ne pas confondre avec
Un brouillon d'ADR préparé par une IA n'est pas une validation d'architecture. Un schéma seul décrit rarement les raisons du choix.
Voir aussi
Revue de code, Dette technique, Traçabilité IA.
Sources
Michael Nygard — Documenting Architecture Decisions (nouvel onglet). Application au travail de projet et exemple pédagogique originaux, sans résultat d'essai revendiqué.