provenance
D’où cela vient-il ?
Chaque affirmation cite une source par son id. Les sources indiquent qui les a écrites, à quelle fréquence elles servent et quand elles ont changé.
sources · usage_window
Open Knowledge Format · v0.2 · par Google Cloud
Des connaissances dont vos agents peuvent rendre compte
OKF est une spécification ouverte de Google Cloud pour les connaissances que les agents écrivent et sur lesquelles les personnes s’appuient. C’est un dossier de fichiers markdown, et chaque fichier indique d’où viennent ses affirmations, qui les a vérifiées et quand elles expirent. Knowtarium est construit dessus.
Le paquet
Un dossier de markdown. Rien d’autre.
Un paquet OKF (bundle) est un répertoire de fichiers markdown avec un frontmatter YAML. Il n’y a ni base de données, ni registre de schémas, ni outil obligatoire : si vous savez ouvrir un fichier texte, vous pouvez le lire, et si vous savez copier un dossier ou cloner un dépôt, vous pouvez le partager.
Chaque fichier est un concept : une métrique, une règle, un entretien client, un runbook. Le seul champ obligatoire est type. Les dossiers regroupent les concepts comme cela convient à l’équipe, et deux noms de fichiers sont réservés : index.md liste ce que contient un dossier, et log.md consigne ce qui a changé.
bundle
~/kb/index.md # what's in this folder (optional)log.md # what changed, newest first (optional)company/mission.mdglossary.mdmetrics/revenue.md # one concept per filechurn.mdcomputations/quarterly-revenue.md # an attested computationcustomers/segments.mdinterviews/northwind-traders.md
À l’intérieur d’un document
Quatre questions, auxquelles répond le frontmatter.
Quand des agents écrivent l’essentiel d’une base de connaissances, le texte ne suffit plus au lecteur. OKF v0.2 ajoute quelques familles de champs facultatives qui font répondre chaque document aux mêmes questions. Elles sont toutes facultatives : un document qui n’a qu’un type reste valide, et une famille absente signifie simplement que la réponse est inconnue.
Dans le corps, les affirmations citent leurs sources par des notes de bas de page identifiées par un id, comme [^billing-export], pour que le lien tienne quand un agent réordonne la liste.
metrics/revenue.md
---type: Metrictitle: Quarterly revenuetags: [finance, revenue]status: stablegenerated: { 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:00Zsources:- id: billing-exportresource: exports/billing/2026-09.csvauthor: process:billing-syncowner: human:maya # your own keys are kept as written---Q3 revenue was €112,400, up 12% on Q2.[^billing-export]
trust
Qui l’a vérifié ?
Qui a écrit le document, et chaque personne ou processus qui l’a confirmé depuis, avec l’heure.
generated · verified
lifecycle
Est-ce encore à jour ?
Un statut draft, stable ou deprecated, et le moment à partir duquel le document n’est plus sûr à citer.
status · stale_after
attestation
Ce chiffre a-t-il été calculé de la façon approuvée ?
Un calcul vit dans son propre document. Les agents remplissent les paramètres ; une vérification déterministe confirme que c’est bien la requête approuvée qui a tourné.
runtime · parameters · executor · attester
Niveaux de confiance
Déduits, jamais déclarés.
Aucun document ne peut se déclarer fiable lui-même. Un lecteur déduit le niveau de qui figure sous verified, et la péremption de stale_after. Avec la relecture activée, Knowtarium colore chaque note selon ces règles et rien d’autre.
unverifiedAucune entrée
verified.machine-confirmedVérifié uniquement par des agents ou des processus, comme process:ci.
human-reviewedVérifié par au moins une personne, comme human:maya.
staleL’heure actuelle a dépassé
stale_after, quel que soit le niveau.Qui l’a fait
Chaque champ by nomme un acteur sous l’une de trois formes. C’est le préfixe human: qui fait compter une vérification comme la relecture d’une personne.
- claude-code/2.1
- Un agent ou un outil, avec sa version
- human:maya
- Une personne
- process:finance-nightly
- Un processus automatisé
Knowtarium et OKF
Ce que l’application lit et écrit.
Knowtarium enregistre chaque note au format OKF, chiffrée sur votre appareil. Il suit la spécification de près, donc ce que vous importez ressort sous forme de paquet utilisable par n’importe quel autre outil OKF.
Il importe n’importe quel paquet
Importez un paquet OKF ou un coffre Obsidian dans un espace de travail. Les champs manquants, les types inconnus, les clés inconnues et les liens cassés ne rendent jamais une note illisible.
Les exports sont du OKF simple
Exportez chaque espace de travail en paquet OKF dans un seul zip, déchiffré dans votre navigateur, prêt pour n’importe quel autre outil OKF.
Vos propres clés restent en place
Les clés de frontmatter personnalisées, les commentaires et la mise en forme sont conservés exactement tels qu’écrits, comme le demande la spécification.
Le nom d’une personne doit être signé
Une entrée human: ne compte que si une modification signée par cette personne la confirme, un agent ne peut donc pas faire passer son travail pour le vôtre.
La relecture est facultative, et n’écrit qu’une entrée
Activez la relecture pour un espace de travail ou un dossier, et approuver une modification vous ajoute à verified avec l’heure. C’est le seul champ qu’écrit la relecture.
L’historique reste hors de vos notes
Les versions, les commentaires et les signatures sont stockés à côté de chaque note, chiffrés, pour que les notes elles-mêmes restent du OKF propre.
Si vous venez d’Obsidian
Votre coffre y est presque.
Un coffre Obsidian est déjà un dossier de markdown avec du frontmatter. Importez-le dans un espace de travail, ou convertissez-en une copie hors ligne avec : les champs OKF sont ajoutés, les wikiliens deviennent des liens markdown et un index est écrit, sans toucher à ce que vous avez écrit.
OKF est un format ouvert publié par Google Cloud dans le dépôt open-knowledge-format sur GitHub. Knowtarium est une application indépendante, ni affiliée à Google ni soutenue par Google.