yogsoth-ai Knowledge Compilation
Compile research findings into structured vault pages. Triggered after each strategy completes, or when CC judges accumulated information density warrants compilation.
Available SOPs
wiki-search— check for existing pages before creating duplicateswiki-ingest-source— write immutable source pageswiki-compile-page— create/update wiki pages with edgeswiki-add-edge— create typed relationships between pageswiki-lint-fix— run lint in report mode at end
Guiding Principles
- Assess before acting. Scan incoming material. Identify what's new vs what updates existing pages.
- Deduplication first. Always search before creating. Near-duplicates should be merged, not added.
- Edges are first-class. Every new page should have at least one edge connecting it to the existing graph. Orphans are failures.
- Source immutability. Source pages capture raw material verbatim. Wiki pages synthesize and evolve.
- Batch efficiency. Group related operations. Create all pages for a concept cluster, then wire edges, then index once.
Minimum Yield
Execution Guidance
CC has full autonomy over:
- Which SOPs to invoke and in what order
- Whether to spawn a subagent for complex ingest decisions
- How to partition material across pages
- When to create new pages vs update existing ones
Typical flow (reference, not prescription):
- Search vault for existing coverage of incoming topics
- Decide page operations: new sources, new wiki pages, updates, edges
- Execute operations via SOPs
- Run vault_lint (report mode) to verify no broken links introduced
Context-Management Integration
After compilation completes, trigger context-checkpoint to persist vault state changes to the context layer.
Available SOPs
Optional, no fixed order; the final leaf is always a sop.
| SOP | When to use |
|---|---|
| wiki-add-edge | SOP wrapping vault_add_edge — create a typed relationship between two vault pages. |
| wiki-compile-page | SOP for wiki page creation/update — create or update a synthesized wiki page with edges and index update. |
| wiki-edge-audit | SOP for auditing wikilink coverage — scans all edges and reports which source pages are missing [[dir/slug]] wikilinks to their targets. |
| wiki-graph-query | SOP wrapping vault_query_graph — traverse knowledge graph from a node to explore its neighborhood and context. |
| wiki-ingest-source | SOP for source page creation — write immutable source page capturing raw material, then update search index. |
| wiki-lint-fix | SOP wrapping vault_lint — run batch validation, report issues, optionally auto-fix safe problems. |
| wiki-search | SOP wrapping vault_search — BM25 full-text search across vault pages. Returns ranked results with snippets. |