knowledge systems

markdown vaults, retrieval, and evidence beside the code.

the repo is the database. every project here keeps its working knowledge in markdown and git — searchable, diffable, and durable — with indexes treated as replaceable caches rather than the source of truth.

this category is about building knowledge systems agents can actually use: hybrid retrieval, typed relationships, source capture with provenance, and review workflows that keep generated notes honest.

projects

wordcell — a git-backed markdown knowledge base built for coding agents.
qmd — a small local search engine for docs, notes, and meeting transcripts.
soulscrape — a dated, revisable working model of a person from authorized sources.
kb evaluation — the frozen retrieval pilot metrics published beside the vault.

planned lessons

markdown as the write path; indexes as caches
hybrid retrieval: exact, text, and semantic search together
capturing sources with provenance you can audit
typed relationships and bounded graph context for agents

these lessons are planned, not published. each ships as a page under this category when it is written.

AI-drafted at Ben Guo's direct request as category seeds; each planned lesson is unpublished until it is written.