jackwener/llm-wiki/ingest

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

1. Locate the vault by finding .llm-wiki/config.toml.
2. Read wiki-purpose.md, wiki-schema.md, and wiki-agent.md when present.

The latter defines vault-specific MUST / MAY / NEVER ingest criteria.

1. Skip material that the agent policy excludes, contains credentials or

personal data, or duplicates existing knowledge.

1. If the vault is empty, agree with the user on language, page layout,

directory structure, and filename conventions before creating pages.

1. If the material would change established scope, page boundaries, naming, or

linking strategy, present the proposed structure before editing. Apply straightforward additions directly.

Workflow

1. Check wiki/, wiki-log.md, and llm-wiki search for prior ingestion of

the source or its topics. Re-ingest only changed or newly useful material.

1. 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.

1. Extract claims, entities, decisions, open questions, and relationships.
2. Create or merge focused pages in wiki/. Every page needs the fields

required by wiki-schema.md; normally this includes:

```yaml

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.

1. Merge rather than overwrite. When sources conflict, preserve both claims,

identify their sources, and flag the conflict rather than silently choosing one.

1. Add [[wikilinks]] for related entities, including useful not-yet-created

pages, and finish each page with a ## Related section.

1. Append a concise ## [YYYY-MM-DD] ingest | … entry to wiki-log.md with

pages created or updated.

1. Run llm-wiki sync after the changes.

Quality bar

• Summarize rather than copy source text.
• Keep every claim traceable through sources frontmatter.
• Keep each page about one topic; split pages that become multi-topic.
• Write in the language specified in .llm-wiki/config.toml.