Aller au contenu
Nodary
Commencer gratuitement

Modèle de journal des décisions avec ADR

Un journal des décisions et ses fiches, en six documents liés : le journal qui liste chaque décision avec son statut, la façon dont votre équipe décide, une fiche vierge à copier, et trois fiches d’exemple, dont une remplacée par la suivante. Téléchargez-les en fichiers Markdown : ils s’ouvrent dans n’importe quel éditeur, trouvent leur place dans un dépôt de code, et s’importent dans Nodary sous forme de carte.

Télécharger le modèleOuvrir la démo

6 fichiers Markdown dans un .zip, 8 ko

Gratuit, sans compte, sans e-mail. Utilisez-le, modifiez-le, partagez-le.

Journal des décisionsComment nous décidonsFiche de décision viergeADR-001 Garder les décisions dans ce journalADR-002 Stocker les fichiers envoyés sur le serveur d’applicationADR-003 Stocker les fichiers envoyés dans un stockage objet

Lisez chaque page avant de télécharger

Le journal est la page que tout le monde ouvre : une ligne par décision, reliée à sa fiche. Les fiches suivent le format ADR (architecture decision record) et conviennent à toute décision, technique ou non. Les exemples suivent un même produit d’exemple qui décide où garder les fichiers envoyés.

Documents

Fichier Modèle de journal des décisions/Journal des décisions.md

Journal des décisions

Mode d’emploi : les lignes en italique sont des consignes. Remplacez-les par vos propres mots, puis supprimez-les. Les valeurs entre crochets sont à remplir. Chaque décision a sa fiche, reliée depuis le tableau ci-dessous ; une fiche n’est jamais supprimée, et une décision qui change reçoit une nouvelle fiche qui la remplace.

Décisions

NuméroDécisionStatutDateDécidé parRemplacée par
ADR-001Garder les décisions dans ce journalacceptée[date][noms]
ADR-002Stocker les fichiers envoyés sur le serveur d’applicationremplacée[date][noms]ADR-003
ADR-003Stocker les fichiers envoyés dans un stockage objetacceptée[date][noms]
[ADR-004][Votre prochaine décision][proposée][date][noms]

Statuts

  • ProposéeAcceptéeRejetée
  • AcceptéeRemplacéeObsolète
Comment le statut d’une décision évolueUn diagramme Mermaid dans le fichier : Nodary, GitHub et Obsidian le dessinent.
Mermaid
flowchart LR
  n0["Proposée"]
  n1["Acceptée"]
  n2["Rejetée"]
  n3["Remplacée"]
  n4["Obsolète"]
  n0 --> n1
  n0 --> n2
  n1 --> n3
  n1 --> n4
StatutSens
ProposéeÉcrite et ouverte à la relecture, pas encore décidée
AcceptéeDécidée : l’équipe s’y tient
RejetéeDécidée contre, et gardée pour que personne n’ait à redemander
RemplacéeRemplacée par une décision plus récente, dont elle donne le numéro
ObsolèteNe s’applique plus, et rien ne l’a remplacée

Quand écrire une fiche

  • La décision est difficile à défaire : [une base de données, un fournisseur, une API publique, un prix]
  • Plusieurs options ont été sérieusement envisagées
  • Quelqu’un demandera pourquoi dans six mois
  • Elle change le travail d’une autre équipe

Le reste du journal

Ce modèle est libre d’utilisation, de modification et de partage. Il vient de Nodary, où ces fichiers s’importent sous forme de carte de documents liés.

Télécharger le modèle6 fichiers Markdown dans un .zip, 8 ko

Comment s’en servir

  1. Mettez-vous d’accord sur qui décide

    Remplissez d’abord la page du processus : quelles décisions demandent une fiche, qui propose, qui décide et qui est consulté.

  2. Copiez la fiche pour chaque décision

    Donnez-lui le numéro suivant et le statut proposé. Écrivez le contexte et au moins deux options avant que quiconque écrive la décision.

  3. Décidez, puis listez

    Passez le statut à accepté ou rejeté, avec la date et les décideurs, et ajoutez une ligne au journal. Une décision rejetée reste : elle évite le prochain débat.

  4. Remplacez, ne réécrivez jamais

    Quand une décision change, écrivez une nouvelle fiche qui remplace l’ancienne, et marquez l’ancienne comme remplacée avec le nouveau numéro. L’historique reste lisible.

Importez-le dans Nodary en carte

Nodary est un espace de travail IA où les documents d’une équipe se relient au lieu de s’empiler. Importez le .zip : le journal arrive avec ses fiches rangées sous lui et les liens entre elles conservés. Marquez chaque fiche comme Canon, Exploration, Obsolète ou Remplacé par la fiche qui l’a remplacée : le statut s’affiche sur le document, et les agents IA connectés par MCP sont prévenus avant de lire une fiche remplacée. Quand deux documents se contredisent, Nodary montre les deux passages côte à côte.

  1. Ouvrez la carte d’un projet et choisissez Importer.
  2. Choisissez l’onglet Dossier ou ZIP, puis Choisir un ZIP.
  3. Sélectionnez le fichier téléchargé, vérifiez l’arborescence et importez.

L’offre gratuite compte dix documents par espace de travail, page du projet comprise : les six du modèle laissent la place pour trois fiches de plus. Nodary a aussi un modèle de fiche de décision d’architecture (ADR) d’une page intégré.

Comment les agents IA se connectent à Nodary par MCP
Un document dans Nodary avec une note qui dit ce qui a changé depuis la dernière visite du lecteur et qui l’a changé, et l’historique des versions qui compare cette version à l’actuelle ; le projet d’exemple montré est un jeu.

Tenir un journal des décisions auquel on se fie

Un journal des décisions échoue quand personne n’y écrit, ou quand ce qu’il dit ne correspond plus à ce que fait l’équipe. Ces habitudes évitent les deux.

Une décision par fiche

Une fiche qui règle trois choses est rouverte trois fois. Tenez-vous à une seule décision, avec un seul statut.

Le contexte avant la décision

Écrivez ce qui est vrai aujourd’hui et ce qui contraint le choix avant la décision elle-même. Six mois plus tard, c’est le contexte qui l’explique.

Toujours deux options

Une fiche avec une seule option est une annonce. Nommez les alternatives sérieusement envisagées et pourquoi vous ne les avez pas retenues.

Remplacez, ne réécrivez jamais

Une fiche acceptée ne se modifie jamais pour dire autre chose. Une nouvelle fiche la remplace et les deux restent : le journal raconte la vraie histoire.

Dites qui a décidé

Chaque fiche nomme ses décideurs et sa date. Une décision sans nom n’a personne à qui demander, ni personne pour la changer.

Liez ce qu’elle change

Liez chaque fiche aux documents qu’elle change, et ces documents à elle. Un lecteur du design trouve alors la raison en un clic.

Questions sur le journal des décisions

Qu’est-ce qu’un journal des décisions ?

Un journal des décisions est la liste tenue à jour des décisions importantes d’une équipe : ce qui a été décidé, quand, par qui, son statut, et un lien vers la fiche qui l’explique. Il permet à chacun, y compris un nouveau venu ou un agent IA, de savoir pourquoi les choses sont ainsi sans faire le tour des bureaux.

Qu’est-ce qu’un ADR ?

Un ADR (architecture decision record, fiche de décision d’architecture) est un document court pour une décision importante : son contexte, les options envisagées, la décision et ses conséquences, avec un numéro et un statut. Le format vient de l’architecture logicielle et convient à toute décision qu’une équipe veut garder.

Que veut dire « remplacée » ?

Une décision remplacée a été remplacée par une décision plus récente. Elle reste dans le journal, inchangée, avec le numéro de la fiche qui la remplace, et la nouvelle fiche dit laquelle elle remplace. Rien n’est supprimé : l’historique reste vrai.

Quand une équipe doit-elle écrire une fiche de décision ?

Quand une décision est difficile à défaire, quand plusieurs options ont été sérieusement envisagées, quand elle change le travail d’une autre équipe, ou quand quelqu’un demandera sans doute pourquoi dans six mois. Les petits choix réversibles n’en ont pas besoin.

Les fiches doivent-elles vivre avec le code ou avec les documents ?

Les équipes qui ne partagent leurs décisions qu’entre développeurs les gardent souvent dans le dépôt de code. Quand le produit, le design, le support ou des clients doivent les lire aussi, un espace de travail partagé les rend plus faciles à trouver. Les fichiers de ce modèle fonctionnent aux deux endroits.

Puis-je l’utiliser hors de Nodary ?

Oui. Les fichiers sont du Markdown avec des liens relatifs : mettez le dossier dans un dépôt, ouvrez-le comme un coffre dans Obsidian, ou lisez-le sur GitHub, diagramme compris.

À lire ensuite

Gardez chaque décision là où l’équipe travaille.

Importez le modèle dans Nodary et le journal devient une carte qui dit quelles décisions tiennent encore, pour votre équipe et vos agents IA. Gratuit avec deux membres, un projet et dix documents, sans carte bancaire.

Commencer gratuitementOuvrir la démoTélécharger le modèle