Build OKF
Concept files
What every concept file holds, from the standard fields to the confidence, authority, and links Docklee adds.
Each concept in an OKF bundle is one Markdown file. The standard fields make it readable by any OKF tool. A docklee block adds what engines need to rank and reason: confidence, authority, entities, and typed links.
An example
---
type: database-table
title: Orders
description: Every completed customer order, one row per order.
tags: [sales, orders, revenue]
generated: { by: docklee/knowledge-loop-v1, at: 2026-11-04T09:12:44Z }
status: stable
sources:
- id: document-12
resource: document://9f2c41e7/chunk-12
title: Source chunk 12 from document
docklee:
entity_refs: [orders, customers, revenue]
relationships:
- target: /engineering/customers
type: joins-with
confidence: 0.97
- target: /finance/monthly-revenue
type: feeds-into
confidence: 0.91
confidence: 0.94
authority: primary
---
# Definition
Every completed customer order, one row per order.
# Key Facts
- Joins the customers table on `customer_id`.
- Feeds the monthly revenue metric.
# Relationships
- joins-with: Customers
- feeds-into: Monthly revenueStandard fields
| Field | Required | Description |
|---|---|---|
type | Yes | The kind of concept, from the semantic vocabulary. |
title | No | A short name for the concept. |
description | No | One sentence on what the concept is. |
tags | No | Up to 10 keywords. |
generated | No | What wrote the file, and when. |
status | No | stable when confidence is at least 0.85, otherwise draft. |
sources | No | Where the concept came from, down to the chunk. |
The docklee block
| Field | Description |
|---|---|
entity_refs | Up to 20 people, products, systems, and other things the concept mentions. |
relationships | Up to 15 typed, directed links to other concepts, each with a target, a type, and a confidence. |
confidence | How sure Docklee is about the concept, from 0 to 1. |
authority | primary at confidence 0.90 and above, secondary from 0.75, otherwise derived. |
Other OKF tools ignore the docklee block, so a bundle stays valid everywhere.
The body
| Section | Holds |
|---|---|
| Definition | What the concept is. Always present. |
| Key Facts | Standalone facts about the concept, when there are any. |
| Relationships | The concept's links, in words, when there are any. |
How the fields are used
| Field | Used for |
|---|---|
title, type, tags, description | Finding entry concepts, with title weighted most |
type | Keeping only concepts that fit the question |
relationships | Following links to related concepts |
confidence, authority | Ranking |
status | Telling settled concepts from drafts |
Next steps
You know what a concept holds. See every type and link next.