knowledge-base/raw/blog/2026-06-16_okf-google-cloud-open-knowledge-format.md

---
type: blog
source_url: https://www.reddit.com/r/WebAfterAI/comments/1u6mge2/google_cloud_just_released_okf_think_mcp_but_for/
retrieved: 2026-06-16
title: "Google Cloud just released OKF. Think MCP, but for knowledge instead of tools and 3 ways to use it."
author: "u/OnshapePTC (PTC)"
subreddit: r/WebAfterAI
score: null
tags: [okf, google-cloud, open-knowledge-format, llm-wiki, karpathy, knowledge-base, mcp, agent-knowledge]
okf_announcement: https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing
okf_spec: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md
okf_repo: https://github.com/GoogleCloudPlatform/knowledge-catalog
pit_share_ome_topic: 13
pit_share_message_id: 6697
---

# Google Cloud just released OKF. Think MCP, but for knowledge instead of tools

> **Pit-Share:** OME Topic 13 #6697, 2026-06-16 11:48 UTC
> **Pit-Kommentar:** Pit hat den Reddit-Link ohne zusätzlichen Kommentar geteilt — drei 🚨🔥👉-Marker in seiner bisherigen Pit-Kommunikation signalisieren "relevantes neues Wissen, sofort wikifyen".
> **Primärquellen:**
> - Reddit-Post: https://www.reddit.com/r/WebAfterAI/comments/1u6mge2/google_cloud_just_released_okf_think_mcp_but_for/
> - Google Cloud Blog: https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing
> - OKF SPEC v0.1: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md
> - Knowledge Catalog Repo: https://github.com/GoogleCloudPlatform/knowledge-catalog

## Warum das Pit interessiert (unsere direkte Relevanz)

**Unser RamaDama-Repo (knowledge-base) ist exakt nach dem Muster aufgebaut, das OKF jetzt formalisiert.** Die `AGENTS.md` zitiert Karpathys [LLM-Wiki-Gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) als konzeptuelle Grundlage, und unsere Frontmatter-Standards (siehe `AGENTS.md` Section "Frontmatter Standards") sind strukturell kompatibel mit OKF. Pit hat in den letzten Wochen intensiv an der Wiki-Wartung gearbeitet — eine offizielle Standardisierung dieser Pattern durch Google ist für uns **direkt wertvoll**: Validierung + potentieller Konvergenzpunkt für Tooling + potentiell Migrationspfad zu mehr Provider-Support.

## TL;DR (Reddit-Post v0.1-Zusammenfassung)

OKF ist **kein Runtime, kein SDK, kein Agent-Framework, kein MCP-Konkurrent.** MCP ist ein Protokoll, mit dem Agenten Tools aufrufen und Aktionen ausführen. OKF ist das **gegenüberliegende Ende**: eine Konvention, wie man statisches Wissen aufschreibt, damit jeder Agent es lesen kann.

**In einem Bildschirm:**
- **Was:** Konvention für statisches Wissen als Directory aus Markdown-Dateien + YAML-Frontmatter
- **Nicht:** Runtime, SDK, Framework, MCP-Konkurrent
- **Vergleichbar mit:** Obsidian, Notion, Hugo, allen LLM-Wiki-Patterns der letzten 12 Monate
- **Differenz:** OKF pinnt die nötigen Konventionen fest, damit **verschiedene Tools das gleiche Bundle lesen** können ohne Translation-Layer

## Was ist ein "Bundle"?

```
my_bundle/
├── index.md          # optional: directory listing for progressive disclosure
├── log.md            # optional: chronological history of changes
├── datasets/
│   └── sales.md
└── tables/
    ├── orders.md
    └── customers.md
```

Jedes `.md`-File = ein **"Concept"**. Concepts verlinken sich gegenseitig via Standard-Markdown-Links. Das ganze Bundle ist ein **Graph von Beziehungen**.

## Drei Designprinzipien (Google Cloud Blog)

1. **Minimally opinionated.** OKF verlangt **genau eine Sache** pro Concept: ein `type`-Feld. Alles andere (welche Types existieren, welche weiteren Felder, welche Body-Sections) bleibt dem Producer überlassen. Die Spec definiert die **Interoperabilitäts-Oberfläche**, nicht das Content-Model.
2. **Producer/Consumer independence.** Wer schreibt und wer liest sind sauber getrennt. Bundle von Menschen hand-geschrieben → von AI-Agent konsumiert. Bundle von Metadata-Export-Pipeline generiert → in Visualizer gebrowst. Bundle von einem LLM synthetisiert → von einem anderen abgefragt. **Format = Vertrag; Tooling an beiden Enden unabhängig austauschbar.**
3. **Permissive Conformance.** Consumers MÜSSEN unbekannte Types, fehlende Felder und broken Links tolerieren statt das Bundle abzulehnen. OKF soll nutzbar bleiben, wenn Bundles wachsen, refaktoriert oder teilweise von Agenten generiert werden.

## Was ein Concept tragen muss (aus SPEC.md)

### Frontmatter

**Pflicht:**
- `type` — kurzer String, identifiziert die Art des Concepts. Consumers nutzen es für Routing, Filter, Darstellung. Beispiele: `BigQuery Table`, `BigQuery Dataset`, `API Endpoint`, `Metric`, `Playbook`, `Reference`.

**Empfohlen (in Prioritäts-Reihenfolge):**
- `title`
- `description`
- `resource`
- `tags`
- `timestamp`

Type-Werte sind **nicht zentral registriert**. Producers SOLLEN deskriptive/self-explanatory Werte wählen; Consumers MÜSSEN unbekannte Types graceful behandeln (typischerweise als generic concepts).

### Citations (Section 8)

Wenn ein Concept-Body Claims aus externem Material macht, sollten diese unter `# Citations` Heading am Dokumentende gelistet sein, nummeriert. Citation-Links können absolute URLs, bundle-relative Pfade oder Pfade in `references/`-Subdirectory sein, das externes Material als first-class OKF Concepts spiegelt.

## Conformance-Regel (Section 9)

Ein Bundle ist OKF v0.1 konform wenn:
- Jedes non-reserved `.md`-File hat einen parseable YAML-Frontmatter-Block
- Jeder Frontmatter-Block hat ein non-empty `type` Feld
- `index.md` und `log.md` sind die einzigen erlaubten Frontmatter-Dateien (reserviert)

Alle anderen Constraints sind **soft guidance**. Consumers dürfen ein Bundle NICHT ablehnen wegen: unbekannter Types, fehlender `index.md`. **Permissive consumption model is intentional.**

## Versioning (Section 11)

- Document spezifiziert OKF version 0.1
- Künftige Revisionen: `<major>.<minor>`-Format
- Bundles KÖNNEN OKF-Version im bundle-root `index.md` Frontmatter deklarieren via `okf_version: "0.1"`
- Consumers, die deklarierte Version nicht verstehen, SOLLEN best-effort consumption versuchen statt das Bundle abzulehnen

## Drei Wege, OKF zu nutzen (Reddit-Post-Highlights)

> "How to pick if you only try one: Start with workflow 1. Hand-author a five-file bundle for one messy corner of your system and point your agent at it. It takes ten minutes, it is just markdown, and it shows you the actual value (and the actual limits) before you invest in generating or consuming at scale."

### Workflow 1: Hand-author a small bundle
Manuell 3-5 Markdown-Files für eine "messy Ecke" des Systems schreiben, Agent drauf zeigen. Schnellster Einstieg, zeigt Wert und Limits in 10 Minuten.

### Workflow 2: Generate from existing schema
Wenn Schema zu groß zum Hand-Schreiben ist: Pipeline, die bestehende Strukturen (DB-Schemas, API-Specs, Notion-Wikis) als OKF-Bundle exportiert. **Achtung:** Disziplin für Citations nötig, sonst verliert das Bundle an Wert.

### Workflow 3: Consume a bundle without blowing your context window
Große Bundles komplett in den Context zu laden ist teuer und noisy. OKFs Antwort: **optional `index.md`** — plain directory listing (ohne Frontmatter), das dem Agent zeigt, was existiert. Agent liest Index, folgt Links, zieht einzelne Concepts on-demand.

## Google Cloud Knowledge Catalog Update

Google Cloud hat den **Knowledge Catalog** aktualisiert, um OKF zu ingestieren und an Agents auszuliefern. Drei ready-to-browse Sample Bundles werden mitgeliefert:
- **GA4 e-commerce** — [Google Analytics BigQuery Demo Dataset](https://developers.google.com/analytics/bigquery/web-ecommerce-demo-dataset)
- **Stack Overflow** — [Pantheon Marketplace](https://pantheon.corp.google.com/marketplace/product/stack-exchange/stack-overflow)
- **Bitcoin public datasets** — [BigQuery Public Datasets](https://cloud.google.com/blog/topics/public-datasets/bitcoin-in-bigquery-blockchain-analytics-on-public-data)

Diese Bundles werden vom **Reference Agent** produziert und im Repo als lebende Beispiele konformen OKFs committed.

## Relationship to other formats (Section 10)

OKF ist absichtlich nahe an mehreren etablierten Patterns:
- **Karpathy LLM-Wiki** — gleiche Grundidee (raw → LLM → wiki → Q&A)
- **Obsidian / Notion / Hugo** — Markdown-First-Ansatz
- **AGENTS.md** — Schema-on-Read für AI-Agent-Konsum
- **CLAUDE.md** — Agent-Kontext-Konvention

OKF unterscheidet sich primär durch **Spezifikation** — pinnt die nötige Regelmenge fest für Interoperabilität, ohne Tooling zu diktieren.

## Konkrete nächste Schritte für uns

1. **Schema-Review:** Stimmt unser AGENTS.md-Frontmatter-Schema mit OKF v0.1 überein? (`type` als Pflichtfeld, `title`/`description`/`tags` empfohlen — check ✅)
2. **`# Citations`-Section einführen:** Optional, aber OKF-Standard. Citations am Ende jedes Wiki-Pages mit nummerierten Links.
3. **`okf_version: "0.1"` in root-index.md** deklarieren (einzige Stelle, wo `index.md` Frontmatter haben darf).
4. **Producer/Consumer-Trennung prüfen:** Ist unsere Wiki-Pipeline wirklich sauber getrennt? Raw → Subagent-Prozessor → Wiki. Ja, das passt.
5. **Tooling-Optionen evaluieren:** Reference Implementation unter [github.com/GoogleCloudPlatform/knowledge-catalog](https://github.com/GoogleCloudPlatform/knowledge-catalog) — Lint-Tools, Bundle-Generators, Visualizer. Beobachten.

## Externe Primärquellen

- **Google Cloud Blog (Ankündigung):** https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing
- **OKF SPEC v0.1:** https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md
- **OKF Reference Implementation:** https://github.com/GoogleCloudPlatform/knowledge-catalog
- **Karpathy LLM-Wiki Gist (Original-Idee):** https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
- **Search Engine Journal Coverage:** https://www.searchenginejournal.com/google-cloud-announces-the-open-knowledge-format/579253
- **Note.com Deep-Dive (japanisch/englisch):** https://note.com/ai_driven/n/n8e2726b98180
- **Reddit Original-Post:** https://www.reddit.com/r/WebAfterAI/comments/1u6mge2/google_cloud_just_released_okf_think_mcp_but_for/
- **Pit-Share in OME:** https://t.me/c/3839640481/13/6697