Skip to content

Three Operations

Jump to bottom
Chris Sweet edited this page Jun 12, 2026 · 4 revisions

type: concept up: "Wiki-LLM-Pattern" extends: "Wiki-LLM-Pattern" tags: [foundation, operations]

Three Operations

The agent's interaction with the wiki is constrained to three named operations. Each has a written procedure in Schema and corresponding agent-specific surfaces (slash commands, skills, or rules; see Agent-Overlays).

Ingest (write)

After completing significant work, an experiment, a milestone, a key finding, the agent files what was learned:

  1. Create new pages or update existing ones (with frontmatter per Typed-Edges-and-Frontmatter)
  2. Update cross-references on every affected page (bidirectional)
  3. Update index_llm-wiki-memory-template.md
  4. Append an entry to log_llm-wiki-memory-template.md per Log-Entry-Attribution
  5. Run Verification-Gate before committing
  6. Commit pages+index as one commit; log entry as a separate commit

A single ingest typically touches 5 to 15 pages.

Query (read)

When answering analytical questions, search the wiki first:

  1. Read index_llm-wiki-memory-template.md to find relevant pages
  2. Read those pages and synthesize an answer
  3. If the answer is valuable and reusable, offer to file it as a new page

For topology questions ("what connects to what?"), use the Knowledge-Graph-Pipeline (scripts/kg/build-graph.sh, rdflib + pyshacl in-process). For content questions ("what does this page say?"), read pages directly.

Lint (maintain)

Periodic health check for:

  • Orphan pages (no inbound links)
  • Dead links (links to non-existent pages)
  • Stale claims (superseded by newer work)
  • Pages missing frontmatter or marked type: untyped
  • Missing cross-references
  • Concepts mentioned without their own page

Lint applies corrections. It is itself a write operation and so also appends a log entry.

Why three (and not more, or fewer)

Two would lose the distinction between adding new knowledge (ingest) and maintaining what is there (lint), and conflating them makes both worse: ingest commits drift away from conventions, and lint commits accumulate substantive changes that should have had their own provenance. Four or more starts to overlap. Three is the empirical minimum.

See also

Clone this wiki locally