LLM Wiki

An open-source template for building LLM-powered knowledge bases, following Andrej Karpathy's "LLM Wiki" pattern.

You provide raw sources. The LLM reads them, writes structured wiki pages, cross-links everything, and maintains it over time. You never edit the wiki directly — you curate sources and ask questions.

How It Works

The system has three layers:

raw/              Sources you collect (articles, transcripts, notes, PDFs)
wiki/             LLM-written & maintained pages (summaries, concepts, entities, syntheses)
CLAUDE.md         Schema that tells the LLM how to structure everything

Three operations drive the workflow:

Operation	Trigger	What happens
Ingest	"ingest raw/my-source.txt"	LLM reads the source, creates a summary page, creates/updates concept and entity pages, adds cross-links, updates the index and log
Query	Ask any question	LLM searches the wiki, synthesizes an answer with citations, optionally creates a synthesis page for novel insights
Lint	"lint" or "health check"	LLM audits all pages for orphans, contradictions, missing links, incomplete sections, and low-confidence claims — fixes what it can, reports the rest

Quick Start

1. Clone this repo

   git clone https://github.com/YOUR_USERNAME/llm-wiki.git my-knowledge-base
   cd my-knowledge-base

2. Customize CLAUDE.md for your domain

   • Update the Purpose section with your topic
   • Replace the placeholder tagging taxonomy with your own categories
   • Adjust confidence level descriptions if needed
   • Everything else (workflows, page formats, linking rules) works as-is

3. Drop sources into raw/

   • Text files, transcripts, articles, notes — any plain text
   • These are immutable once added; the LLM never modifies them

4. Tell the LLM to ingest

   ingest raw/my-first-source.txt
   

   The LLM will create summary pages, concept pages, entity pages, cross-links, and update the index.

5. Ask questions

   What are the key differences between X and Y?
   

   The LLM answers from the wiki, citing specific pages.

6. Run health checks

   lint
   

   The LLM audits the wiki and fixes issues.

Directory Structure

.
├── CLAUDE.md                      # Schema — the LLM's instructions
├── raw/                           # Your source documents (immutable)
└── wiki/
    ├── index.md                   # Master catalog of all pages
    ├── log.md                     # Append-only activity log
    ├── dashboard.md               # Dataview dashboard (Obsidian)
    ├── analytics.md               # Charts View analytics (Obsidian)
    ├── flashcards.md              # Spaced repetition cards
    ├── summaries/                 # One page per source document
    ├── concepts/                  # Concept and framework pages
    ├── entities/                  # People, tools, organizations, etc.
    ├── syntheses/                 # Cross-cutting analyses and comparisons
    ├── journal/                   # Research/session journal entries
    │   └── template.md            # Journal entry template
    └── presentations/             # Marp slide decks

Enhancements

This template includes several extras beyond the core wiki pattern:

Dataview Dashboard (wiki/dashboard.md)

Live queries that surface low-confidence pages, recent updates, concepts by tag, and pages with the most sources. Requires the Dataview Obsidian plugin.

Charts View Analytics (wiki/analytics.md)

Visual analytics with pie charts, bar charts, and word clouds. Requires the Charts View Obsidian plugin.

Mermaid Diagrams

Use Mermaid code blocks in any wiki page to create flowcharts, sequence diagrams, or concept maps. Native support in Obsidian and GitHub.

Marp Slides (wiki/presentations/)

Create slide decks from markdown using Marp. Drop presentation files in this directory.

Research Journal (wiki/journal/)

Track your research sessions, experiments, or applied work with the included template. The LLM can reference journal entries when answering queries.

Spaced Repetition (wiki/flashcards.md)

Flashcards in the format used by the Spaced Repetition Obsidian plugin. Ask the LLM to generate flashcards from any wiki page.

MCP Server

This repo works with Claude Code's MCP server capabilities. Point an MCP-compatible client at this repo and the LLM can read/write the wiki programmatically.

Customizing for Your Domain

The schema in CLAUDE.md is domain-agnostic. To adapt it:

1. Purpose — Describe your knowledge domain in one paragraph
2. Tagging taxonomy — Replace placeholder categories with your own (e.g., for a cooking KB: cuisine, technique, ingredient, equipment)
3. Confidence levels — Adjust the descriptions to match your domain's evidence standards
4. Entity types — Update the entity page description to match what entities mean in your domain (people, tools, companies, etc.)
5. Journal template — Customize wiki/journal/template.md for your workflow

Everything else — page format, linking conventions, workflows, rules — is universal and works across domains.

Example Domains

This template works for any knowledge-intensive topic:

• Research notes — papers, experiments, methodologies
• Book analysis — themes, characters, author techniques
• Competitive analysis — companies, products, market trends
• Course notes — lectures, readings, key concepts
• Personal development — frameworks, habits, book summaries
• Technical documentation — APIs, architectures, design patterns
• Hobby deep-dives — any subject you want to master

License

MIT