Open Knowledge Format Mapping
Open Knowledge Format is useful because it validates the wiki as an agent-readable knowledge bundle: markdown files, YAML frontmatter, stable paths, normal links, and change logs.
The local rule is stricter than OKF. OKF defines the portable minimum. Dreamineering standards define the working contract for this wiki.
What OKF Adds
Google Cloud introduced Open Knowledge Format on June 13, 2026 as an open specification for portable AI context. The core shape is simple:
- a directory of markdown files
- one concept per file
- YAML frontmatter for queryable fields
- normal markdown links as graph edges
- optional
index.mdfiles for progressive disclosure - optional
log.mdfiles for chronological history
The article says OKF v0.1 is minimally opinionated: every concept needs a type field, while producers choose their own content model. That makes OKF a lowest-common-denominator exchange format, not a full writing standard.
Local Mapping
| OKF convention | Dreamineering standard | Local rule |
|---|---|---|
type frontmatter | Page Types | type means page job: hub, concept, playbook, domain-map, and so on. |
| Markdown file | Documentation Writing Standard | A page must stand alone without private project context. |
| File path as identity | Naming Standards | Route and filename are stable semantic handles. |
index.md hierarchy | Index Page Standard and Hub Index Template | Index pages route before they teach. |
| YAML frontmatter | Wiki Schema | Frontmatter is queryable map data, not decoration. |
| Markdown links | Information Architecture Standard | Links should carry scent and typed relationship intent. |
log.md history | Wiki-log pattern | Public pages teach current truth; the private wiki log records schema evolution. |
Design Decision
Treat OKF as an interoperability benchmark, not the source of truth.
Dreamineering pages should be easy to export toward OKF because they already use markdown, frontmatter, semantic paths, and links. They should not weaken their local contract to match OKF's minimum. A touched page still needs the stricter page-type/template match described in Page Types.
Use This When
- checking whether a playbook page is machine-readable enough for external agents
- designing an export, manifest, or bundle format
- explaining why
type,title,description, tags, links, and logs matter - comparing local wiki rules to open knowledge-sharing standards
Checks
An OKF-aligned Dreamineering page passes when these signals are visible:
typeexists and matches Page Typestitleanddescriptionexplain the page job- route and filename are stable semantic handles
- links have scent, not bare labels
- current truth lives in public docs, while schema evolution is logged privately
Failure Modes
- Minimum becomes ceiling — OKF requires
type, but the local page still needs the right page type and template. - Portable but weak — markdown exports cleanly, but links lack scent and agents cannot choose the next page.
- Path drift — the file path stops naming the concept clearly.
- Log leak — private evolution history appears in public teaching prose.
Source Trail
- Google Cloud: Introducing the Open Knowledge Format — source article for OKF v0.1.
- Page Types — local page-job authority.
- Wiki Schema — local Map-First edit and frontmatter contract.
- Information Architecture Standard — local placement, links, and answer-engine rules.
Context
- Purpose — the Tight Five root for why a page exists.
- Platform — where portable knowledge formats become useful infrastructure.
- Performance — how retrieval and answer quality should be measured.
Questions
What would fail if this wiki were exported as an OKF bundle tomorrow?
- Which page lacks a meaningful
type? - Which route depends on private context?
- Which links are present but carry no scent?
- Which generated projections need a portable manifest?