Ingest an LLM Wiki source
Turn a source into concise, attributable, interconnected wiki pages. The wiki
is the maintained knowledge layer; sources/ is the immutable evidence layer.
Before editing
- Locate the vault by finding
.llm-wiki/config.toml. - Read
wiki-purpose.md,wiki-schema.md, andwiki-agent.mdwhen present. The latter defines vault-specific MUST / MAY / NEVER ingest criteria. - Skip material that the agent policy excludes, contains credentials or personal data, or duplicates existing knowledge.
- If the vault is empty, agree with the user on language, page layout, directory structure, and filename conventions before creating pages.
- If the material would change established scope, page boundaries, naming, or linking strategy, present the proposed structure before editing. Apply straightforward additions directly.
Workflow
Check
wiki/,wiki-log.md, andllm-wiki searchfor prior ingestion of the source or its topics. Re-ingest only changed or newly useful material.Copy raw input to
sources/YYYY-MM-DD/, preserving its original name. Add a version suffix if needed. Once saved, never edit that copy. Split large chat logs or collections by date or topic before saving.Extract claims, entities, decisions, open questions, and relationships.
Create or merge focused pages in
wiki/. Every page needs the fields required bywiki-schema.md; normally this includes:--- title: Page Title description: One-line summary aliases: [alternate names] tags: [taxonomy tags] sources: [YYYY-MM-DD/source.md] created: YYYY-MM-DD updated: YYYY-MM-DD ---Bug or issue pages also need machine-readable
status: open | resolved | wontfix.Merge rather than overwrite. When sources conflict, preserve both claims, identify their sources, and flag the conflict rather than silently choosing one.
Add
[[wikilinks]]for related entities, including useful not-yet-created pages, and finish each page with a## Relatedsection.Append a concise
## [YYYY-MM-DD] ingest | …entry towiki-log.mdwith pages created or updated.Run
llm-wiki syncafter the changes.
Quality bar
- Summarize rather than copy source text.
- Keep every claim traceable through
sourcesfrontmatter. - Keep each page about one topic; split pages that become multi-topic.
- Write in the language specified in
.llm-wiki/config.toml.