kb-ingest
Ingest a source document into an llmkb knowledge base: turn it into a summary
page and fold its ideas into the concept and entity pages, keeping the index,
log, and links consistent.
When to use
A user has dropped a file in the KB's raw/ directory (or points you at one)
and wants it filed into the wiki.
Steps
- Read the discipline. Open
SCHEMA.mdat the KB root and follow its conventions for this project. - Read the source in
raw/. Identify the key claims, entities, and concepts. - Write the summary page under
wiki/summaries/. Use the required frontmatter (type: summary;sourceslists theraw/path). Keep it a faithful condensation, self-contained, with[[wikilinks]]to the concepts and entities it touches. - Update concept pages under
wiki/concepts/: create a page for each new cross-cutting idea, or extend an existing one. Agent-authored synthesis is a concept page with an empty (or session-ref)sources. - Update entity pages under
wiki/entities/for people, orgs, systems, or products the source introduces or expands. - Update the catalog. Run
llmkb reindexto rebuildwiki/index.mdfrom frontmatter, then append one line towiki/log.md:## [YYYY-MM-DD] ingest | <source title>. - Lint and fix. Run
llmkb lintand resolve every error it reports (broken links, orphans, missing-from-index) before finishing.
Done when
llmkb lint reports no errors and the source is represented by a summary page
plus any concept/entity updates, all linked and indexed.