| okf_version | 0.1 |
|---|
A knowledge bundle about the Open Knowledge Format (OKF) and the LLM Wiki pattern it formalizes. This bundle is written in OKF so the repository doubles as a worked, self-demonstrating example: to see what a conformant bundle looks like, browse the files here.
The purpose of this bundle is to collect and cross-link everything we know about OKF and the LLM Wiki pattern before building the portable agent skills that will create and maintain bundles like this one.
The ideas behind the pattern — what an LLM Wiki is and why it works.
- LLM Wiki - a persistent, LLM-maintained knowledge base that compiles knowledge once and keeps it current.
- Three-Layer Architecture - raw sources, the wiki, and the schema.
- Compounding Artifact - why a persistent wiki beats query-time retrieval.
- Progressive Disclosure - navigating a bundle one level at a time via index files.
- RAG vs. LLM Wiki - retrieval every query vs. compile once, maintain forever.
- Memex - Vannevar Bush's 1945 antecedent, and the maintenance problem the LLM solves.
- Knowledge Bundle - the OKF term for a directory of concept documents.
- Concept Document - the OKF term for a single markdown-plus-frontmatter file.
The OKF v0.1 specification, one page per section.
- OKF Specification Overview - what OKF is and how these pages map to the spec.
- Motivation - why standardize on markdown + frontmatter.
- Terminology - bundle, concept, concept ID, frontmatter, body, link, citation.
- Bundle Structure - a directory tree of markdown files.
- Reserved Filenames -
index.mdandlog.md. - Frontmatter - required and recommended keys.
- Body - conventional headings, no required sections.
- Cross-linking - absolute and relative markdown links as edges.
- Index Files - directory listings for progressive disclosure.
- Log Files - date-grouped change history.
- Citations - external sources under a numbered heading.
- Conformance - what makes a bundle conformant.
- Versioning -
<major>.<minor>andokf_version.
The LLM Wiki workflows the skills will implement.
- Ingest - read a source, extract signal, integrate it across the wiki.
- Query - navigate, synthesize an answer, and file valuable answers back.
- Lint - health-check the bundle for drift, orphans, and gaps.
Existing instantiations of the pattern.
- personal work wiki - a working personal work wiki with ingest/query/lint/status skills.
- the OKF-native agent - a private, OKF-native deployable agent — prior art for the format-first direction.
What others are building — the 200+ projects and debates that followed Karpathy's gist.
- Ecosystem Overview - how to read the landscape and the featured projects.
- Landscape - the categories of implementations and where OKF sits.
- Critiques & Open Problems - truth maintenance, token cost, markdown-vs-database.
Our own analysis informing the build — synthesis about the format, not source material.
- Skill Design — the kb-* family - the build plan for our skills, designed with the writing-great-skills framework.
- Lessons from the OKF Sample Bundles - what the ga4/stackoverflow/crypto_bitcoin bundles teach about authoring conformant bundles.
- OKF Spec Evolution - what the open PRs reveal about where v0.1 is still in flux, and the resulting decisions.
External source material this bundle is compiled from.
- OKF Specification (SPEC.md) - the OKF v0.1 spec on GitHub.
- OKF README & Reference Agent - the reference agent, enrich, and visualize commands.
- Karpathy — LLM Wiki gist - the idea file that originated the pattern.
- qmd - local markdown search engine (BM25 + vector + LLM re-rank).
- OKF vs. RAG — infographic - a two-panel explainer/marketing visual of the RAG-vs-OKF contrast.