On May 25, 2026, Zenn published The Only Architectural Philosophy That Ensures AI Captures All Internal Knowledge: Lessons Learned Implementing Andrej Karpathy's LLM Wiki. The article shares empirical findings from putting into production the core tenets of Andrej Karpathy's LLM Wiki concept: one topic per file, self-contained documents, inter-topic relationships mapped through links, and concise, plain language optimized for LLM comprehension. The core takeaway is clear: hierarchical page structures in Notion and Confluence hinder LLM retrieval, whereas flat, high-density Wikis dictate the ultimate quality of organizational RAG. As reliance on Stack Overflow for Q&A wanes (see Stack Overflow Decline → Internal Knowledge Q&A Replacement Custom Development), maintaining internal tacit knowledge, architectural rationale, and post-mortems in formats that AI can readily leverage has become a decisive factor in organizational productivity.
For firms providing custom development to design internal knowledge platforms and organizational RAG for mid-market enterprises, this opens significant engagement opportunities to address the common complaint that AI struggles to retrieve answers despite massive documentation in Notion. We solve this by delivering an end-to-end service combining Karpathy-style LLM Wiki architecture, enterprise RAG pipelines, and ongoing documentation culture cultivation. Expanding upon our work with internal MCP platforms in Private MCP Server Implementation Custom Development, RAG search accuracy in Multimodal Embedding + Reranker Enterprise RAG Custom Development, and agent memory in Cloudflare Agent Memory Enterprise Systems Custom Development, this service tackles knowledge architecture by redesigning the upstream information structure itself.
Why LLM Wiki architecture marks a turning point
| Dimension | Legacy Notion / Confluence | Karpathy-style LLM Wiki |
|---|---|---|
| Structure | Hierarchical / tree-based | Flat + bidirectional links |
| Granularity | Long-form documents of thousands of words / large pages | One topic per file / concise entries |
| Self-containment | Dependent on parent pages | Each file reads independently |
| Redundancy | Avoids duplication | Permits intentional overlap when necessary |
| LLM retrieval success rate | 30〜55% | 70〜85% |
| Documentation culture | Relies on individual goodwill | Embedded into standard workflows |
| Search granularity | Page-level | Chunk-level + self-contained |
| Capturing tacit knowledge | Scattered across unspoken context, diagrams, and casual chat | Explicitly articulated in text |
In short, designing an LLM Wiki is an architectural decision to transform the primary representation of corporate knowledge from Notion pages that make sense only when read by humans into Wikis that AI can easily retrieve while keeping them clear for human readers.
Three structural changes beneficial to custom development projects
Structural shift 1: From assuming knowledge lives in Notion to Wikis built for AI retrieval
Across mid-market enterprises, Notion and Confluence workspaces frequently swell to 5,000–30,000 pages, leaving teams trapped in a state where information ought to exist but cannot be found, or is documented but horribly outdated. Providing custom development for restructuring and migration guidelines toward LLM Wikis serves as the gateway to re-activating legacy knowledge bases for the AI era.
Structural shift 2: From tuning vector search to engineering knowledge structures
Discussions around improving organizational RAG typically focus on search-side tuning—such as swapping embedding models, introducing rerankers, or adjusting chunk sizes—yet the Karpathy model demonstrates that restructuring source documentation produces far superior results. This custom service delivers upstream architectural design that complements the downstream tuning covered in our Multimodal Embedding + Reranker Enterprise RAG Custom Development and Ettin Reranker RAG Optimization Custom Development.
Structural shift 3: From IT and HR managing knowledge to embedding documentation into standard operations
While the "culture of writing documentation" has historically relied on the goodwill of individual staff, making knowledge reusable by AI requires embedding "updating the wiki upon completing a task" into standard operating procedures. Much like the prompt assetization discussed in Anthropic XML Prompt Structure Engagements, this represents a cultural shift from "individual craft to organizational assets."
The 5 phases of deploying a Karpathy-style LLM Wiki and organizational RAG
Phase 1: Current state assessment (2–3 weeks)
- Auditing existing documentation (Notion, Confluence, Slack, files)
- Measuring LLM retrieval success rates across 30 representative queries
- Analyzing update frequency and contributor distribution
- Mapping business processes to underlying documentation
- Prioritizing candidate domains for LLM Wiki conversion
Phase 2: Wiki architecture design (2–3 weeks)
- Defining LLM Wiki schemas (topic granularity, linking rules)
- Standardizing naming conventions and metadata
- Formulating migration guidelines (from existing Notion setups to LLM Wikis)
- Designing security policies and access controls
- Defining update triggers (task completion, PR merges, post-incident reviews)
Phase 3: Pilot migration (3–4 weeks)
- Piloting LLM Wiki operations across 1 to 2 departments
- Migrating 100 to 300 topics from existing documentation
- Building RAG pipelines (vector databases, rerankers)
- Benchmarking search retrieval accuracy via A/B testing
- Gathering user feedback and continuous refinement
Phase 4: Company-wide rollout (4–8 weeks)
- Phased rollout by department
- RAG search UI / Slack integration / IDE integration
- Fostering an update culture (onboarding / KPIs)
- Quality metrics (success rate / freshness / duplication)
- Governance (disclosure scope / confidentiality classification)
Phase 5: Monthly operational reviews (ongoing)
- LLM retrieval success rate monitoring
- Outdated topic / duplication detection
- Adding new business domains to the wiki
- Keeping pace with RAG pipeline evolution
- Usage status / user satisfaction
Standard technology stack set for custom development
| Layer | Recommended technology | Alternative |
|---|---|---|
| Wiki host | Git + Markdown / Outline / Logseq | Notion + rule reinforcement |
| Vector DB | Vectorize / Qdrant / Weaviate | pgvector |
| Embedding | OpenAI / Cohere / Granite multilingual | E5 / BGE |
| Reranker | Ettin / Cohere Rerank / Voyage | Custom |
| RAG orchestration | LlamaIndex / LangChain / Mastra | In-house custom build |
| Search UI | Glean / in-house build + Slackbot | Microsoft Search |
| Access control | OIDC + ABAC | LDAP / SAML |
| Observability | Langfuse / Phoenix | Datadog |
Which projects need this and which do not
| Projects requiring this | Projects not requiring this |
|---|---|
| Notion / Confluence exceeds 5,000 pages | Fewer than 100 pages of documentation |
| 50 or more employees | Team of several people |
| Business processes rely on documentation | All operations rely on verbal / direct communication |
| Knowledge is easily lost through turnover / transfers | All members have long tenures |
| Planning to introduce AI search / assistants | No search needs |
Six clauses to include in client contracts
| Clause | Details | What the client should verify |
|---|---|---|
| Target knowledge scope | Department / process / confidentiality classification | Compliance adherence |
| Wiki schema IP | Ownership of schema specifications + guidelines | Secondary usage terms |
| Search quality SLA | Retrieval success rate / freshness | Alignment with business KPIs |
| Fostering an update culture | Onboarding / training | Establishing organizational structure |
| Access control | Managing public / confidential classifications | Statutory and customer contract compliance |
| Handover Upon Project Completion | Wiki + RAG + evaluation set | Internal operational continuity |
Client ROI estimate (assuming 200 employees / 12,000 Notion pages / existing RAG search success rate of 40%)
| Item | Existing (Notion + RAG) | After LLM wiki migration | Difference |
|---|---|---|---|
| LLM retrieval success rate | 40% | 78% | +38pt |
| Knowledge search workload (monthly) | 600h | 220h | -380h |
| New hire onboarding period | 3 months | 1.5 months | -1.5 months |
| Knowledge loss during turnover / transfers | High (siloed in individuals) | Limited (retained in the wiki) | Risk reduced |
| Recurrence of identical issues | 18 incidents / month | 5 incidents / month | -13 incidents / month |
| Annual benefit | — | — | Equivalent to approx. 36.5 million yen + improved organizational resilience |
Calculated at an hourly rate of 8,000 yen, this represents an estimated annual workload reduction of over 36.5 million yen plus lower turnover risk. Because ROI varies significantly depending on the scale of the migration target and current search success rates, the most reliable approach is to make a decision after taking actual measurements during the Phase 1 current-state assessment.
Five common pitfalls
Pitfall 1: Perfectionism aiming to "turn all of Notion into a wiki"
Attempting to migrate all 12,000 pages at once will lead to exhaustion and stall the initiative. Migrate in phases in units of 300 topics, starting with high-frequency and business-critical areas.
Pitfall 2: Converting to a wiki while keeping hierarchies intact
Even though "flat + links" is the core principle, leaving existing hierarchies intact means that the LLM's retrieval success rate will not improve. Ensure that you eliminate hierarchies and reinforce links during schema design.
Pitfall 3: Postponing the cultivation of an update culture
If you assume that "people will write once a tool is introduced" and omit incentive design for writing, the space will be full of outdated knowledge three months later. Design task completion templates and KPI integration from the initial stages.
Pitfall 4: Adding access controls as an afterthought
If you "open it to everyone" and confidential information gets mixed in, it will lead to legal and customer contract issues. Build the three classifications of Public, Internal Department, and Restricted into the initial schema.
Pitfall 5: Trying to solve everything through RAG tuning alone
Even if you strengthen only the search side under the belief that "adding a reranker will raise the success rate," there are limits if the source data is outdated, duplicated, or hierarchy-dependent. Run this in tandem with wiki-side design.
90-day action plan
| Week | Action |
|---|---|
| Week 1〜2 | Knowledge inventory + retrieval success rate measurement |
| Week 3〜4 | LLM wiki schema design + migration guide |
| Week 5〜7 | Migrating 300 topics in a pilot department |
| Week 8〜9 | RAG pipeline construction + A/B evaluation |
| Week 10 | Company-wide rollout plan + onboarding design |
| Week 11 | Slack / IDE integration |
| Week 12〜13 | Establishing recurring monthly reviews + KPI integration |
Summary — From "it should be written in Notion" to "a wiki AI can retrieve from"
The Karpathy-style LLM Wiki upended the assumption that "knowledge communicates itself simply by being written down," introducing a new documentation culture centered on "writing with AI retrieval as the prerequisite." For custom development firms supporting internal knowledge infrastructure at mid-market enterprises, treating wiki schema design, phased migration, RAG construction, fostering an update culture, and monthly operations as an inseparable whole is the cornerstone of modern organizational RAG design.
Challenges like "we have Notion, but AI cannot retrieve from it," "knowledge is lost when people leave," and "RAG tuning has hit a ceiling" vary widely across companies depending on existing knowledge volume and operational dependency. We provide tailored quotes for wiki schema design and phased migration approaches based on an assessment of your current state, so please feel free to reach out via our contact form.
Sources
- The only design philosophy that lets AI retrieve internal insights without missing a thing: what we learned putting Karpathy's LLM wiki into practice (Zenn)
- The decline of Stack Overflow → Custom internal knowledge Q&A replacement (GH Media)
- Custom private MCP server implementation (GH Media)
- Custom enterprise RAG with multimodal embeddings + rerankers (GH Media)
- Custom RAG optimization with Ettin reranker (GH Media)
- Custom Cloudflare agent memory business systems (GH Media)









