okf-project-knowledge-base

# OKF Project Knowledge Base Durable project knowledge - decisions with rationale, findings with evidence, rules with what they protect against - lives in the repository as an [Open Knowledge Format (OKF) v0.2](https://github.com/GoogleCloudPlatform/open-knowledge-format) bundle: plain Markdown concepts with YAML frontmatter, readable by humans, parseable by any agent, diffable in git. This skill is the discipline for creating, writing, reading, and maintaining such bundles. It standardizes the mechanics; without it every model invents its own incompatible structure. ## Finding the bundle A bundle root is any directory whose `index.md` declares `okf_version` in its frontmatter. That marker, not the path, is authoritative: to discover bundles, search the repository's `index.md` files for `okf_version`. The canonical location for a NEW bundle is `docs/knowledge/` at the scope it serves - the repo root for project knowledge, `<subproject>/docs/knowledge/` for a subproject - but respect existing bundles wherever they live (`knowledge/` at the root is a common alternative). ## The local law Before reading or writing anything else, read the bundle's root `index.md`. Its preamble states what belongs in this bundle and its local conventions (type vocabulary, directory layout). The preamble may tighten or loosen the rules below for its bundle; only the instructions fence is never relaxed. ## Three fences Route by what the information is about, never by how you discovered it. A ...