This page tells future agents how to maintain the Meta Museum knowledge wiki. The wiki is a persistent, compounding layer between raw sources and answers. Agents may write and update this layer, while raw sources and project evidence remain source-of-truth inputs.

Layers

| Layer | Project Location | Rule |

|---|---|---|

| Raw sources | Attachments, source URLs, evidence artifacts, project docs | Read only; do not rewrite source material. |

| Wiki bundle | `docs/knowledge/` | Agent-maintained summaries, concept pages, cross-links, and synthesis. |

| Schema | This page plus `CLAUDE.md` | Defines conventions, checks, and update workflows. |

OKF Conventions

• `index.md` files are progressive-disclosure navigation files.
• `log.md` files are chronological history files.
• Every other `.md` file is a concept document and must start with YAML frontmatter containing a non-empty `type`.
• Recommended concept frontmatter: `title`, `description`, `resource`, `tags`, and `timestamp`.
• Prefer relative links inside the bundle when they also need to render well in the project docs UI; bundle-root links are acceptable when the OKF graph is the primary consumer.
• Claims from external sources should include a `# Citations` section.

Ingest Workflow

1. Read the new source and identify the durable concepts it changes.

1. Add or update one source summary under `sources/`.

1. Add or update concept pages under `concepts/`, `schema/`, or a more specific future directory.

1. Update `index.md` so agents can discover the new page without scanning the whole tree.

1. Append a newest-first entry to `log.md`.

1. Run `pnpm okf:check`; run wider tests when code or app behavior changes.

Query Workflow

1. Read `docs/knowledge/index.md` first.

1. Follow only the pages needed for the question.

1. Answer with links back to source summary or concept pages.

1. If the answer creates reusable synthesis, file it as a new concept page and log it.

Lint Workflow

Periodically check for:

• Concept files missing frontmatter or `type`.
• Broken or stale cross-links.
• Important repeated terms that deserve their own concept page.
• Contradictions between source summaries and concept synthesis.
• Log entries that describe work not reflected in `index.md`.

Citations

[1] Open Knowledge Format v0.1 specification

[2] Google Cloud OKF announcement

[3] LLM Wiki pattern note(../sources/llm-wiki-pattern-note.md)