{"id":"knowledge/concepts/open-knowledge-format","relativePath":"knowledge/concepts/open-knowledge-format.md","title":"Definition","markdown":"\n\n# Definition\n\nOpen Knowledge Format (OKF) is a draft v0.1 specification for packaging knowledge as a directory of Markdown files with YAML frontmatter. Its core purpose is interoperability: producers can write knowledge once, and humans or agents can consume it without a custom SDK.\n\n# Structure\n\n| Element | Meaning |\n|---|---|\n| Knowledge bundle | A directory tree of Markdown files. |\n| Concept | One non-reserved Markdown file representing one unit of knowledge. |\n| Concept ID | The concept file path without the `.md` suffix. |\n| Frontmatter | YAML metadata at the top of a concept file. |\n| Body | Free-form Markdown, preferably structured with headings, lists, tables, and citations. |\n| Link | A normal Markdown link that creates a directed relationship in the bundle graph. |\n\n# Conformance Boundary\n\nFor OKF v0.1, the hard conformance surface is intentionally small:\n\n- Non-reserved concept files need parseable frontmatter.\n- Concept frontmatter needs a non-empty `type`.\n- `index.md` and `log.md` are reserved files with special navigation/history roles.\n- Consumers should tolerate unknown types, optional fields, missing indexes, and broken links.\n\n# Meta Museum Usage\n\nMeta Museum uses OKF as a project-knowledge layer under [docs/knowledge](../index.md). This bundle is for agent-readable synthesis about standards, decisions, workflows, and evidence. It complements, but does not replace, the canonical project docs, Linked Art records, ActivityStreams evidence, or partner artifacts.\n\n# Related\n\n- [LLM Wiki Pattern](llm-wiki-pattern.md)\n- [Meta Museum Knowledge System](meta-museum-knowledge-system.md)\n- [LLM Wiki Maintainer Schema](../schema/llm-wiki-maintainer.md)\n\n# Citations\n\n[1] [Open Knowledge Format v0.1 specification](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md)\n[2] [Google Cloud OKF announcement](../sources/open-knowledge-format-google-2026-06-12.md)\n","sections":[],"html":"<h1 id=\"definition\">Definition</h1>\n<p>Open Knowledge Format (OKF) is a draft v0.1 specification for packaging knowledge as a directory of Markdown files with YAML frontmatter. Its core purpose is interoperability: producers can write knowledge once, and humans or agents can consume it without a custom SDK.</p>\n<h1 id=\"structure\">Structure</h1>\n<p>| Element | Meaning |</p>\n<p>|---|---|</p>\n<p>| Knowledge bundle | A directory tree of Markdown files. |</p>\n<p>| Concept | One non-reserved Markdown file representing one unit of knowledge. |</p>\n<p>| Concept ID | The concept file path without the `.md` suffix. |</p>\n<p>| Frontmatter | YAML metadata at the top of a concept file. |</p>\n<p>| Body | Free-form Markdown, preferably structured with headings, lists, tables, and citations. |</p>\n<p>| Link | A normal Markdown link that creates a directed relationship in the bundle graph. |</p>\n<h1 id=\"conformance-boundary\">Conformance Boundary</h1>\n<p>For OKF v0.1, the hard conformance surface is intentionally small:</p>\n<ul><li>Non-reserved concept files need parseable frontmatter.</li><li>Concept frontmatter needs a non-empty `type`.</li><li>`index.md` and `log.md` are reserved files with special navigation/history roles.</li><li>Consumers should tolerate unknown types, optional fields, missing indexes, and broken links.</li></ul>\n<h1 id=\"meta-museum-usage\">Meta Museum Usage</h1>\n<p>Meta Museum uses OKF as a project-knowledge layer under docs/knowledge(../index.md). This bundle is for agent-readable synthesis about standards, decisions, workflows, and evidence. It complements, but does not replace, the canonical project docs, Linked Art records, ActivityStreams evidence, or partner artifacts.</p>\n<h1 id=\"related\">Related</h1>\n<ul><li>LLM Wiki Pattern(llm-wiki-pattern.md)</li><li>Meta Museum Knowledge System(meta-museum-knowledge-system.md)</li><li>LLM Wiki Maintainer Schema(../schema/llm-wiki-maintainer.md)</li></ul>\n<h1 id=\"citations\">Citations</h1>\n<p>[1] <a href=\"https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">Open Knowledge Format v0.1 specification</a></p>\n<p>[2] Google Cloud OKF announcement(../sources/open-knowledge-format-google-2026-06-12.md)</p>","updatedAt":"2018-10-20T01:46:40.000Z","checksum":"37e419de4736098be7a0c176be8a2b12e451e8c17ea8220f14ae13c55b6b760b","checksumPrefix":"37e419de4736","anchorCount":0,"lineCount":48,"rawUrl":"/api/docs/content?path=knowledge%2Fconcepts%2Fopen-knowledge-format.md","htmlUrl":"/docs?doc=knowledge%2Fconcepts%2Fopen-knowledge-format.md","apiUrl":"/api/docs/content?path=knowledge%2Fconcepts%2Fopen-knowledge-format.md"}