OKF Builder Reference
/
Open Knowledge Format v0.1, explained for builders
OKF v0.1
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.
okf/
|-- index.md
|-- log.md
`-- concepts/overview.md
SaaS app
Metrics, source tables, dashboards, lifecycle definitions, and operating playbooks.
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.
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.
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.
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.
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.
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.
okf/
|-- index.md
|-- systems/billing.md
|-- metrics/monthly-recurring-revenue.md
`-- playbooks/support-triage.md
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.
OKF OpenKnowledgeFormat
OpenKnowledgeFormat.com documents OKF concepts, examples, validation rules, templates, and implementation patterns for builders.
Last updated 2026-07-17
Resource submission
Submit an OKF resource
Close
Submission received
Thank you for submitting an OKF resource.
It has been saved for review.
Close
Source suggestion
Suggest an OKF source
Close
Suggestion received
Thank you for suggesting an OKF source.
It has been saved for review.
Close