OKF Builder Reference / Open Knowledge Format v0.2, explained for builders OKF v0.2
OKF OpenKnowledgeFormat

Validator

Validate an OKF bundle

Paste Markdown, upload individual .md files, or select a folder. The validator checks OKF v0.2 conformance and reports advisory findings for provenance, trust, lifecycle, computations, and links.

Input

Validate Markdown.

.md only

Coverage

Checks parseable frontmatter, required types, recommended metadata, v0.2 trust and provenance fields, computation contracts, filenames, and internal Markdown links.

Version coverage

What the OKF v0.2 validator checks.

The validator separates required concept-file rules from metadata guidance so teams can fix blocking issues first and improve bundle quality next.

Review source references

Required checks

  • Concept files must contain parseable YAML frontmatter.
  • Frontmatter must be an object/map of keys and values.
  • Every non-reserved concept file needs a non-empty type.

Guidance checks

  • Recommended descriptive metadata includes title, description, resource, and tags.
  • Optional v0.2 fields include sources, generated, verified, status, stale_after, and computation contracts.
  • Past stale_after dates and verification events older than the current content are surfaced for review.
  • Legacy timestamp and body Citations forms receive migration warnings.
  • Tags should be an array for predictable filtering.
  • File-relative and bundle-root Markdown links are checked for missing targets.

Permissive behavior

  • Reserved files follow their index or dated-log body structures without concept frontmatter.
  • The root index.md may declare okf_version: "0.2" frontmatter.
  • Unknown fields and extension keys are allowed.
  • Non-Markdown files are ignored during validation.

Next step

Start from a known-good structure.

Mathias Onea

Mathias Onea

Senior Engineer, Product Builder, and Founder

Systems, product software, and practical execution for teams that need clear decisions, durable implementation, and agent-ready knowledge structures.

Focus
Knowledge systems, Laravel platforms, automation, and technical SEO infrastructure.
Related work
Founder-led software work through Craftwell and independent open-source projects.
Profile
mathiasonea.com