- type
- concept
- created
- Mon Apr 06 2026 02:00:00 GMT+0200 (Central European Summer Time)
- updated
- Mon Apr 06 2026 02:00:00 GMT+0200 (Central European Summer Time)
- sources
- raw/notes/reference_mcp_servers
- tags
- infrastructure wiki knowledge-management hooks
- aliases
- LLM Wiki, Karpathy Wiki
Wiki System
abstract
Project-level LLM Wiki based on Karpathy's pattern. 57+ pages, MOC navigation, auto-injected at session start via hooks. Browse at https://uc-wiki.xdvu.com.Architecture (3 layers)
- Raw sources (
wiki/raw/) — immutable documents. Claude reads, never modifies. - Wiki pages (
wiki/wiki/) — LLM-maintained. Concepts, entities, summaries, analyses, MOCs. - Schema (
wiki/CLAUDE.md) — operating instructions: ingest, query, lint workflows.
Navigation: Maps of Content (MOCs)
_home.md— entry point, links to all MOCs_moc-ai-features.md— all 19 features by phase with status_moc-architecture.md— tech stack, DB, patterns, design system_moc-specs-and-plans.md— all specs, research, implementation plans_moc-people-and-tools.md— entities: people, companies, tools
Every new page MUST be added to the relevant MOC.
Hooks (project-level, .claude/settings.json)
| Hook | When | What |
|---|---|---|
| SessionStart | Session opens | Injects _home.md + index.md into context |
| Stop | Claude finishes | Checks git diff, reminds to update wiki if code changed |
| PostToolUse | After Bash | Auto-logs git commits to wiki/log.md |
Hooks are project-level — only active in unitcycle-demo/. Other projects are unaffected.
Key Files
| File | Purpose |
|---|---|
wiki/CLAUDE.md |
Schema — how to operate the wiki |
wiki/index.md |
Flat catalog of all pages (machine-readable) |
wiki/log.md |
Append-only activity + auto-logged commits |
wiki/wiki/_home.md |
Human entry point (MOC) |
.claude/settings.json |
3 hooks (SessionStart, Stop, PostToolUse) |
WIKI-SETUP.md |
Reusable prompt to set up wiki in any project |
How It Evolves
- Session start: Hooks inject wiki context automatically
- During work: Commits auto-logged to
wiki/log.md - Session end: Stop hook nudges to update wiki if code changed
- Manual: "save to wiki" / "ingest" triggers full wiki update
- Weekly: "lint the wiki" for orphans, broken links, stale pages
Git
Wiki is part of the project repo (not separate). Commit prefix: wiki:.
Web Server
- PM2 process:
uc-wiki(port 3080) - URL: https://uc-wiki.xdvu.com
- Features: dark theme, sidebar with MOCs, graph view, AI-powered search, wikilink rendering
AI Search
LLM-powered search with query expansion, streaming answers, and smart ranking. See wiki/concepts/wiki-ai-search for full details.
- Single search field: AI answer on top, related pages with snippets below
- Uses Gemini 2.0 Flash via OpenRouter for query expansion + answer generation
- SSE streaming through Nginx (
proxy_buffering offrequired)
Sources
- raw/notes/reference_mcp_servers — infrastructure context
Related
- wiki/concepts/tech-stack — overall project infrastructure
- wiki/entities/unitcycle — the project this wiki documents