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

Use file-relative links such as ../tables/orders.md when bundles should render in GitHub and ordinary Markdown tools.

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
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