Artificial Intelligence · April 2026 · Analysis

Andrej Karpathy posted a folder structure. Sixteen million people felt something shift.

16M Views on a single post
about a folder structure
5,000 GitHub stars in
the first week
4,282 Forks — engineers building
their own versions immediately
1945 The year Vannevar Bush
described the same idea first

He called it LLM Wiki. A persistent knowledge base that an AI agent builds and maintains — so knowledge compounds over time instead of evaporating at the end of every session. Here is what he actually proposed, why engineers recognised it instantly, and what it means for everyone who thinks with their hands.

HR Srinivas September 2026 Artificial Intelligence 10 min read
The Viral Moment

It was not a product launch. It was not a research paper. It was a GitHub Gist.

On April 3, 2026, Andrej Karpathy — co-founder of OpenAI, former head of AI at Tesla, the person who coined "vibe coding" — posted a tweet about how he had been using AI. Not for code. For knowledge.

Andrej Karpathy @karpathy · April 2, 2026

LLM Knowledge Bases

Something I'm finding very useful recently: using LLMs to build personal knowledge bases for various topics of research interest. In this way, a large fraction of my recent token throughput is going less into manipulating code, and more into manipulating knowledge structures that I can query, refine, and build on over time...

16,000,000+ views · 5,000 stars on the follow-up Gist

It exploded. Karpathy himself was surprised: "Wow, this tweet went very viral!" So he did something interesting. Instead of shipping an app or publishing a paper, he shared what he called an "idea file" — a GitHub Gist written in plain prose, designed to be copy-pasted directly into an AI agent so the agent could build the system for you.

What is an Idea File?

Karpathy introduced a new format for sharing ideas in the AI era. His exact words: "The idea of the idea file is that in this era of LLM agents, there is less of a point/need of sharing the specific code/app, you just share the idea, then the other person's agent customizes and builds it for your specific needs."

You don't clone a repo. You copy a description and give it to your AI agent. The agent builds a version customised to your tools, your environment, your needs. Open ideas rather than open source.

16 million people watched engineers read that idea file and feel something shift. The question is what they recognised — and whether that recognition belongs only to engineers.

The Problem Karpathy Named

Every AI session starts from zero. Nothing you learn carries forward.

If you have ever uploaded a PDF to an AI tool, asked a question, and then uploaded the same PDF again the next day to ask a follow-up — you already understand the problem Karpathy's idea solves.

The dominant pattern for giving AI access to your documents is called RAG — Retrieval-Augmented Generation. You upload files. When you ask a question, the system finds relevant chunks, feeds them to the model, and generates an answer. It works. But it has a fundamental limitation that Karpathy states precisely:

"The LLM is rediscovering knowledge from scratch on every question. There's no accumulation."

— Andrej Karpathy, LLM Wiki Gist, April 2026

Ask a question that requires synthesising five documents, and the system pieces together the relevant fragments every time. Ask the same question tomorrow, and it does the same work again. Nothing is built. Nothing compounds. The model retrieves, answers, and forgets.

RAG vs LLM Wiki — What actually happens
Traditional RAG — The Problem
You upload raw documents
You ask a question
System retrieves relevant chunks
Model generates answer
Session ends. Everything forgotten. Tomorrow: start again from raw documents.
LLM Wiki — The Solution
You add a source to raw/
LLM reads, synthesises, integrates into wiki
You ask a question
LLM reads wiki index, drills into pages
Good answers get filed back as wiki pages. Knowledge compounds with every session.
The key distinction: In RAG, knowledge is processed at query time — every time, from scratch. In the LLM Wiki, knowledge is compiled once at ingest time and kept current. "The knowledge is compiled once and then kept current, not re-derived on every query." — Karpathy
The Architecture

Three layers. Each with a clear owner and a clear purpose.

The LLM Wiki is not an app. It is a pattern — a way of organising three things that already exist: your source documents, a folder of markdown files, and a schema that tells the AI how to behave. Karpathy defines each layer precisely.

01
Raw Sources raw/ — immutable, never modified by the LLM

Your curated collection of source documents. Articles, papers, repos, images, data files. These are sacred — the LLM reads from them but never touches them. This is your ground truth.

"These are immutable — the LLM reads from them but never modifies them. This is your source of truth." — Karpathy

02
The Wiki wiki/ — LLM-generated, LLM-maintained

A directory of interconnected markdown files. Summaries, entity pages, concept pages, comparisons, an overview, a synthesis. The LLM owns this entirely. It creates pages, updates them when new sources arrive, maintains cross-references, notes where new data contradicts old claims.

"You read it; the LLM writes it. Obsidian is the IDE; the LLM is the programmer; the wiki is the codebase." — Karpathy

03
The Schema CLAUDE.md / AGENTS.md — persistent instructions across sessions

A document that tells the LLM how the wiki is structured, what the conventions are, and what workflows to follow. Without the schema, the LLM is a chatbot with file access. With it, the LLM becomes a disciplined wiki maintainer that follows consistent rules whether the session is today or three months from now.

"You and the LLM co-evolve this over time as you figure out what works for your domain." — Karpathy

Directory Structure — The Complete Pattern
my-research/
├── raw/                    # Layer 1: Your sources. NEVER modify.
│   ├── articles/
│   ├── papers/
│   ├── repos/
│   └── assets/             # Downloaded images
│
├── wiki/                   # Layer 2: The LLM writes this.
│   ├── index.md            # Master catalog — LLM reads this first
│   ├── log.md              # Append-only activity record
│   ├── overview.md         # High-level synthesis
│   ├── concepts/           # Topic pages
│   ├── entities/           # People, orgs, products
│   ├── sources/            # Per-document summaries
│   └── comparisons/        # Filed from good queries
│
└── CLAUDE.md               # Layer 3: The schema. How the LLM behaves.
                            # (AGENTS.md for Codex / OPENCODE.md for OpenCode)
Three Operations

Ingest. Query. Lint. The complete loop.

The wiki runs on three operations. Each has a clear trigger, a clear process, and a clear output. Together they create the compounding loop that makes the wiki worth building.

Ingest Trigger: "Ingest raw/articles/filename.md"
  • LLM reads the source
  • Discusses key takeaways with you
  • Creates a summary page in wiki/sources/
  • Updates relevant concept and entity pages
  • Flags where new data contradicts old claims
  • Updates index.md and log.md
  • One source may touch 10–15 pages
Query Trigger: Any question you ask
  • LLM reads index.md to find relevant pages
  • Drills into those pages
  • Synthesises answer with wiki-link citations
  • Good answers get filed back as new pages
  • Your explorations compound the wiki too
  • Output can be markdown, table, slide deck
Lint Trigger: "Lint the wiki"
  • Finds contradictions between pages
  • Flags stale claims superseded by new sources
  • Identifies orphan pages with no links
  • Lists concepts mentioned but lacking own page
  • Suggests questions to investigate next
  • Run weekly as the wiki grows

"You never write the wiki yourself — the LLM writes and maintains all of it. You're in charge of sourcing, exploration, and asking the right questions. The LLM does all the grunt work — the summarising, cross-referencing, filing, and bookkeeping."

— Andrej Karpathy, LLM Wiki Gist, April 2026

The key insight about the Query operation: good answers get filed back. A comparison you asked for, an analysis, a connection you discovered — these shouldn't disappear into chat history. File them as wiki pages. This way your own thinking compounds in the knowledge base alongside the ingested sources. The wiki grows not just from what you read, but from what you understand.

The 81-Year Connection

Karpathy closes with a reference to 1945. It is not a footnote.

Karpathy ends his gist with a historical connection that puts the whole idea in a different register. He traces LLM Wiki back to something Vannevar Bush described in 1945 — a thought experiment called the Memex.

1945 Vannevar Bush — "As We May Think" — The Atlantic

Bush described a hypothetical desk-sized device where a person could store all their books, records, and communications, search them rapidly, and most importantly — create associative trails. Linked sequences of documents following their own logic, not alphabetical filing.

His key insight: the human mind works by association, not hierarchy. Rigid filing systems force you into categories. The Memex would let you follow your own paths through knowledge.

But Bush couldn't solve one problem: who does the maintenance? Creating trails, updating connections, keeping everything consistent — humans abandon knowledge systems because the maintenance burden grows faster than the value.

Bush 1945 — Memex
Engelbart — Personal computing
Nelson — Hypertext
Berners-Lee — The Web
Karpathy 2026 — LLM Wiki

The web became public and chaotic rather than private and curated. Bush's vision was personal — your knowledge, your connections, your trails. The LLM Wiki is closer to what Bush actually described.

"The part he couldn't solve was who does the maintenance. The LLM handles that. LLMs don't get bored, don't forget to update a cross-reference, and can touch 15 files in one pass. The wiki stays maintained because the cost of maintenance is near zero."

— Andrej Karpathy, LLM Wiki Gist, April 2026

Humans abandon wikis because the maintenance burden grows faster than the value. The LLM Wiki inverts this: maintenance is free. The only cost is your attention — sourcing, exploration, asking the right questions. The bookkeeping is handled.

Bush had the idea in 1945. It took 81 years to find the person who could do the filing.

What It Means

Why a folder structure got 16 million views

The number is worth sitting with. 16 million views for a description of a directory layout. That is not a viral product launch. That is not a breakthrough paper. It is engineers recognising a problem they have been working around for a long time, and seeing someone with Karpathy's standing in the research community name it precisely.

The question is what they recognised. Technically, it is the stateless problem in AI knowledge tools — every session starting from zero, nothing accumulating. But that technical recognition sits inside something larger.

Karpathy's framing of what he's actually doing: "A large fraction of my recent token throughput is going less into manipulating code, and more into manipulating knowledge structures." The shift he's describing is from AI as a tool for producing outputs to AI as a collaborator in building understanding. Not generating. Compounding.

The engineers who starred the Gist, forked it within days, built their own versions — they weren't just impressed by the architecture. They were recognising a mode of working that feels different from everything before it. A mode where the AI doesn't just answer and forget. It builds alongside you.

Karpathy's gist ends with a deliberate instruction: "The right way to use this is to share it with your LLM agent and work together to instantiate a version that fits your needs. The document's only job is to communicate the pattern. Your LLM can figure out the rest."

Don't wait for someone to build the perfect tool. Copy the idea. Give it to your agent. Start with one topic and 10 sources. The LLM builds the structure. You provide the questions.

A personal note — the citizen developer's read

I read Karpathy's Gist in April 2026. Starred it. Felt something shift. Did nothing with it for six months.

That is probably the most honest thing I can say about how most practitioners engage with ideas like this. We recognise them. We file them under "important." We keep building the way we have always built.

I am an insurance professional who builds automation systems with AI. Not an engineer. A citizen developer — someone who brings 25 years of domain depth and a real problem, with no formal engineering background. The AI handles the technical vocabulary. I handle knowing what the problem actually is.

What Karpathy described is built for engineers — people who live in markdown, GitHub Gists, and directory structures. But the underlying idea is not about engineering at all. It is about knowledge that compounds instead of evaporates. And that problem belongs to everyone who builds with AI, not just people who can configure a CLAUDE.md schema from memory.

So here is what I am going to do — starting now, not in the next six months.

For my insurance domain: a wiki. Every IRDAI regulation I have had to re-explain to Claude across twenty different projects gets compiled once. Every claims pattern, every product structure, every underwriting rule I have described in session after session — filed, maintained, compounded. The domain expertise I have spent 25 years building should not be re-explained to an AI every time I start a new session. It should live somewhere that gets richer every time I use it.

For my builds: the Pre-Build Method already handles the thinking discipline. The LLM Wiki handles the domain knowledge underneath it. They are not the same thing. They are complementary. One structures how I think about a specific build. The other structures everything I know about the domain I build in. (For how I structure the thinking before any build, see the Pre-Build Method — a separate article on this site.)

The citizen developer's advantage over the engineer is domain depth. The citizen developer's disadvantage is that this depth lives entirely in their head — re-explained, session by session, to an AI that forgets. Karpathy's idea solves exactly that problem. The engineer read the Gist and saw a knowledge management architecture. I read it and saw six months of domain knowledge that could have been compounding instead of evaporating.

That is what I am fixing now.

"The document's only job is to communicate the pattern. Your LLM can figure out the rest."

Karpathy posted a folder structure. 16 million people felt something shift. The structure was never the point.

The point was naming a mode of working that makes AI a collaborator in building understanding — not a tool for generating outputs that evaporate at the end of the session.

Bush had the idea in 1945. The LLM handles the filing now.

Start with one topic and 10 sources. Let the wiki build itself.
Sources: Andrej Karpathy, original tweet "LLM Knowledge Bases" (April 2, 2026) and "idea file" GitHub Gist llm-wiki.md (April 4, 2026) at gist.github.com/karpathy/442a6bf555914893e9891c11519de94f. View counts and star data from Agentpedia Codes, remio.ai, and multiple contemporaneous reports (April 2026). Vannevar Bush, "As We May Think," The Atlantic, July 1945. The Memex genealogy (Engelbart → Nelson → Berners-Lee) is standard intellectual history documented in multiple sources. qmd search engine by Tobi Lutke (github.com/tobi/qmd). All Karpathy quotations are from the published Gist; reproduced here under fair use for commentary and education. The personal note in this article is the author's own reflection and makes no claim to have implemented the LLM Wiki pattern as Karpathy defined it architecturally.

Note: This article was researched and written with Claude (Anthropic) as a research collaborator. The Karpathy Gist content was fetched from primary sources and quoted with attribution. The personal reflection is the author's own.