Skip to main content

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.md files for progressive disclosure
  • optional log.md files 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 conventionDreamineering standardLocal rule
type frontmatterPage Typestype means page job: hub, concept, playbook, domain-map, and so on.
Markdown fileDocumentation Writing StandardA page must stand alone without private project context.
File path as identityNaming StandardsRoute and filename are stable semantic handles.
index.md hierarchyIndex Page Standard and Hub Index TemplateIndex pages route before they teach.
YAML frontmatterWiki SchemaFrontmatter is queryable map data, not decoration.
Markdown linksInformation Architecture StandardLinks should carry scent and typed relationship intent.
log.md historyWiki-log patternPublic 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:

  • type exists and matches Page Types
  • title and description explain 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

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?