ADR

Un ADR est un Architecture Decision Record.

C’est une trace courte d’une décision d’architecture : le contexte, le choix retenu, et les conséquences connues au moment de décider.

Un bon ADR garde la mémoire d’une bifurcation importante sans raconter toute la vie du projet.

Dans l’atelier

Quand une équipe travaille avec l’IA, les décisions peuvent naître dans une conversation avec un assistant. Sans trace, elles disparaissent vite.

L’ADR remet la décision dans la mémoire collective.

Exemple

“Nous utilisons PostgreSQL plutôt qu’un stockage documentaire pour cette fonctionnalité, car les requêtes relationnelles sont centrales et l’équipe maîtrise déjà l’exploitation PostgreSQL.”

Court. Utile. Reprenable.

Piège classique

Écrire un roman.

Un ADR doit rester lisible. Si personne ne le relit, il finit comme une planche rangée derrière l’armoire : techniquement présente, pratiquement perdue.

À retenir

L’ADR évite que les choix importants vivent seulement dans la tête des gens.