Skip to Content

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 revenue

Standard fields

FieldRequiredDescription
typeYesThe kind of concept, from the semantic vocabulary.
titleNoA short name for the concept.
descriptionNoOne sentence on what the concept is.
tagsNoUp to 10 keywords.
generatedNoWhat wrote the file, and when.
statusNostable when confidence is at least 0.85, otherwise draft.
sourcesNoWhere the concept came from, down to the chunk.

The docklee block

FieldDescription
entity_refsUp to 20 people, products, systems, and other things the concept mentions.
relationshipsUp to 15 typed, directed links to other concepts, each with a target, a type, and a confidence.
confidenceHow sure Docklee is about the concept, from 0 to 1.
authorityprimary 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

SectionHolds
DefinitionWhat the concept is. Always present.
Key FactsStandalone facts about the concept, when there are any.
RelationshipsThe concept's links, in words, when there are any.

How the fields are used

FieldUsed for
title, type, tags, descriptionFinding entry concepts, with title weighted most
typeKeeping only concepts that fit the question
relationshipsFollowing links to related concepts
confidence, authorityRanking
statusTelling settled concepts from drafts

Next steps

You know what a concept holds. See every type and link next.

On this page