# Qu’est-ce qu’un enregistrement de décision d’architecture (ADR) ?

Un enregistrement de décision d’architecture (ADR) est un court document qui consigne une décision technique importante : son contexte, le choix fait et ses conséquences.

Mis à jour le 22 octobre 2026.

## Comment ça marche

Michael Nygard a proposé le format en 2011 : un titre, un statut, le contexte, la décision et ses conséquences, numérotés dans l’ordre. Un ADR n’est pas réécrit quand on change d’avis : un nouveau le remplace.

L’ensemble devient la mémoire du projet. Un nouvel ingénieur lit pourquoi le système est ainsi, et personne ne rouvre une question tranchée sans avoir les raisons sous les yeux.

## Un exemple

L’ADR 14 consigne le choix de PostgreSQL plutôt qu’une base orientée documents : les données sont relationnelles, l’équipe connaît SQL et les rapports ont besoin de jointures. Deux ans plus tard, l’ADR 31 en remplace une partie pour la recherche, et y renvoie.

## Erreurs courantes

- Consigner les décisions longtemps après, sans le contexte qui était sur la table.
- Réécrire un ancien ADR au lieu de le remplacer.
- Ranger les ADR là où ceux qui en ont besoin ne regardent jamais.

## Dans Nodary

Nodary propose un modèle d’ADR intégré. Une décision peut être marquée remplacée par l’enregistrement qui la suit, des liens disent de quoi elle dépend, et l’historique du document garde ses versions récentes à comparer et à restaurer.

**Ce que Nodary ne fait pas :** il ne garde pas les ADR dans votre dépôt de code : exportez-les en Markdown s’ils doivent vivre à côté du code.

- [Exporter depuis Nodary](https://nodary.ai/fr/docs/export)
- [Modèle de journal des décisions avec ADR](https://nodary.ai/fr/templates/decision-log)

Essayez sur vos propres documents. L’offre Free ne demande pas de carte. [Créer un espace gratuit](https://nodary.ai/sign-up)

## Sources

- [Documenting Architecture Decisions, Michael Nygard, Cognitect, 2011](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions)
- [Architectural Decision Records, adr.github.io](https://adr.github.io/)
- [Maintain an architecture decision record, Microsoft Azure Well-Architected Framework](https://learn.microsoft.com/en-us/azure/well-architected/architect-role/architecture-decision-record)

## Termes liés

- [Journal des décisions](https://nodary.ai/fr/glossary/decision-log): Un journal des décisions est un registre continu des décisions d’une équipe, chacune avec sa date, qui a décidé, pourquoi et les options écartées.
- [Document d’exigences produit (PRD)](https://nodary.ai/fr/glossary/product-requirements-document): Un document d’exigences produit (PRD) dit ce qu’un produit ou une fonction doit faire et pourquoi : problème, utilisateurs, objectifs, exigences et périmètre.
- [Document canon](https://nodary.ai/fr/glossary/canon-document): Un document canon est la version qu’une équipe a reconnue comme vraie : quand des documents se contredisent, c’est lui qui tranche et les autres s’y rangent.

https://nodary.ai/fr/glossary/architecture-decision-record