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

Templates

OKF templates

Copy recommended file structures for common knowledge bundles, then add concept files with required type frontmatter and links between related concepts.

1. Root index

Use index.md to list the bundle contents for progressive disclosure.

2. Concepts

Create one non-reserved Markdown file per metric, table, API, playbook, process, or idea.

3. Links

Prefer bundle-relative links such as /tables/orders.md when concepts relate.

4. Log

Use log.md when you want chronological updates for a bundle or directory.

Minimal knowledge bundle

Use a root index, a log, and one concept file with required type frontmatter.

Recommended structure

okf/
|-- index.md
|-- log.md
`-- concepts/overview.md

SaaS app

Metrics, source tables, dashboards, lifecycle definitions, and operating playbooks.

Recommended structure

okf/
|-- index.md
|-- log.md
|-- metrics/monthly-recurring-revenue.md
|-- tables/subscriptions.md
`-- playbooks/revenue-review.md

Laravel application

Routes, models, policies, jobs, commands, integrations, and operational notes as linked concepts.

Recommended structure

okf/
|-- index.md
|-- routes/api-customers.md
|-- models/user.md
|-- policies/customer-policy.md
`-- jobs/sync-stripe-customer.md

WordPress site

Post types, taxonomies, ACF fields, templates, plugins, and editorial workflows.

Recommended structure

okf/
|-- index.md
|-- post-types/product.md
|-- taxonomies/product-category.md
|-- acf/product-fields.md
`-- templates/single-product.md

API docs

Endpoints, schemas, errors, authentication, rate limits, and business constraints around an API spec.

Recommended structure

okf/
|-- index.md
|-- endpoints/create-customer.md
|-- schemas/customer.md
`-- errors/rate-limit.md

Data warehouse

Datasets, tables, metrics, lineage, dashboards, freshness rules, and quality checks.

Recommended structure

okf/
|-- index.md
|-- datasets/sales.md
|-- tables/orders.md
|-- tables/customers.md
`-- metrics/gross-revenue.md

Company knowledge base

Policies, teams, systems, recurring processes, and decision records.

Recommended structure

okf/
|-- index.md
|-- teams/support.md
|-- policies/refunds.md
`-- playbooks/incident-response.md

AI agent context bundle

Curated context an agent can traverse before working with tools, data, APIs, or code.

Recommended structure

okf/
|-- index.md
|-- systems/billing.md
|-- metrics/monthly-recurring-revenue.md
`-- playbooks/support-triage.md