Google Open Knowledge Format (OKF v0.2)

Understanding the vendor-neutral OKF specification for agent-readable documentation.

ConceptSTABLE•1 source file

Google Open Knowledge Format (OKF v0.2)

The Open Knowledge Format (OKF) is an open specification introduced by Google Cloud to formalize how organizational and codebase knowledge is structured, packaged, and traversed by AI agents.

Core Principles

  1. Human & Machine Co-Readability: Plain Markdown files with standard YAML frontmatter blocks.
  2. Deterministic Context Retrieval: Standardized fields (type, tags, sources, generated, verified) allow AI agents to navigate knowledge without hallucinations.
  3. Graph Interoperability: Hyperlinks between concept files form a queryable directed graph.

Frontmatter Example

---
type: Module
title: "Authentication Service"
description: "OAuth2 and JWT token lifecycle management."
tags: [auth, security, tokens]
status: stable
stale_after: 2026-12-31T23:59:59Z

sources:
  - uri: "src/auth/service.ts"
    author: "process:git-scanner"
    last_modified: 2026-08-16T12:00:00Z

generated:
  by: "openkb/opencode"
  at: "2026-08-16T14:30:00Z"

verified:
  - by: "human:lead-architect"
    at: "2026-08-16T16:00:00Z"
---

Supported Concept Types