{"id":"knowledge/schema/llm-wiki-maintainer","relativePath":"knowledge/schema/llm-wiki-maintainer.md","title":"Purpose","markdown":"\n\n# Purpose\n\nThis 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.\n\n# Layers\n\n| Layer | Project Location | Rule |\n|---|---|---|\n| Raw sources | Attachments, source URLs, evidence artifacts, project docs | Read only; do not rewrite source material. |\n| Wiki bundle | `docs/knowledge/` | Agent-maintained summaries, concept pages, cross-links, and synthesis. |\n| Schema | This page plus `CLAUDE.md` | Defines conventions, checks, and update workflows. |\n\n# OKF Conventions\n\n- `index.md` files are progressive-disclosure navigation files.\n- `log.md` files are chronological history files.\n- Every other `.md` file is a concept document and must start with YAML frontmatter containing a non-empty `type`.\n- Recommended concept frontmatter: `title`, `description`, `resource`, `tags`, and `timestamp`.\n- 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.\n- Claims from external sources should include a `# Citations` section.\n\n# Ingest Workflow\n\n1. Read the new source and identify the durable concepts it changes.\n2. Add or update one source summary under `sources/`.\n3. Add or update concept pages under `concepts/`, `schema/`, or a more specific future directory.\n4. Update `index.md` so agents can discover the new page without scanning the whole tree.\n5. Append a newest-first entry to `log.md`.\n6. Run `pnpm okf:check`; run wider tests when code or app behavior changes.\n\n# Query Workflow\n\n1. Read `docs/knowledge/index.md` first.\n2. Follow only the pages needed for the question.\n3. Answer with links back to source summary or concept pages.\n4. If the answer creates reusable synthesis, file it as a new concept page and log it.\n\n# Lint Workflow\n\nPeriodically check for:\n\n- Concept files missing frontmatter or `type`.\n- Broken or stale cross-links.\n- Important repeated terms that deserve their own concept page.\n- Contradictions between source summaries and concept synthesis.\n- Log entries that describe work not reflected in `index.md`.\n\n# Citations\n\n[1] [Open Knowledge Format v0.1 specification](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md)\n[2] [Google Cloud OKF announcement](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing)\n[3] [LLM Wiki pattern note](../sources/llm-wiki-pattern-note.md)\n","sections":[],"html":"

Purpose

\n

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.

\n

Layers

\n

| Layer | Project Location | Rule |

\n

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

\n

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

\n

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

\n

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

\n

OKF Conventions

\n\n

Ingest Workflow

\n
  1. Read the new source and identify the durable concepts it changes.
\n
  1. Add or update one source summary under `sources/`.
\n
  1. Add or update concept pages under `concepts/`, `schema/`, or a more specific future directory.
\n
  1. Update `index.md` so agents can discover the new page without scanning the whole tree.
\n
  1. Append a newest-first entry to `log.md`.
\n
  1. Run `pnpm okf:check`; run wider tests when code or app behavior changes.
\n

Query Workflow

\n
  1. Read `docs/knowledge/index.md` first.
\n
  1. Follow only the pages needed for the question.
\n
  1. Answer with links back to source summary or concept pages.
\n
  1. If the answer creates reusable synthesis, file it as a new concept page and log it.
\n

Lint Workflow

\n

Periodically check for:

\n\n

Citations

\n

[1] Open Knowledge Format v0.1 specification

\n

[2] Google Cloud OKF announcement

\n

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

","updatedAt":"2018-10-20T01:46:40.000Z","checksum":"1bc0cde6fa1e88e32315ca4e2d949986d7cac9ca88f0e1494b4aee8e0b70993a","checksumPrefix":"1bc0cde6fa1e","anchorCount":0,"lineCount":62,"rawUrl":"/api/docs/content?path=knowledge%2Fschema%2Fllm-wiki-maintainer.md","htmlUrl":"/docs?doc=knowledge%2Fschema%2Fllm-wiki-maintainer.md","apiUrl":"/api/docs/content?path=knowledge%2Fschema%2Fllm-wiki-maintainer.md"}