Un journal de décisions (decision log) est le registre qui garde, pour chaque choix produit, pourquoi on a décidé ainsi. Des mois plus tard, quand quelqu'un rouvre le même débat, avoir le contexte, les options et les arbitrages sous la main le tranche en une minute. Le hic : la plupart des journaux pourrissent — écrits une fois, jamais relus, périmés en silence. Voici comment le tenir, et le garder vivant.
Ce format rejoint l'ADR (journal de décisions d'architecture). Beaucoup de décisions naissent en réunion, puis nourrissent le PRD — le journal garde la trace du « pourquoi » derrière chacune.
Un journal de décisions en texte plat commence à s'écarter du réel dès que vous l'écrivez. Une décision plus récente en renverse une ancienne, et le document reste sur la vieille. Chez Draftlize, les décisions sont des « cartes vivantes ».
Une décision = une carte, avec son contexte, ses options, sa justification et son responsable, référencée par ID. Au lieu de se perdre dans un document, elle reste pointable.
Quand une décision récente en renverse une ancienne, l'ancienne — et les specs qui en dépendent — passent automatiquement en « stale ». On ne re-débat pas ce qui est tranché.
Le journal devient un contexte que Claude Code ou Cursor lisent via MCP. L'agent rédige la suite en sachant « pourquoi » on a décidé ainsi.
La plupart des journaux de décisions ne sont plus lus dès le lendemain. Alors six mois plus tard, le même débat repart de zéro.Gardez chaque décision avec son contexte, et signalez ce qu'elle impacte quand elle change. C'est Draftlize.
Le compte rendu est « le relevé de la réunion » ; le journal de décisions est « le registre des décisions ». Extraire seulement les décisions du CR et les accumuler, c'est ce qui sert vraiment ensuite.
En général la personne responsable de la décision (PM ou lead). L'essentiel est de garder traçable le « pourquoi » de chaque décision.
Il suffit que la décision, le contexte et les arbitrages soient clairs. Plus que la longueur, ce qui compte est de repérer quand une décision devient obsolète.
L'ADR est un type de journal de décisions technique. Draftlize traite les ADR comme les décisions produit en tant que même « carte vivante ».
Faites de chaque décision une carte avec son contexte ; si elle est renversée, elle passe en « stale » toute seule, et votre agent IA la lit. Un journal de décisions vivant, avec Draftlize.
Commencer gratuitement avec 5 $