Source Command Wiki Ingest

source-command-wiki-ingest

Use this skill when the user asks to run the migrated source command wiki-ingest.

Command Template

/wiki-ingest

Ingest a new source into the LLM Wiki. This is the most-used command.

The flow: read the source → discuss TL;DR and key claims with you → write a source summary page → update every relevant entity and concept page → flag contradictions → prove source coverage → update index.md → append to log.md.

A typical ingest touches 5-15 wiki pages. You (the user) are in the loop: the ingestor proposes changes and waits for your confirmation before writing.

Usage

/wiki-ingest <path>
/wiki-ingest raw/papers/monosemanticity.pdf
/wiki-ingest raw/articles/2026-04-01-interpretability-post.md

What happens

1. Prep — runs scripts/ingest_source.py to get title, preview, and suggested summary path
2. Read — reads the source directly
3. Discuss — reports TL;DR, key claims, which pages will be touched, any contradictions
4. Confirm — waits for your go-ahead (or redirects)
5. Write — creates the source summary, updates 5-15 pages, flags contradictions
6. Coverage audit — maps raw sections/files to wiki pages, marks important material as covered/weak/missing/skipped, and fixes weak/missing coverage before continuing
7. Index — runs scripts/update_index.py or edits wiki/index.md inline
8. Log — runs scripts/append_log.py --op ingest --title "<title>"
9. Reindex retrieval — runs qmd update && qmd embed so every new and updated page is searchable via qmd query/vsearch and the QMD MCP server. Skip only if qmd is not installed in this vault.
10. Report — bulleted wikilinks to every touched page, coverage status, targeted retrieval checks, and QMD reindex result

Sub-agent

This command dispatches the wiki-ingestor sub-agent for the heavy lifting. See agents/wiki-ingestor.md.

Scripts

• engineering/llm-wiki/scripts/ingest_source.py — source prep (metadata + preview)
• engineering/llm-wiki/scripts/update_index.py — regenerate index
• engineering/llm-wiki/scripts/append_log.py — log the ingest

Rules

• The source must be inside the vault's raw/ layer. If it isn't, the command will ask you to move it first.
• raw/ is immutable — the ingestor reads only.
• If a summary page already exists, the ingestor enters merge mode and appends a re-ingest section.
• Large or high-risk sources must include a ## Coverage audit <YYYY-MM-DD> section in the source summary.

Skill Reference

→ engineering/llm-wiki/SKILL.md → engineering/llm-wiki/references/ingest-workflow.md