Agent Knowledge

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.

Concepts

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.

Spec

The OKF v0.2 specification, one page per section. (This bundle documents v0.2 but is still authored in v0.1 — see Changes from v0.1.)

• OKF Specification Overview - what OKF is and how these pages map to the spec.
• Motivation - why standardize on markdown + frontmatter.
• Terminology - bundle, concept, frontmatter, body, link, source, actor, trust tier.
• Bundle Structure - a directory tree of markdown files.
• Reserved Filenames - index.md and log.md.
• Frontmatter - required, recommended, and optional families.
• Body - conventional headings, no required sections.
• Provenance, Trust & Lifecycle - sources, generated, verified, status, stale_after (§5).
• Provenance (sources) - the sources list and per-claim footnote attribution (§5.1).
• Actor Convention - <producer>/<version>, human:<id>, process:<id> (§7).
• Cross-linking & Paths - markdown links as edges; path-valued fields; references/ (§6).
• Index Files - directory listings for progressive disclosure.
• Log Files - date-grouped change history.
• Attested Computations - a sanctioned, checkable way to compute a value (§10).
• Conformance - what makes a bundle conformant.
• Versioning - <major>.<minor> and okf_version.
• Changes from v0.1 - the v0.1 → v0.2 delta.

Operations

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.

Implementations

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.

Ecosystem

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.

Design

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.

References

External source material this bundle is compiled from.

• OKF Specification (SPEC.md) - the OKF v0.2 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.