Source unique de vérité : une seule version de chaque décision

Ce que signifie une source unique de vérité

L’idée vient des systèmes de données : chaque fait est stocké une fois, et tout le reste y renvoie. En documentation, cela veut dire que pour chaque décision, spécification ou règle, il existe un document auquel l’équipe fait confiance, et que les autres documents y renvoient au lieu de le répéter.

Cela ne veut pas dire un document géant, ni un outil unique pour tout. Cela veut dire que quand deux pages se contredisent, tout le monde sait laquelle l’emporte, et l’autre est corrigée ou clairement marquée comme ancienne.

Pourquoi la documentation dérive

• Les copies : un paragraphe collé dans une note, une diapositive ou un ticket devient une deuxième version dès que l’original change.
• Les décisions prises ailleurs : un appel ou un fil de discussion change le plan, et le document n’est jamais mis à jour.
• L’absence de responsable : une page que tout le monde peut modifier et dont personne ne répond cesse peu à peu d’être vraie.
• Des explorations qui ont l’air définitives : trois brouillons de la même idée, aucun marqué comme brouillon.
• Des agents IA qui lisent tout : un assistant qui reçoit tout le wiki peut citer un brouillon abandonné avec autant d’assurance que la décision qui l’a remplacé.

Sept pratiques pour garder une seule version

1. Donner un responsable à chaque document

Une personne nommée répond de l’exactitude de chaque document. D’autres peuvent le modifier ; le responsable décide quand il est juste.

2. Marquer ce qui est décidé et ce qui ne l’est pas

Étiquetez chaque document comme canon (la décision), exploration (un brouillon ou une option), obsolète, ou remplacé par un autre document. Un lecteur, ou un agent, ne devrait jamais avoir à deviner.

3. Lier au lieu de copier

Quand une note a besoin des règles de prix, elle renvoie à la spécification des prix. Si un résumé aide, dites d’où il vient et quand il a été écrit.

4. Écrire les décisions là où on les lira

Tenez un journal des décisions, ou un enregistrement par choix important, relié aux documents qu’il change. La réunion est l’endroit où l’on décide ; le document est l’endroit où la décision vit.

5. Remplacer, ne pas supprimer

Quand un document est remplacé, marquez-le comme tel et faites-le pointer vers son successeur. L’ancien raisonnement reste disponible, et personne ne le prend pour l’actuel.

6. Relire à un rythme régulier

Demandez à un relecteur nommé d’approuver les documents importants, et relisez-les quand le travail qu’ils décrivent change. La date et le statut d’un document doivent dire s’il est frais.

7. Donner aux agents IA la source, pas une copie

Connectez les assistants aux documents eux-mêmes, avec les droits du lecteur, plutôt que de coller des instantanés dans des conversations. Dites-leur quels documents sont canon, et traitez ce qu’ils écrivent comme un brouillon jusqu’à ce que quelqu’un l’approuve.

La mettre en place en une semaine

1. Listez les dix documents sur lesquels votre équipe s’appuie le plus, et donnez à chacun un responsable.
2. Marquez chacun canon, exploration ou obsolète. Fusionnez ou retirez les doublons, et marquez les retirés comme remplacés.
3. Remplacez les passages collés par des liens vers leur source.
4. Ouvrez un journal des décisions, et reliez les décisions de la semaine aux documents qu’elles changent.
5. Connectez vos outils d’IA aux documents, et dites-leur de préférer le canon.

Comment Nodary aide

• Statut de vérité : chaque document peut être marqué canon, exploration, obsolète, ou remplacé par un autre, et les agents apprennent le statut d’un document avant de le lire.
• Contradictions : quand deux documents se contredisent, Nodary montre les deux passages côte à côte, mot pour mot, et ne propose une résolution que si vous la demandez.
• Liens et rétroliens : un [[lien]] pointe vers la source, et chaque document liste ce qui pointe vers lui, pour voir ce qu’un changement touche.
• Relectures : vous nommez un propriétaire ou un administrateur de l’espace ou du projet du document, ou vous les sollicitez tous ; l’un d’eux approuve le document ou demande des changements, avec qui et quand, et la personne qui a demandé ne tranche que si personne d’autre ne le peut.
• Historique : chaque session d’édition de dix minutes au plus et chaque écriture d’agent forment une version ; un document garde ses 50 plus récentes faites par des personnes et ses 50 plus récentes faites par des agents, pour comparer des versions et en restaurer une.
• Agents avec droits : Studio AI et les agents connectés en MCP lisent les documents eux-mêmes, avec les droits de la personne qui est derrière.

Ce que Nodary ne fait pas : il ne décide pas de ce qui est vrai. Une personne fixe le statut d’un document, et une contradiction n’est résolue que si quelqu’un le choisit.

Erreurs courantes

• Déclarer un outil source de vérité pendant que les décisions continuent de vivre dans la messagerie.
• Faire de la source unique un document énorme que personne ne peut entretenir.
• Supprimer les anciennes versions, ce qui cache pourquoi les choses ont changé.
• Supposer qu’un assistant IA sait quel document est le bon.

Questions

À lire ensuite