Open Knowledge Format · v0.2 · von Google Cloud

Wissen, das deine Agenten belegen können

OKF ist eine offene Spezifikation von Google Cloud für Wissen, das Agenten schreiben und auf das sich Menschen verlassen. Es ist ein Ordner voller Markdown-Dateien, und jede Datei sagt, woher ihre Aussagen stammen, wer sie geprüft hat und wann sie ablaufen. Knowtarium baut darauf auf.

Das Bundle

Ein Ordner voller Markdown. Sonst nichts.

Ein OKF-Bundle ist ein Verzeichnis mit Markdown-Dateien mit YAML-Frontmatter. Es gibt keine Datenbank, keine Schema-Registry und kein Pflicht-Tool: Wenn du eine Textdatei öffnen kannst, kannst du es lesen, und wenn du einen Ordner kopieren oder ein Repo klonen kannst, kannst du es teilen.

Jede Datei ist ein Konzept: eine Kennzahl, eine Richtlinie, ein Kundeninterview, ein Runbook. Das einzige Pflichtfeld ist type. Ordner gruppieren Konzepte so, wie es zum Team passt, und zwei Dateinamen sind reserviert: index.md listet, was ein Ordner enthält, und log.md hält fest, was sich geändert hat.

bundle
~/kb/
index.md # what's in this folder (optional)
log.md # what changed, newest first (optional)
company/
mission.md
glossary.md
metrics/
revenue.md # one concept per file
churn.md
computations/
quarterly-revenue.md # an attested computation
customers/
segments.md
interviews/
northwind-traders.md

In einem Dokument

Vier Fragen, beantwortet im Frontmatter.

Wenn Agenten den Großteil einer Wissensdatenbank schreiben, braucht ein Leser mehr als den Text. OKF v0.2 fügt ein paar optionale Feldgruppen hinzu, mit denen jedes Dokument dieselben Fragen beantwortet. Sie sind alle optional: Ein Dokument mit nur einem type ist trotzdem gültig, und eine fehlende Gruppe heißt einfach, dass die Antwort unbekannt ist.

Aussagen im Text belegen ihre Quellen mit Fußnoten, die über eine ID verknüpft sind, etwa [^billing-export]. So hält die Verknüpfung, auch wenn ein Agent die Liste umsortiert.

metrics/revenue.md
---
type: Metric
title: Quarterly revenue
tags: [finance, revenue]
status: stable
generated: { by: claude-code/2.1, at: 2026-09-26T07:42:00Z }
verified:
- { by: human:maya, at: 2026-09-26T10:05:00Z }
stale_after: 2026-12-31T00:00:00Z
sources:
- id: billing-export
resource: exports/billing/2026-09.csv
author: process:billing-sync
owner: human:maya # your own keys are kept as written
---
Q3 revenue was €112,400, up 12% on Q2.[^billing-export]

provenance

Woher stammt das?

Jede Aussage nennt eine Quelle per ID. Quellen halten fest, wer sie geschrieben hat, wie oft sie genutzt werden und wann sie sich geändert haben.

sources · usage_window

trust

Wer hat es geprüft?

Wer das Dokument geschrieben hat, und jede Person oder jeder Prozess, die es seitdem bestätigt haben, mit Zeitpunkt.

generated · verified

lifecycle

Ist es noch aktuell?

Ein Status draft, stable oder deprecated, und der Zeitpunkt, ab dem man das Dokument nicht mehr bedenkenlos zitieren kann.

status · stale_after

attestation

Wurde diese Zahl auf dem freigegebenen Weg berechnet?

Eine Berechnung steht in einem eigenen Dokument. Agenten füllen die Parameter aus; eine deterministische Prüfung bestätigt, dass genau die freigegebene Abfrage gelaufen ist.

runtime · parameters · executor · attester

Vertrauensstufen

Abgeleitet, nie behauptet.

Kein Dokument darf sich selbst für vertrauenswürdig erklären. Ein Leser ermittelt die Stufe daraus, wer unter verified steht, und die Aktualität aus stale_after. Mit eingeschaltetem Review färbt Knowtarium jede Notiz nach genau diesen Regeln ein, nach nichts anderem.

unverifiedÜberhaupt keine Einträge unter verified.
machine-confirmedNur von Agenten oder Prozessen bestätigt, etwa process:ci.
human-reviewedVon mindestens einer Person bestätigt, etwa human:maya.
staleDer aktuelle Zeitpunkt liegt nach stale_after, egal welche Stufe.

Wer es war

Jedes by-Feld nennt einen Akteur in einer von drei Formen. Erst das Präfix human: lässt eine Bestätigung als Review durch eine Person zählen.

claude-code/2.1
Ein Agent oder Tool, mit seiner Version
human:maya
Eine Person
process:finance-nightly
Ein automatisierter Prozess

Knowtarium und OKF

Was die App liest und schreibt.

Knowtarium speichert jede Notiz als OKF, verschlüsselt auf deinem Gerät. Es hält sich eng an die Spezifikation, also kommt, was du importierst, als Bundle wieder heraus, das jedes andere OKF-Tool nutzen kann.

Es importiert jedes Bundle

Importiere ein OKF-Bundle oder einen Obsidian-Vault in einen Workspace. Fehlende Felder, unbekannte Typen, unbekannte Keys und kaputte Links machen eine Notiz nie unlesbar.

Exporte sind reines OKF

Exportiere jeden Workspace als OKF-Bundle in einem ZIP, in deinem Browser entschlüsselt, bereit für jedes andere OKF-Tool.

Deine eigenen Keys bleiben

Eigene Frontmatter-Keys, Kommentare und Formatierung bleiben genau so, wie sie geschrieben sind, wie es die Spezifikation verlangt.

Der Name einer Person muss signiert sein

Ein human:-Eintrag zählt nur, wenn die eigene signierte Änderung dieser Person ihn bestätigt. So kann kein Agent seine Arbeit als deine ausgeben.

Review ist optional und schreibt einen Eintrag

Schalte Review für einen Workspace oder Ordner ein, und wenn du eine Änderung freigibst, wirst du mit Zeitpunkt unter verified eingetragen. Das ist das einzige Feld, das Review schreibt.

Der Verlauf bleibt aus deinen Notizen heraus

Versionen, Kommentare und Signaturen werden verschlüsselt neben jeder Notiz gespeichert, damit die Notizen selbst sauberes OKF bleiben.

Umstieg von Obsidian

Dein Vault ist schon fast so weit.

Ein Obsidian-Vault ist schon ein Ordner voller Markdown mit Frontmatter. Importiere ihn in einen Workspace, oder konvertiere eine Kopie offline mit : Die OKF-Felder kommen dazu, Wikilinks werden zu Markdown-Links und ein Index wird geschrieben, ohne dass dein Text angetastet wird.

OKF ist ein offenes Format, das Google Cloud im Repository open-knowledge-format auf GitHub veröffentlicht. Knowtarium ist eine unabhängige App, nicht mit Google verbunden und nicht von Google unterstützt.