Single Source of Truth: eine Fassung jeder Entscheidung

Was eine Single Source of Truth bedeutet

Die Idee stammt aus Datensystemen: Jede Tatsache wird einmal gespeichert, und alles andere verweist darauf. In der Dokumentation heißt das: Für jede Entscheidung, Spezifikation oder Regel gibt es ein Dokument, dem das Team vertraut, und andere Dokumente verlinken darauf, statt es zu wiederholen.

Es heißt nicht ein riesiges Dokument und auch nicht ein Werkzeug für alles. Es heißt: Wenn sich zwei Seiten widersprechen, weiß jeder, welche gilt, und die andere wird korrigiert oder deutlich als alt markiert.

Warum Dokumentation abdriftet

• Kopien: Ein Absatz, eingefügt in eine Notiz, eine Folie oder ein Ticket, wird zur zweiten Fassung, sobald sich das Original ändert.
• Entscheidungen anderswo: Ein Anruf oder ein Chatverlauf ändert den Plan, und das Dokument wird nie aktualisiert.
• Niemand zuständig: Eine Seite, die jeder bearbeiten kann und für die niemand verantwortlich ist, hört langsam auf, wahr zu sein.
• Entwürfe, die endgültig aussehen: drei Fassungen derselben Idee, keine als Entwurf markiert.
• KI-Agenten, die alles lesen: Ein Assistent, der das ganze Wiki bekommt, kann einen verworfenen Entwurf so sicher zitieren wie die Entscheidung, die ihn ersetzt hat.

Sieben Praktiken, die eine Fassung gültig halten

1. Jedem Dokument eine zuständige Person geben

Eine benannte Person steht für die Richtigkeit jedes Dokuments ein. Andere dürfen es bearbeiten; die zuständige Person entscheidet, wann es stimmt.

2. Markieren, was entschieden ist und was nicht

Kennzeichnen Sie jedes Dokument als Kanon (die Entscheidung), Erkundung (ein Entwurf oder eine Option), veraltet oder durch ein anderes Dokument ersetzt. Weder Leser noch Agent sollten raten müssen.

3. Verlinken statt kopieren

Braucht eine Notiz die Preisregeln, verlinkt sie die Preisspezifikation. Hilft eine Zusammenfassung, sagen Sie, woher sie stammt und wann sie geschrieben wurde.

4. Entscheidungen dort festhalten, wo man sie liest

Führen Sie ein Entscheidungsprotokoll oder einen Datensatz pro größerer Wahl, verknüpft mit den Dokumenten, die er ändert. Im Meeting wird entschieden; im Dokument lebt die Entscheidung.

5. Ersetzen, nicht löschen

Wird ein Dokument ersetzt, markieren Sie es so und lassen Sie es auf seinen Nachfolger verweisen. Die alte Begründung bleibt verfügbar, und niemand hält sie für die aktuelle.

6. Regelmäßig prüfen

Lassen Sie wichtige Dokumente von einer benannten Person freigeben, und prüfen Sie sie erneut, wenn sich die beschriebene Arbeit ändert. Datum und Status eines Dokuments sollten sagen, ob es frisch ist.

7. KI-Agenten die Quelle geben, keine Kopie

Verbinden Sie Assistenten mit den Dokumenten selbst, mit den Berechtigungen des Lesers, statt Momentaufnahmen in Chats einzufügen. Sagen Sie ihnen, welche Dokumente Kanon sind, und behandeln Sie, was sie schreiben, als Entwurf, bis jemand ihn freigibt.

In einer Woche einführen

1. Listen Sie die zehn Dokumente auf, auf die sich Ihr Team am meisten stützt, und geben Sie jedem eine zuständige Person.
2. Markieren Sie jedes als Kanon, Erkundung oder veraltet. Führen Sie Dubletten zusammen oder nehmen Sie sie heraus, und markieren Sie die herausgenommenen als ersetzt.
3. Ersetzen Sie eingefügte Passagen durch Links zu ihrer Quelle.
4. Beginnen Sie ein Entscheidungsprotokoll, und verknüpfen Sie die Entscheidungen dieser Woche mit den Dokumenten, die sie ändern.
5. Verbinden Sie Ihre KI-Werkzeuge mit den Dokumenten, und sagen Sie ihnen, dass sie Kanon bevorzugen sollen.

Wie Nodary hilft

• Wahrheitsstatus: Jedes Dokument kann als Kanon, Erkundung, veraltet oder durch ein anderes ersetzt markiert werden, und Agenten erfahren den Status eines Dokuments, bevor sie es lesen.
• Widersprüche: Wenn sich zwei Dokumente widersprechen, zeigt Nodary beide Passagen nebeneinander, Wort für Wort, und schlägt eine Lösung nur vor, wenn Sie darum bitten.
• Links und Backlinks: Ein [[Link]] zeigt auf die Quelle, und jedes Dokument listet, was auf es verweist, damit Sie sehen, was eine Änderung betrifft.
• Prüfungen: Sie benennen einen Inhaber oder Administrator des Arbeitsbereichs oder des Projekts des Dokuments oder fragen alle; einer von ihnen gibt das Dokument frei oder verlangt Änderungen, mit Person und Zeitpunkt, und wer gefragt hat, entscheidet nur, wenn niemand sonst es kann.
• Verlauf: Jede Bearbeitungssitzung von höchstens zehn Minuten und jeder Schreibvorgang eines Agenten ergeben eine Fassung; ein Dokument behält seine 50 neuesten von Menschen und seine 50 neuesten von Agenten, sodass Sie Fassungen vergleichen und eine wiederherstellen können.
• Agenten mit Berechtigungen: Die Studio-KI und per MCP verbundene Agenten lesen die Dokumente selbst, mit den Berechtigungen der Person dahinter.

Was Nodary nicht tut: Es entscheidet nicht, was wahr ist. Eine Person setzt den Status eines Dokuments, und ein Widerspruch wird nur aufgelöst, wenn jemand das wählt.

Typische Fehler

• Ein Werkzeug zur Quelle der Wahrheit erklären, während Entscheidungen weiter im Chat leben.
• Die eine Quelle zu einem riesigen Dokument machen, das niemand pflegen kann.
• Alte Fassungen löschen, was verbirgt, warum sich etwas geändert hat.
• Annehmen, ein KI-Assistent wisse, welches Dokument das richtige ist.

Fragen

Weiterlesen