Chaque projet accumule des centaines de choix : pourquoi cette base et pas une autre, pourquoi ce format d’API, pourquoi ce compromis de performance. Sans trace, ces choix deviennent des mystères que l’équipe suivante paiera au prix fort.
Notre outil est volontairement modeste. Un court document par décision — contexte, options écartées, raison du choix, conséquences connues. Deux pages maximum, daté, signé. Pas de bureaucratie : quinze minutes d’écriture au moment de la décision.
Les effets sont immédiats. Les nouvelles recrues comprennent le produit en jours et non en semaines. Les changements d’équipe ou de prestataire cessent d’être des sauts dans le vide. Et vous — client — n’êtes plus dépendant de qui que ce soit, y compris de nous.
La documentation vieillit comme le code. Une décision dépassée est marquée comme telle et liée à celle qui la remplace. On ne réécrit pas l’histoire, on écrit la suite.
C’est une discipline discrète, mais c’est elle qui transforme un produit fragile en produit transmissible.
