Skip to Content

Core Concepts

What is OKF

Google defined a format for writing knowledge down. Docklee turns that format into retrieval your app can ask questions of.

In June 2026, Google Cloud published the Open Knowledge Format, an open, vendor-neutral way to write down what an organization knows: its tables, metrics, APIs, policies, and runbooks, as linked Markdown files. OKF standardizes how knowledge is written. It doesn't define how to find anything in it.

Docklee closes that gap. The same way vector RAG turned a pile of documents into something a model can search, Docklee turns OKF into retrieval. You send content, Docklee builds the OKF for you, and your app asks questions through the same calls it uses for any engine.

From documents to answers, two ways

Vector RAG, the approach most knowledge products use today, works like this:

  1. 01SplitCut documents into chunks.
  2. 02EmbedTurn every chunk into a vector.
  3. 03MatchFind the chunks closest to the question.
  4. 04AnswerHand those chunks to the model.
Vector RAG finds passages that sound like the question.

Docklee OKF retrieval works like this:

  1. 01BuildTurn content into typed concepts and typed links.
  2. 02EnterMatch the question to the right concepts.
  3. 03WalkFollow links up to three steps out.
  4. 04AnswerRank by authority and return tight context.
Docklee OKF retrieval finds the concepts a question is about, then follows how they connect.

Your code doesn't change between the two. You link an OKF source to an engine and call lynk.query or lynk.retrieve, exactly as you would for a vector source. See Query OKF.

Format, retrieval, or both

Vector RAGOKF on its ownDocklee OKF retrieval
What it isA way to search documentsA file formatA retrieval layer built on the format
Turns your content into itYesNo. You write the files yourself.Yes, from documents, apps, and Dock writes
Answers questionsYesNoYes
Follows relationshipsNoLinks exist, but nothing follows themYes, across several steps
Knows what's currentNoNoYes. Superseded concepts are dropped.
Shows why a result was returnedNoNoYes, as the path of links
Needs an embedding for every chunkYesNoNo. Structural questions need none.
PortableNoYesYes. Export the bundle at any time.

The format

An OKF bundle is a folder of Markdown files:

PartWhat it is
Concept fileOne file per concept, such as a policy, a product, a team, or a metric.
FrontmatterStructured fields at the top of each file: its type, title, description, and tags.
BodyThe concept itself, in plain Markdown.
LinksReferences from one concept to another. Together they form a graph.
FoldersGroup related concepts by domain, such as engineering or finance.

A folder of photos tells you what each photo shows. A family tree also tells you how everyone is related. OKF is the family tree.

What Docklee adds

The format deliberately leaves the hard parts open. Docklee fills each one:

The format leaves openDocklee adds
Creating concepts from content you already haveGeneration from your documents, apps, and Dock writes. See Generate OKF.
What kinds of concepts and links existA shared vocabulary of 43 concept types and 31 relationship types. See Semantic vocabulary.
How far to trust a conceptConfidence, authority, and status on every concept. See Concept files.
What to do when concepts disagreeDuplicate merging, conflict markers, and supersession. See Merging and conflicts.
Searching a large bundleRetrieval that finds entry concepts, follows links, and ranks by authority. See How OKF retrieval works.
Using OKF for memory, not only documentsConcept graphs built from memory spaces. See OKF in memory.

Every file Docklee writes follows the published OKF format, so other OKF tools can read it. Docklee's additions sit in their own block that other tools ignore.

Your knowledge stays yours

  • Encrypted at rest. Concept files are encrypted with your workspace's key. The searchable index keeps concept bodies encrypted too, and only the few concepts that answer a question are decrypted.
  • Scoped to linked sources. An engine reads only the OKF sources linked to it, the same rule as vector sources.
  • Portable. Export your bundle as plain files and use it anywhere. See Export OKF.

Next steps

You know what OKF is and what Docklee builds on it. See how retrieval walks the graph next.

On this page