open-knowledge-format

Open Knowledge Format (OKF)

An OKF v0.2 bundle is a folder of markdown concept files. Each concept starts with YAML frontmatter, and type is its only required field. index.md files list a folder's concepts and log.md records changes; neither is a concept. Links that start with / resolve from the bundle root, such as /playbooks/deploy.md; other links resolve from the file that contains them.

Reading

1. Start at the bundle root index.md and follow indexes and links to the concepts you need.
2. Tell the user what the frontmatter says about each concept you rely on:

1. Cite concept paths in your answer.
2. For type: Attested Computation, use its # Computation block, or the file its computation key names, exactly as written, and supply only values for its declared parameters.

Writing

New concepts get this frontmatter shape; when you edit a concept, keep all its existing keys and values and change only what the edit requires:

---
type: Playbook                    # required; keep the existing type when editing
title: "Payments: rotate the signing key"
description: "One sentence, reused in index.md."
tags: [payments, security]
generated: { by: "@analyst:example.org/gpt-6-luna", at: 2026-10-03T18:30:00-07:00 }
status: stable                    # stable, draft, or deprecated; no other values
sources:
  - id: ops-412
    resource: OPS-412             # required in every source: URL, bundle path, ticket, or "chat with @alice:example.org"
    title: "Ticket OPS-412: key rotation"
    author: human:@alice:example.org
---