OKF Builder Reference / Open Knowledge Format v0.1, explained for builders OKF v0.1
OKF OpenKnowledgeFormat

Comparison

OKF vs AGENTS.md

AGENTS.md tells coding agents how to work in a repository. OKF maps the knowledge inside and around a system.

Question
OKF
AGENTS.md
Primary job
Describes concepts, metrics, APIs, systems, operational knowledge, and how they connect.
Gives repository-specific instructions to coding agents.
Audience
Humans, AI agents, catalogs, search tools, and documentation teams.
Coding agents working inside a repo.
Durability
Portable bundle that can travel between repos and tools.
Repo-local working instructions.

When to use OKF

Use OKF when you want structured knowledge about a system or domain, especially where relationships between concepts matter.

When to use AGENTS.md

Use AGENTS.md when you want coding agents to follow local repo rules.

How they work together

AGENTS.md can tell agents how to work; OKF can explain what the product, systems, and metrics mean and how they relate.