L’Architecture Decision Record (ADR) est un journal de décisions prises par l’équipe. L’objectif est de tracer les décisions validées ou rejetées, le contexte de la décision et les options écartées.
L’objectif
Contexte :
- s’assure que tout le monde comprend le problème de la même façon
- Se souvenir des conditions de prise de décision Options, Avantages et Inconvénients :
- Tracer toutes les idées pour ne pas en oublier
- Eviter les mêmes conversations en boucle
- Dans le futur, voir les pistes envisagées et pouvoir proposer d’autres solutions non évoquées. La décision et les critères :
- une vision similaire pour tout le monde sur la décision
- Permet d’avoir les critères déterminant de la décision
- Trace le pourquoi Les conseils :
- Trace les conditions qui n’ont pas d’importance aujourd’hui mais qui peuvent avoir un impact.
- Envisager les limitations futures sur la solution choisie Les conséquences :
- Quels sont les actions à prendre
Exemple de template
# ADR TEMPLATE
- 📅 Date :
- 👷 Décision prise par :
- 🏁 Statut :
# Contexte
<--Quel est le contexte de votre décision. Exemple : ADR précédent, problème auquel l'équipe veut s'attaquer, ...-->.
# Options envisagées 💡
1. Option 1 :
- **Plus de détails :**
- ✅ **Avantages :**
- 🚫 **Inconvénients :**
2. Option 2 :
- **Plus de détails :**
- ✅ **Avantages :**
- 🚫 **Inconvénients :**
# Conseils
<--Tous les conseils que l'on vous a donnés -->
# Décision 🏆
<--Quelles décisions ont été prises et quels étaient les critères-->
# Conséquences
<--Conséquences de votre décision-->
♻️ Mise à jour : <date>.sources :