← Documentation home

Canonical Markdown source · Oct 20, 2018

Summary

knowledge/sources/open-knowledge-format-google-2026-06-12.md · 38 lines · SHA-256 a87b065f97db

Google Cloud announced Open Knowledge Format (OKF) as a vendor-neutral format for representing curated context that humans and AI agents can both read. The announcement frames OKF as a formalization of the LLM-wiki pattern: a directory of Markdown documents with YAML frontmatter and normal cross-links.

Key Takeaways

  • OKF is a format, not a service: no required SDK, runtime, or cloud account.
  • A knowledge bundle is a directory tree of Markdown files.
  • Concept documents use YAML frontmatter for queryable metadata such as `type`, `title`, `description`, `resource`, `tags`, and `timestamp`.
  • Cross-links between concept documents form a graph that agents can traverse without bespoke integration.
  • The initial reference ecosystem includes a producer agent, a static HTML visualizer, and sample bundles.
  • The format is intended to evolve from v0.1 through open contribution and backward-compatible growth.

Project Implications

Meta Museum already has most of the needed substrate:

  • Canonical Markdown docs under `docs/`.
  • Agent-maintainer instructions in `CLAUDE.md`.
  • Public docs consumers at `/docs`, `/api/docs/manifest`, and `/api/docs/content`.
  • Evidence artifacts and standards ledgers that can be summarized into stable concept pages.

The smallest useful adoption path is to maintain an OKF-style bundle under `docs/knowledge/`, validate it with `pnpm okf:check`, and let future source ingests update concept pages instead of scattering context across chat history.

Citations

[1] Google Cloud: Introducing the Open Knowledge Format

[2] Open Knowledge Format v0.1 specification