provenance
¿De dónde sale esto?
Cada afirmación cita una fuente por su id. Las fuentes indican quién las escribió, cada cuánto se usan y cuándo cambiaron.
sources · usage_window
Open Knowledge Format · v0.2 · de Google Cloud
Conocimiento del que tus agentes pueden rendir cuentas
OKF es una especificación abierta de Google Cloud para el conocimiento que escriben los agentes y en el que confían las personas. Es una carpeta de archivos markdown, y cada archivo dice de dónde salen sus afirmaciones, quién las comprobó y cuándo caducan. Knowtarium está construido sobre ella.
El paquete
Una carpeta de markdown. Nada más.
Un paquete OKF es un directorio de archivos markdown con frontmatter YAML. No hay base de datos, ni registro de esquemas, ni ninguna herramienta obligatoria: si puedes abrir un archivo de texto, puedes leerlo, y si puedes copiar una carpeta o clonar un repositorio, puedes compartirlo.
Cada archivo es un concepto: una métrica, una política, una entrevista con un cliente, un runbook (manual de procedimientos). El único campo obligatorio es type. Las carpetas agrupan los conceptos como mejor le venga al equipo, y hay dos nombres de archivo reservados: index.md lista lo que contiene una carpeta, y log.md registra lo que cambió.
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
Dentro de un documento
Cuatro preguntas, respondidas en el frontmatter.
Cuando los agentes escriben la mayor parte de una base de conocimiento, quien la lee necesita algo más que el texto. OKF v0.2 añade unas pocas familias de campos opcionales para que cada documento responda a las mismas preguntas. Todas son opcionales: un documento con solo un type sigue siendo válido, y si falta una familia, simplemente no se sabe la respuesta.
Las afirmaciones del cuerpo citan fuentes con notas al pie identificadas por id, como [^billing-export], para que el enlace se mantenga cuando un agente reordena la lista.
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én lo comprobó?
Quién escribió el documento, y cada persona o proceso que lo confirmó desde entonces, con la hora.
generated · verified
lifecycle
¿Sigue vigente?
Un estado draft, stable o deprecated, y el momento a partir del cual ya no es seguro citar el documento.
status · stale_after
attestation
¿Se calculó esta cifra de la forma aprobada?
Un cálculo vive en su propio documento. Los agentes rellenan los parámetros; una comprobación determinista confirma que lo que se ejecutó fue la consulta aprobada.
runtime · parameters · executor · attester
Niveles de confianza
Se deducen, nunca se declaran.
Ningún documento puede declararse fiable a sí mismo. Quien lo lee deduce el nivel a partir de quién aparece en verified, y la caducidad a partir de stale_after. Con la revisión activada, Knowtarium colorea cada nota según estas reglas y nada más.
unverifiedNinguna entrada en
verified.machine-confirmedVerificado solo por agentes o procesos, como process:ci.
human-reviewedVerificado por al menos una persona, como human:maya.
staleLa hora actual ya pasó
stale_after, sea cual sea el nivel.Quién lo hizo
Cada campo by nombra a un actor de una de estas tres formas. El prefijo human: es lo que hace que una verificación cuente como la revisión de una persona.
- claude-code/2.1
- Un agente o una herramienta, con su versión
- human:maya
- Una persona
- process:finance-nightly
- Un proceso automatizado
Knowtarium y OKF
Qué lee y qué escribe la app.
Knowtarium guarda cada nota como OKF, cifrada en tu dispositivo. Sigue la especificación de cerca, así que lo que importas vuelve a salir como un paquete que cualquier otra herramienta OKF puede usar.
Importa cualquier paquete
Importa un paquete OKF o una bóveda de Obsidian en un espacio de trabajo. Ni los campos que faltan, ni los tipos o claves desconocidos, ni los enlaces rotos hacen nunca que una nota sea ilegible.
Exporta OKF sin más
Exporta todos los espacios de trabajo como un paquete OKF en un solo zip, descifrado en tu navegador, listo para cualquier otra herramienta OKF.
Tus propias claves se quedan
Las claves de frontmatter personalizadas, los comentarios y el formato se conservan tal como están escritos, como pide la especificación.
El nombre de una persona tiene que ir firmado
Una entrada human: solo cuenta cuando la confirma un cambio firmado por esa misma persona, así que un agente no puede hacer pasar su trabajo por el tuyo.
La revisión es opcional y escribe una sola entrada
Activa la revisión en un espacio de trabajo o una carpeta, y al aprobar un cambio se te añade a verified con la hora. Es el único campo que escribe la revisión.
El historial queda fuera de tus notas
Las versiones, los comentarios y las firmas se guardan junto a cada nota, cifrados, para que las notas sigan siendo OKF limpio.
Si vienes de Obsidian
Tu bóveda ya tiene casi todo el camino hecho.
Una bóveda de Obsidian ya es una carpeta de markdown con frontmatter. Impórtala en un espacio de trabajo, o convierte una copia sin conexión con : se añaden los campos OKF, los wikilinks pasan a ser enlaces markdown y se escribe un índice, sin tocar lo que escribiste.
OKF es un formato abierto publicado por Google Cloud en el repositorio open-knowledge-format de GitHub. Knowtarium es una app independiente, sin afiliación con Google ni respaldo de Google.