Knowledge Bundle

July 1, 2026 · View on GitHub

A knowledge bundle (or just bundle) is the OKF unit of knowledge: a directory tree of markdown concept documents plus optional reserved index and log files. It is the OKF formalization of the "wiki" layer in the three-layer architecture.

See Bundle Structure for the normative rules. In short:

  • A bundle is just a directory — no manifest or database is required.
  • It can be distributed as a git repository (recommended), an archive (tar/zip), or a subdirectory of a larger repository. This repository uses the last form: the bundle lives in knowledge/.
  • Its internal organization is domain-independent; producers arrange concepts as they see fit.
  • It may declare its format version via okf_version in the root index file — see Versioning.

Because a bundle is plain markdown and YAML, anyone can produce one (people, agents on any framework, export pipelines) and anyone can consume one (file servers, Obsidian/Notion, LLMs, search indexes, graph viewers). This vendor-neutrality is the whole point of OKF.

Citations

  1. OKF Specification (SPEC.md)