1.8 KiB
0001. Consigner les décisions dans des ADR
- Statut : accepté
- Date : 2026-11-02
- Décideurs : Pierre
Contexte
Les premières décisions du projet étaient consignées dans un fichier unique,
docs/decisions.md, à côté des plans et de la feuille de route. Or ces
documents n'ont pas la même durée de vie : un plan ou une ligne de feuille de
route est temporaire et disparaît une fois réalisé, alors qu'une décision doit
rester lisible tant qu'elle s'applique, et même après, pour comprendre
l'historique. Les mélanger rend les choix plus difficiles à retrouver et à
remettre en cause proprement.
Décision
Chaque décision structurante fait l'objet d'un ADR (Architecture Decision
Record) : un fichier docs/adr/NNNN-titre-court.md, numéroté dans l'ordre, au
format de docs/adr/modele.md. Un ADR accepté n'est plus réécrit : une
décision qui change donne un nouvel ADR, et l'ancien passe au statut
« remplacé par NNNN ». L'index docs/adr/README.md liste tous les ADR.
Les plans (docs/plans/) et la feuille de route ne contiennent que le travail
à faire ; un plan réalisé est supprimé, et ce qu'il contenait de durable passe
dans un ADR, dans la description de la merge request ou dans le journal.
docs/decisions.md est supprimé ; ses entrées deviennent les ADR 0002 à 0006.
Alternatives écartées
- Garder
docs/decisions.md: un seul fichier qui grossit, où l'on ne distingue pas une décision en vigueur d'une décision remplacée. - Ne garder la trace que dans les merge requests : elle existe déjà là, mais hors du dépôt, sur un serveur qui peut changer.
Conséquences
make testvérifie la forme des ADR (numérotation, statut, sections, index).- Les ADR 0002 à 0006 reprennent des décisions antérieures à celui-ci, avec leur date d'origine.