llm-wiki

1# LLM Wiki for Codebases
2 
3Build a persistent, interlinked markdown wiki that captures the architecture, modules, patterns, and APIs of a codebase. The wiki lives in `.llm-wiki/` at the project root. Humans curate and direct; the LLM handles all bookkeeping.
4 
5Based on [Andrej Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f): raw sources are "compiled" into a structured wiki that compounds over time.
6 
7## Mode Detection
8 
9Determine the mode based on current state:
10 
11- **No `.llm-wiki/` directory exists** -> Full Build mode
12- **`.llm-wiki/` exists** -> Update mode (diff and refresh)
13 
14## Full Build Workflow
15 
16### Phase 1: Reconnaissance
17 
181. Read top-level files: README, package.json/Cargo.toml/go.mod/pyproject.toml/build.gradle etc.
192. Run `find` or Glob to map the directory tree (ignore node_modules, .git, vendor, dist, build, __pycache__, .venv)
203. Identify: language(s), framework(s), build system, entry point(s), test framework
214. Count files per directory to gauge module boundaries
225. Read CLAUDE.md / AGENTS.md / .cursor/rules if present - they contain valuable architectural context
23 
24Record findings in `.llm-wiki/_schema.md` (see references/wiki-schema.md for format).
25 
26### Phase 2: Skeleton
27 
28Create the directory structure:
29 
30```
31.llm-wiki/
32  _schema.md          # Wiki conventions and project metadata
33  _index.md           # Content-oriented catalog by category
34  _log.md             # Chronological build/update log
35…