Ressources · 84
Décisions d’architecture : conserver le raisonnement et savoir réexaminer
Documenter les choix structurants sans transformer chaque réunion en dossier interminable.
· 3 min
Ce que ce guide permet
- Délimiter la décision
- Comparer des options plausibles
- Nommer décision et conséquences
- Préserver le contexte historique
- Définir le réexamen utile
Contrôle express
- Faut-il un ADR pour chaque ticket ?
- Peut-on changer une décision acceptée ?
- Un registre garantit-il un bon choix ?
Méthode pas à pas
- 01
Délimiter la décision
Choisissez une question qui engage durablement le service : hébergement, mode d’intégration, stockage ou séparation d’un composant. Un ADR sert à garder le raisonnement d’un choix d’architecture significatif. Décrivez le problème concret et les contraintes présentes ; ne rédigez pas une justification commerciale après coup.
Livrable : question et périmètre de décision.
- 02
Comparer des options plausibles
Présentez les options réellement examinées, dont conserver l’existant lorsqu’il est viable. Utilisez les mêmes critères : usage, sécurité, exploitation, coûts inclus et sortie. Séparez ce qui a été mesuré, ce qui vient d’une documentation et ce qui demeure une hypothèse.
Livrable : tableau de critères et preuves.
- 03
Nommer décision et conséquences
Notez option retenue, responsable, date et statut. Décrivez les effets acceptés, y compris dette, migration et limites. Une validation ne fait pas disparaître une contrainte connue. Associez le choix aux exigences qu’il satisfait et aux contrôles encore nécessaires.
Livrable : décision acceptée et conséquences explicites.
- 04
Préserver le contexte historique
Une décision remplacée doit rester compréhensible. Reliez-la à son successeur au lieu de réécrire le passé. Le processus ADR distingue notamment propositions, acceptations, rejets et décisions remplacées. Conservez les liens vers les tickets et preuves accessibles à l’équipe.
Livrable : registre avec relations entre versions.
- 05
Définir le réexamen utile
Fixez des conditions concrètes : volume dépassant le périmètre testé, fournisseur indisponible, besoin de localisation ou coût hors hypothèse. Un événement doit déclencher une comparaison mise à jour, pas un abandon automatique. Vérifiez qu’une personne qui reprend le service peut expliquer le choix sans consulter les participants d’origine.
Livrable : conditions de réexamen et test de transmission.
Fiche de travail à réutiliser
À compléter avec vos observations autorisées. Ces champs constituent une trame de travail, pas des résultats observés.
| Champ | Information à consigner |
|---|---|
| Question | Problème, périmètre et contraintes à la date de décision |
| Options | Solutions comparées et critères communs |
| Choix | Statut, responsable, raisons et conséquences |
| Réexamen | Événement déclencheur et lien vers une décision de remplacement |
Exemple d’application
Situation illustrative
Exemple fictif : une équipe choisit un service de recherche géré pour éviter une astreinte qu’elle ne peut pas assurer.
Décision et preuve attendue
Le registre consigne cette contrainte, l’export attendu et un réexamen si le besoin de localisation ou les coûts changent.
Distinguer les mécanismes
| Mécanisme | Utilité | Point de vigilance |
|---|---|---|
| Compte rendu | Garder les échanges d’une réunion | La décision peut être dispersée |
| ADR | Conserver choix, raisons et conséquences | Ne remplace pas spécifications ni tests |
| Ticket de réalisation | Suivre le travail à livrer | Peut se fermer sans conserver le raisonnement |
Indicateurs de pilotage
| Indicateur | Ce qu’il mesure | Première action |
|---|---|---|
| Choix retraçables | Décisions structurantes avec contexte et conséquences accessibles | Traiter les dépendances les plus coûteuses à reprendre |
| Hypothèses vérifiées | Hypothèses décisives confrontées à un essai ou une mesure | Réviser les critères lorsque la preuve manque |
| Transmission | Choix qu’une nouvelle personne peut expliquer | Améliorer le registre plutôt que multiplier les réunions |
Erreurs fréquentes
- La décision peut être dispersée
- Ne remplace pas spécifications ni tests
- Peut se fermer sans conserver le raisonnement
Questions fréquentes
Faut-il un ADR pour chaque ticket ?
Non. Réservez-le aux choix significatifs dont les conséquences ou la réversibilité justifient de garder le raisonnement.
Peut-on changer une décision acceptée ?
Oui. Enregistrez la nouvelle décision, son contexte et son lien vers celle qu’elle remplace, sans effacer les raisons anciennes.
Un registre garantit-il un bon choix ?
Non. Il rend les critères et hypothèses discutables et aide à réexaminer ; la qualité des preuves et des essais reste déterminante.
Lectures et outils complémentaires
Repères éditoriaux pour prolonger la méthode.
- Française du Numérique — cahier des charges web Lien externe
Pour traduire les décisions en périmètre, contraintes et critères de livraison.
Références officielles
Date de consultation des références : . La méthode et la fiche de travail proposent des contrôles à adapter à votre contexte ; elles ne constituent pas une certification.
Pour aller plus loin
Analyses associées
