---
type: concept
title: Open Knowledge Format (OKF)
description: The frontmatter-plus-cross-link convention this knowledge base uses so AI agents and search engines can traverse SearchAudit's ecosystem as a graph.
resource: https://searchaudit.io/okf/README.md
tags: [concept, okf, knowledge-graph, meta]
timestamp: 2026-07-26T00:00:00Z
---

# Open Knowledge Format (OKF)

**OKF** is the lightweight convention this `/okf` knowledge base follows: every file is a
Markdown node with mandatory YAML frontmatter and explicit `[[wikilink]]` cross-links, so the
directory forms a traversable **knowledge graph** for both AI coding agents and AI search
engines.

## Mandatory frontmatter keys

| Key | Meaning |
| --- | --- |
| `type` | Node kind: `entity`, `concept`, `guide`, `task`, or `index`. |
| `title` | Human-readable name. |
| `description` | One-sentence summary (used by crawlers as the node abstract). |
| `resource` | A live URL/endpoint/schema this node maps to (kept dynamic, not hard-coded). |
| `tags` | Array of lowercase topic tags. |
| `timestamp` | ISO-8601 last-updated time. |

Compliance is enforced by [[validate-frontmatter]].

## Directory shape

- `entities/` — brand, products, services (map to schema.org via `resource`).
- `concepts/` — the ideas the product is built on (this file, [[ai-search-visibility]]).
- `guides/` — how-tos (e.g. [[interpreting-your-ai-visibility-score]]).
- `tasks/` — runnable/agent tasks (e.g. [[validate-frontmatter]]).

Agent rules for reading/appending live in `CLAUDE-okf.md` at the repo root. Index: [[README]].