Skip to content

05 Decider

Harrylepap edited this page Nov 13, 2026 · 1 revision

05. Décider

Une décision qui n'est pas écrite sera reprise.

Pourquoi

Toute équipe technique connaît la scène. Quelqu'un demande pourquoi le service utilise cette base plutôt qu'une autre. Personne ne sait. La personne qui avait tranché est partie. On rouvre le débat, on passe trois réunions à reconstituer des arguments déjà examinés, et parfois on défait une décision qui était juste, faute de connaître la contrainte qui l'avait motivée.

Michael Nygard a proposé en 2011 une réponse d'une simplicité désarmante : consigner chaque décision d'architecture dans un court fichier texte, versionné avec le code. C'est l'ADR, Architecture Decision Record. Rien de plus, et c'est précisément ce qui la rend durable.

En pratique

L'ADR, pour mémoire

Une ADR tient sur une page. Elle contient le contexte, la décision, les options écartées et les conséquences. Modèle.

Quelques règles qui font la différence :

  • Une ADR est immuable. Si la décision change, on écrit une nouvelle ADR qui remplace l'ancienne, et on met à jour le statut de l'ancienne. L'historique du raisonnement reste lisible.
  • Le contexte d'abord, l'opinion ensuite. Les chiffres, les contraintes, les délais. Dans deux ans, c'est le contexte qui dira si la décision tient encore.
  • Les options écartées sont obligatoires. C'est la partie la plus utile et la plus souvent omise. Elle évite de réexaminer une option déjà rejetée, et elle signale laquelle reconsidérer si le contexte évolue.
  • Une condition de révision. « À revoir si le volume dépasse dix millions de lignes » ou « à revoir à la fin du contrat avec le prestataire ». Une décision sans date de péremption devient un dogme.

La RFC, pour délibérer

Quand une décision mérite débat, on commence par une RFC. Elle expose un problème, propose une solution, liste les alternatives, et fixe une date limite pour les commentaires. Modèle.

flowchart LR
  A["Problème identifié"] --> B["RFC en brouillon"]
  B --> C["Relecture ciblée"]
  C --> D["Discussion, date limite"]
  D --> E{"Décision"}
  E -->|acceptée| F["ADR écrite"]
  E -->|rejetée| G["RFC archivée avec ses raisons"]
Loading

Une RFC rejetée n'est pas un échec. Elle conserve les raisons du refus, ce qui évitera de la reproposer à l'identique dans six mois.

Le bon niveau d'effort

Tout ne mérite pas une RFC.

Situation Format
Choix réversible, local à une équipe commentaire dans la demande de fusion
Choix coûteux à défaire, une seule équipe ADR directe
Choix qui touche plusieurs équipes ou un contrat externe RFC, puis ADR
Changement d'organisation ou de processus RFC, puis note publiée

Qui tranche

La RFC éclaire ; elle ne vote pas. La décision revient à la personne qui portera la responsabilité du résultat, et son nom figure dans l'ADR. Le consensus est agréable quand il vient. Mais l'attendre indéfiniment est une manière de ne pas décider, et ne pas décider est aussi une décision, la pire en général, parce que personne ne l'assume.

J'applique une règle tirée de la pratique d'Amazon sur les « portes à double sens » : si la décision est facilement réversible, on la prend vite, à un petit nombre de personnes. Si elle ne l'est pas, on prend le temps.

Où ranger

Dans le dépôt concerné, sous docs/adr/, avec un numéro : 0007-utiliser-une-file-pour-les-notifications.md. Pour les décisions transverses, dans un dépôt d'architecture commun. Jamais dans un wiki séparé du code, où elles vieillissent sans que personne ne s'en aperçoive.

Signaux d'alerte

  • La même question d'architecture revient en réunion tous les trimestres.
  • Les nouveaux arrivants demandent « pourquoi c'est fait comme ça ? » et la réponse est « historique ».
  • Des RFC restent en discussion depuis des mois.
  • Les ADR existent mais personne ne les lit, parce qu'elles font dix pages.

Objections

« On n'a pas le temps d'écrire toutes nos décisions. » Une ADR prend trente minutes. Une décision mal comprise coûte des semaines. Et on n'écrit que les décisions coûteuses à défaire, ce qui en laisse peu.

« Écrire, c'est figer. On préfère rester agiles. » Une ADR ne fige rien : elle se remplace. Ce qu'elle empêche, c'est de changer d'avis sans savoir de quoi on change.

Pour aller plus loin

  • Michael Nygard, « Documenting Architecture Decisions », 2011, sur cognitect.com.
  • adr.github.io, recueil de modèles et d'outils.
  • Le processus RFC du langage Rust, rust-lang/rfcs.
  • Jeff Bezos, lettre aux actionnaires d'Amazon de 2015, sur les décisions de type 1 et de type 2.

Clone this wiki locally