# 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.

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

[Télécharger le modèle (.zip)](https://nodary.ai/downloads/modele-journal-des-decisions.zip)

## 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.

- Journal des décisions: L’index de toutes les décisions : leur numéro, leur statut, leur date et ce qui les a remplacées.
- Comment nous décidons: Qui propose et qui décide, comment une fiche passe de proposée à décidée, et quand les décisions sont revues.
- Fiche de décision vierge: Une fiche vierge à copier pour chaque nouvelle décision : statut, contexte, options, décision et conséquences.
- ADR-001 Garder les décisions dans ce journal: La première fiche : pourquoi l’équipe écrit ses décisions, et comment.
- ADR-002 Stocker les fichiers envoyés sur le serveur d’application: Un exemple de fiche remplacée : elle reste telle quelle, avec le numéro de la fiche qui l’a remplacée.
- ADR-003 Stocker les fichiers envoyés dans un stockage objet: Un exemple de fiche acceptée qui en remplace une plus ancienne.

### 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éro | Décision | Statut | Date | Décidé par | Remplacée par |
| --- | --- | --- | --- | --- | --- |
| [ADR-001](https://nodary.ai/fr/templates/decision-log#doc-adr-001) | Garder les décisions dans ce journal | acceptée | [date] | [noms] |  |
| [ADR-002](https://nodary.ai/fr/templates/decision-log#doc-adr-002) | Stocker les fichiers envoyés sur le serveur d’application | remplacée | [date] | [noms] | [ADR-003](https://nodary.ai/fr/templates/decision-log#doc-adr-003) |
| [ADR-003](https://nodary.ai/fr/templates/decision-log#doc-adr-003) | Stocker les fichiers envoyés dans un stockage objet | acceptée | [date] | [noms] |  |
| [ADR-004] | [Votre prochaine décision] | [proposée] | [date] | [noms] |  |

#### Statuts

```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
```
_Comment le statut d’une décision évolue_

| Statut | Sens |
| --- | --- |
| Proposée | Écrite et ouverte à la relecture, pas encore décidée |
| Acceptée | Décidée : l’équipe s’y tient |
| Rejetée | Décidée contre, et gardée pour que personne n’ait à redemander |
| Remplacée | Remplacée par une décision plus récente, dont elle donne le numéro |
| Obsolète | Ne 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

- [Comment nous décidons](https://nodary.ai/fr/templates/decision-log#doc-process) : qui propose, qui décide, et comment une fiche est relue
- [Fiche de décision vierge](https://nodary.ai/fr/templates/decision-log#doc-record) : la fiche vierge à copier pour chaque nouvelle décision

_Ce modèle est libre d’utilisation, de modification et de partage. Il vient de_ [Nodary](https://nodary.ai/fr)_, où ces fichiers s’importent sous forme de carte de documents liés._

### Comment nous décidons

**Responsable :** [nom] · **Statut :** brouillon · **Dernière relecture :** [date]

_Les règles du journal, fixées une fois. Sans elles, on écrit des fiches pour de petites choses et on en oublie pour les grandes._

#### Qui décide

| Type de décision | Proposée par | Décidée par | Consultés |
| --- | --- | --- | --- |
| [Architecture] | [tout développeur] | [responsable technique] | [...] |
| [Périmètre produit] | [...] | [responsable produit] | [...] |
| [Fournisseur ou dépense] | [...] | [...] | [...] |

#### De la proposition à la décision

1. Copiez la [fiche vierge](https://nodary.ai/fr/templates/decision-log#doc-record), donnez-lui le numéro suivant et le statut proposée.
2. Écrivez le contexte et au moins deux options avant la décision.
3. Demandez aux décideurs de la relire avant le [date].
4. Passez le statut à acceptée ou rejetée, avec la date et les décideurs.
5. Ajoutez une ligne au [journal des décisions](https://nodary.ai/fr/templates/decision-log#doc-overview).

#### Changer une décision

_Ne modifiez jamais une fiche acceptée pour lui faire dire autre chose. Écrivez une nouvelle fiche qui la remplace, passez l’ancienne à remplacée avec le numéro de la nouvelle, et reliez les deux dans les deux sens._

#### Revues

- Les décisions acceptées sont revues : [chaque trimestre, à chaque jalon]
- Les décisions proposées depuis plus de [deux semaines] sont tranchées ou retirées

Voir aussi : [Journal des décisions](https://nodary.ai/fr/templates/decision-log#doc-overview) · [Fiche de décision vierge](https://nodary.ai/fr/templates/decision-log#doc-record)

### Fiche de décision vierge

_Copiez cette page pour chaque nouvelle décision et donnez-lui le numéro suivant, par exemple ADR-004 suivi de la décision en quelques mots._

| Champ | Valeur |
| --- | --- |
| Numéro | [ADR-000] |
| Statut | [proposée, acceptée, rejetée, remplacée par ADR-..., obsolète] |
| Date | [date] |
| Décidé par | [noms] |
| Remplace | [aucune, ou ADR-...] |

#### Contexte

_Les forces en jeu : ce qui est vrai aujourd’hui, ce qui fait mal, ce qui contraint le choix. Des faits, pas la décision._

[Contexte]

#### Options envisagées

| Option | Pour | Contre |
| --- | --- | --- |
| [Option A] | [...] | [...] |
| [Option B] | [...] | [...] |

#### Décision

_Ce que vous allez faire, en phrases complètes, en commençant par « Nous allons »._

Nous allons [...].

#### Conséquences

- Plus facile : [...]
- Plus difficile : [...]
- À surveiller : [...]

Voir aussi : [Journal des décisions](https://nodary.ai/fr/templates/decision-log#doc-overview) · [Comment nous décidons](https://nodary.ai/fr/templates/decision-log#doc-process)

### ADR-001 Garder les décisions dans ce journal

| Champ | Valeur |
| --- | --- |
| Numéro | ADR-001 |
| Statut | acceptée |
| Date | [date] |
| Décidé par | [noms] |
| Remplace | aucune |

#### Contexte

Les décisions se prennent en réunion, dans des messageries et au téléphone. Quelques mois plus tard, plus personne ne se souvient pourquoi l’équipe a choisi ce qu’elle a choisi, et les nouveaux venus refont de vieux débats ou défont des choix sans savoir ce qu’ils ont coûté.

#### Options envisagées

| Option | Pour | Contre |
| --- | --- | --- |
| Ne rien écrire | Rapide | Les raisons se perdent |
| Un compte rendu de chaque réunion | Tout est gardé | Personne ne les lit, et les décisions s’y noient |
| Une fiche courte par décision importante, listée dans un journal | Facile à trouver et à lire | Environ quinze minutes par décision |

#### Décision

Nous allons écrire une fiche pour chaque décision importante, numérotée dans l’ordre, et la lister dans le [journal des décisions](https://nodary.ai/fr/templates/decision-log#doc-overview). Une fiche n’est jamais supprimée ni réécrite : une nouvelle fiche la remplace.

#### Conséquences

- Plus facile : savoir pourquoi, et mettre un nouveau venu à niveau
- Plus difficile : décider vite sans rien écrire
- À surveiller : les fiches écrites après coup, ou pas du tout

Voir aussi : [Journal des décisions](https://nodary.ai/fr/templates/decision-log#doc-overview) · [Comment nous décidons](https://nodary.ai/fr/templates/decision-log#doc-process)

### ADR-002 Stocker les fichiers envoyés sur le serveur d’application

| Champ | Valeur |
| --- | --- |
| Numéro | ADR-002 |
| Statut | remplacée par [ADR-003](https://nodary.ai/fr/templates/decision-log#doc-adr-003) |
| Date | [date] |
| Décidé par | [noms] |
| Remplace | aucune |

_Un exemple de fiche remplacée. Rien n’y a changé quand ADR-003 l’a remplacée, sauf son statut._

#### Contexte

Les utilisateurs joignent des fichiers à leurs documents. Le produit tourne sur un seul serveur d’application avec un grand disque, et l’équipe compte deux développeurs.

#### Options envisagées

| Option | Pour | Contre |
| --- | --- | --- |
| Le disque du serveur d’application | Simple, rien de nouveau à faire tourner | Difficile à sauvegarder et à partager avec un second serveur |
| Un stockage objet | Grandit sans limite, peu coûteux | Un service de plus à apprendre et à payer |

#### Décision

Nous allons stocker les fichiers envoyés sur le disque du serveur d’application et sauvegarder ce disque chaque nuit.

#### Conséquences

- Plus facile : livrer l’envoi de fichiers ce mois-ci
- Plus difficile : ajouter un second serveur plus tard
- À surveiller : l’espace libre du disque et le temps d’une restauration

Voir aussi : [Journal des décisions](https://nodary.ai/fr/templates/decision-log#doc-overview) · [ADR-003 Stocker les fichiers envoyés dans un stockage objet](https://nodary.ai/fr/templates/decision-log#doc-adr-003)

### ADR-003 Stocker les fichiers envoyés dans un stockage objet

| Champ | Valeur |
| --- | --- |
| Numéro | ADR-003 |
| Statut | acceptée |
| Date | [date] |
| Décidé par | [noms] |
| Remplace | [ADR-002](https://nodary.ai/fr/templates/decision-log#doc-adr-002) |

#### Contexte

Le trafic demande maintenant un second serveur d’application, et un fichier écrit sur le disque d’un serveur manque sur l’autre. La restauration de la sauvegarde nocturne a pris quatre heures lors du dernier exercice. [ADR-002](https://nodary.ai/fr/templates/decision-log#doc-adr-002) supposait un seul serveur ; ce n’est plus vrai.

#### Options envisagées

| Option | Pour | Contre |
| --- | --- | --- |
| Un disque partagé entre les serveurs | Aucun changement dans le code | Une chose de plus à faire tourner, et un point de défaillance unique |
| Un stockage objet | Chaque serveur voit chaque fichier, versions gardées, restauration en minutes | Du code à changer pour l’envoi et le téléchargement |

#### Décision

Nous allons stocker les fichiers envoyés dans un stockage objet avec le versionnage activé, et les servir par des liens signés qui expirent. Cette fiche remplace [ADR-002](https://nodary.ai/fr/templates/decision-log#doc-adr-002).

#### Conséquences

- Plus facile : ajouter des serveurs, et restaurer un fichier supprimé
- Plus difficile : faire tourner le produit sur un portable sans le service de stockage
- À surveiller : la facture de stockage, et les liens partagés avant leur expiration

Voir aussi : [Journal des décisions](https://nodary.ai/fr/templates/decision-log#doc-overview) · [ADR-002 Stocker les fichiers envoyés sur le serveur d’application](https://nodary.ai/fr/templates/decision-log#doc-adr-002)

## Comment s’en servir

### 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é.

### 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.

### 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.

### 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é.

## 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.

La page : https://nodary.ai/fr/templates/decision-log