Llm Atomic Wiki

llm-atomic-wiki

Built on top of **Andrej Karpathy's [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)**. All credit to him for the pattern — this repo is what I learned by running it end-to-end, plus four small additions that helped at scale.

**584 posts · 8,668 replies · 630 atoms · 83 wiki pages · 11 branches**

The repo gives you the framework — methodology, schema, scripts, folder structure. Fork it and run it on your own materials. My actual content stays private; the kit is what you get.

🇹🇼 [中文版 README](README.zh-TW.md) · 📖 [the story behind this repo](STORY.md)

---

What this adds on top of Karpathy's pattern

Karpathy's gist captures the core pattern in beautifully minimal form. The four additions below came from problems I hit while running it at scale — they extend his pattern, they don't replace it.

Karpathy:   raw ─→ wiki
This repo:  raw ─→ atoms (organized into topic-branches) ─→ wiki

Four additions:

**1. Atom layer.** Karpathy goes raw → wiki in one compile step. I added atoms in between — one atom equals one claim, with frontmatter (source, type, depth, tags, date). Atoms are the source of truth; wiki is a derived cache. When a wiki page gets a fact wrong, you go back to the atom, not the raw source. This solves the "loss of information" and "false sense of source of truth" problems that commenter `frosk1` raised on the original gist.

**2. Topic-branches at the atom layer.** Karpathy's wiki is flat. I organize atoms by topic into branch folders at the repo root (one folder per branch), then compile to flat wiki pages with topic prefixes (`wiki/-.md`). The atom layer becomes browsable; the wiki layer stays index-friendly.

**3. Two-layer Lint.** Karpathy lumps "find contradictions, ghost links, orphan pages, outdated claims" into a single Lint operation. I split it. A programmatic layer (`scripts/lint.sh`) handles deterministic checks (ghost links, orphan pages, format violations