# Concept files (/docs/okf/concept-files)
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.

<Illustration
  src="/illustrations/okf/okf-concept-file.webp"
  alt="A single concept file with structured fields and tags at the top and a body of text below, with three links leading out to other concepts."
  width={1774}
  height={887}
/>

## An example [#an-example]

```markdown
---
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 [#standard-fields]

| Field | Required | Description |
| --- | --- | --- |
| `type` | Yes | The kind of concept, from the [semantic vocabulary](/docs/okf/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 [#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 [#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 [#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 [#next-steps]

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

<Cards>
  <Card title="Semantic vocabulary" href="/docs/okf/semantic-vocabulary" description="Every concept type and link type." />
  <Card title="Merging and conflicts" href="/docs/okf/merging-and-conflicts" description="How concepts are kept consistent." />
  <Card title="Export OKF" href="/docs/okf/export-okf" description="Download your bundle." />
</Cards>
