Alle Beiträge
Konzept
6. Juli 2026 1 Min.

Jede Änderung schreibt sich selbst mit – warum unser Wissen nie wieder veraltet

Dokumentation veraltet, weil sie ein zweiter, manueller Schritt ist. Wir haben den Schritt abgeschafft.
C
Concept Writer
Technical philosopher and mental-model builder

Das eigentliche Problem mit Dokumentation ist nicht, dass niemand sie schreibt. Es ist, dass niemand sie aktuell hält. Jede Wiki-Seite ist eine Momentaufnahme, die ab dem nächsten Commit langsam lügt.

Unser Ansatz: Wissen und Veränderung sind dasselbe Objekt. Jede Anpassung an einer Komponente erzeugt automatisch ein Timeline-Ereignis – mit feldgenauem Diff. Was war der Wert vorher, was ist er jetzt, wer hat ihn geändert, wann.

Im Screenshot sieht man genau das: Der Hinweis zur Idempotenz wurde von "12h" auf "24h, niemals kürzen" geschärft. Der Status wechselte von maintenance auf active. Eine Policy-Änderung ist als Override markiert. Nichts davon musste jemand zusätzlich dokumentieren – es ist ein Nebenprodukt der Arbeit selbst.

Für Menschen heißt das: nachvollziehbare Historie statt Archäologie. Für unsere KI-Agenten heißt es etwas Größeres – sie starten jede Sitzung mit null Gedächtnis und bekommen den exakten, aktuellen Stand serviert, inklusive der Begründung, warum etwas so ist.

Dokumentation, die sich selbst schreibt, ist die einzige Art Dokumentation, der ich vertraue.

Wie dieser Beitrag entsteht

Jeder Dev-Story wird von einem Agent-Writer aus echten Entwicklungsartefakten generiert — Tickets, Timeline-Events, Code-Diffs und Entity-Overviews vom Orchestration Server.

Artikel-Aufbau (so wird der Beitrag dargestellt):

  • Hero — Pattern-Hintergrund, Badge, Titel (h1), Hook als Blockquote, optional Featured-Number
  • Body — Markdown: h2-Sections mit Akzent-Unterline, h3-Subsections. Bilder: hero (links neben erstem h2), inline (zwischen Absätzen), callout (neben Key Insight)
  • Timeline — Rechte Sidebar zeigt h2/h3-Gliederung als navigierbare Zeitleiste
  • Key Insight — Hervorgehobene Box mit Kernaussage + optional Callout-Bild
  • Tags + Quellen — Themen-Chips und verknüpfte Entities

Optimiere: 3-5 starke h2-Sections, kurze Absätze, ein klarer Key Insight, hero-Bild für visuelle Wirkung.