Wissen mit Status

Ein gemeinsames Frontmatter sagt Mensch und Agent, wie verbindlich ein Dokument ist.

Wir erklären hier eine Idee. Wir entscheiden nichts. Alle Beispiele sind erfunden.

1Das Problem

Alles sieht gleich aus

Unser Wissen liegt in vielen Ordnern mit Markdown-Dateien. Ein geprüfter Leitfaden sieht aus wie eine erste Notiz. Mensch und Agent müssen raten.

Gleiche Form, andere ReifeEntwurf, Regel und Altlast liegen im selben Ordner. Sie tragen dasselbe Symbol.
Kopien bleiben liegenAlte Fassungen und Kopien verschwinden nicht. Die Suche findet sie alle.
Ein Agent zögert nichtEr liest einen Entwurf mit demselben Vertrauen wie eine Regel. Er sagt nicht, woher die Unsicherheit kommt.
Unsere Annahme

Eine Wissenssammlung ist ein Ordner mit Markdown-Dateien. Egal, wo der Ordner liegt.

Es gibt keine Branches und keine Pull Requests, die eine Prüfung festhalten. Deshalb muss jede Datei selbst sagen, wie weit sie ist. Das macht das Frontmatter.

2Das Frontmatter

Ein kurzer Kopf für jedes Dokument

Frontmatter ist ein Block am Anfang einer Markdown-Datei. Er steht zwischen zwei Zeilen mit drei Strichen. Er ist in YAML geschrieben. Menschen lesen ihn, Programme auch.

Tipp eine Zeile oder ein Feld an. Dann siehst du die Erklärung daneben.

leitfaden-urlaubsantrag-2026.md

# Leitfaden Urlaubsantrag

Ab hier folgt der normale Text des Dokuments.

    Feldnamen bleiben englisch und klein. So passen sie zu Werkzeugen und Agenten in jeder Sprache. Werte sind kurz und ohne Leerzeichen. Die erlaubten Werte legen wir gemeinsam fest.

    3Lebenszyklus

    Ein Dokument wird erwachsen

    Ein Dokument durchläuft Stufen. Bei jeder Stufe ändern sich wenige Zeilen im Frontmatter. Der Badge folgt dem Status.

    leitfaden-urlaubsantrag-2026.md

    „Abgelaufen“ ist kein eigener Status. Es folgt aus dem Datum in valid_until. Ein Dokument ohne Nachfolger, das nicht mehr gilt, bekommt deprecated statt superseded.

    4Regeln

    Wie wir danach lesen

    Der Status sagt nicht nur, wie weit ein Dokument ist. Er sagt auch, wie wir es lesen. Die Tabelle zeigt eine mögliche Regel je Status, für Mensch und Agent.

    Simulation: Der Agent wählt seine Quelle

    Drei Dokumente passen zur Frage. Stell den Status jedes Dokuments um. Die Antwort ändert sich mit.

    Wie früh muss ich Urlaub beantragen?

    Eine Anweisung für den Agenten

    Die Regeln wirken erst, wenn der Agent sie kennt. Ein Absatz in AGENTS.md oder im System-Prompt genügt. In einem Satz:

    „Lies vor jeder Antwort das Frontmatter: Zitiere nur approved, nenne draft nur als Hinweis mit Vermerk, folge bei superseded dem Nachfolger und warne, wenn valid_until vorbei ist.“

    Ausführlicher, zum Übernehmen:

    
      
    
    
    
  
    

  
    
    
    5Varianten
    
    
    Wie viel Kopf ist nötig?
    
    
    Drei Stufen zeigen die Spanne. Jede Stufe enthält die vorige. Mehr Felder geben dem Agenten mehr Möglichkeiten. Sie kosten aber auch mehr Pflege.
    
    
    Tipp eine Stufe an. Die Tabelle darunter zeigt, was ein Agent damit kann.
    
    
    
    
    
    
    Ein möglicher Weg: Wir beginnen überall mit Minimal. Standard führen wir dort ein, wo Regeln altern. Ausführlich lohnt sich für Sammlungen mit vertraulichem Inhalt oder vielen Fassungen.
    
  
    

  
    
    
    6Was es braucht
    
    
    Damit es wirkt
    
    
    Ein Feld allein ändert nichts. Vier Dinge machen es wirksam. Das ist eine Anregung von uns, kein Beschluss.
    
    
    
      
    Eine gemeinsame Feldliste
    Gleiche Namen und gleiche Werte in allen Sammlungen. Kurz, schriftlich, an einem Ort.
    
      
    Ein Check
    Ein kleines Skript liest das Frontmatter aller Dateien im Ordner. Es meldet fehlende Felder und abgelaufene Dokumente. Ein Agent kann das beim Lesen auch selbst melden.
    
      
    Eine Agenten-Anweisung
    Ein Absatz in AGENTS.md oder im Prompt. Er sagt, wie ein Agent jeden Status liest.
    
      
    Ein Verantwortlicher je Sammlung
    Eine Person oder Rolle hält die Sammlung sauber. Sie reagiert auf die Warnungen des Checks.
    
    
    
    
    So könnte die Meldung eines Skripts aussehen:
    
    
    Ordner: wissen/ok         leitfaden-urlaubsantrag-2026.mdfehlt      checkliste-release.md: ownerabgelaufen onboarding.md: valid_until 2026-06-30verwaist   reisekosten-faq.md: superseded_by zeigt ins Leere