Skip to content

Agent Wiki Ingest

Implement the LLM-Wiki "ingest" operation: read a source, update affected pages, refresh index and log.

When to use

  • A new file lands in knowledge/agent-wiki/raw/.
  • "Ingest this" / "add this to the wiki" / "process this source".

Procedure

  1. Read AGENTS.md for current schema and conventions.
  2. Read the source from raw/ in full.
  3. Determine classification (SPB-01) by inspecting source content. If private_sensitive, stop and re-route — private_sensitive content does not belong in the markdown wiki; capture into AnyType instead via pkm-capture.
  4. Discuss with user (briefly) which entity/concept/topic pages this source affects. If user input not available, propose and write speculatively under a "Proposed updates" header.
  5. Create source page at wiki/sources/<slug>.md using the source page template from AGENTS.md.
  6. Update affected pages:
  7. For each affected entity/concept/topic, revise relevant sections.
  8. Add cross-links both ways.
  9. Flag contradictions explicitly under a ## Contradictions / open questions block; never silently overwrite.
  10. Update index.md: add new source row; refresh summaries of pages whose meaning changed.
  11. Append log.md with format ## [<yyyy-mm-dd>] ingest | <source title> and bullets for pages updated and contradictions flagged.
  12. Verifier handoff — invoke verifier to confirm new pages exist, are valid markdown, and cross-references resolve.

Anti-patterns

  • Don't ingest private_sensitive content into the markdown wiki.
  • Don't update pages without filing the source page first.
  • Don't omit contradictions — they're a feature.
  • Don't skip the log entry.

Compatibility

  • Read access to raw/, wiki/, index.md, log.md.
  • Write access scoped to wiki/* and the index/log.
  • Optional: AnyType cross-references via anytype:<id> in frontmatter.
  • Cloud model use only if the highest-classification source in the batch permits.