Skip to content
Putting technology to work.
Insights to guide decisions and action.

Search articles

Preventing internal knowledge leaks with Karpathy-style LLM Wikis: Designing organizational RAG for client projects in 2026

Table of contents · 11 items

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

DimensionLegacy Notion / ConfluenceKarpathy-style LLM Wiki
StructureHierarchical / tree-basedFlat + bidirectional links
GranularityLong-form documents of thousands of words / large pagesOne topic per file / concise entries
Self-containmentDependent on parent pagesEach file reads independently
RedundancyAvoids duplicationPermits intentional overlap when necessary
LLM retrieval success rate30〜55%70〜85%
Documentation cultureRelies on individual goodwillEmbedded into standard workflows
Search granularityPage-levelChunk-level + self-contained
Capturing tacit knowledgeScattered across unspoken context, diagrams, and casual chatExplicitly 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

LayerRecommended technologyAlternative
Wiki hostGit + Markdown / Outline / LogseqNotion + rule reinforcement
Vector DBVectorize / Qdrant / Weaviatepgvector
EmbeddingOpenAI / Cohere / Granite multilingualE5 / BGE
RerankerEttin / Cohere Rerank / VoyageCustom
RAG orchestrationLlamaIndex / LangChain / MastraIn-house custom build
Search UIGlean / in-house build + SlackbotMicrosoft Search
Access controlOIDC + ABACLDAP / SAML
ObservabilityLangfuse / PhoenixDatadog

Which projects need this and which do not

Projects requiring thisProjects not requiring this
Notion / Confluence exceeds 5,000 pagesFewer than 100 pages of documentation
50 or more employeesTeam of several people
Business processes rely on documentationAll operations rely on verbal / direct communication
Knowledge is easily lost through turnover / transfersAll members have long tenures
Planning to introduce AI search / assistantsNo search needs

Six clauses to include in client contracts

ClauseDetailsWhat the client should verify
Target knowledge scopeDepartment / process / confidentiality classificationCompliance adherence
Wiki schema IPOwnership of schema specifications + guidelinesSecondary usage terms
Search quality SLARetrieval success rate / freshnessAlignment with business KPIs
Fostering an update cultureOnboarding / trainingEstablishing organizational structure
Access controlManaging public / confidential classificationsStatutory and customer contract compliance
Handover Upon Project CompletionWiki + RAG + evaluation setInternal operational continuity

Client ROI estimate (assuming 200 employees / 12,000 Notion pages / existing RAG search success rate of 40%)

ItemExisting (Notion + RAG)After LLM wiki migrationDifference
LLM retrieval success rate40%78%+38pt
Knowledge search workload (monthly)600h220h-380h
New hire onboarding period3 months1.5 months-1.5 months
Knowledge loss during turnover / transfersHigh (siloed in individuals)Limited (retained in the wiki)Risk reduced
Recurrence of identical issues18 incidents / month5 incidents / month-13 incidents / month
Annual benefitEquivalent 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

WeekAction
Week 1〜2Knowledge inventory + retrieval success rate measurement
Week 3〜4LLM wiki schema design + migration guide
Week 5〜7Migrating 300 topics in a pilot department
Week 8〜9RAG pipeline construction + A/B evaluation
Week 10Company-wide rollout plan + onboarding design
Week 11Slack / IDE integration
Week 12〜13Establishing 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

Share this articleXFacebook
Kakeru Suzuki

Fascinated by the possibilities of technology, has had a deep interest in programming and digital art since student days

Turn this article's theme into your company's next step

Thinking together, starting from the work you entrust to AI.

We organize your current operations and data to define the scope entrusted to AI, what humans should review, and how to run trials.

  • Target operations
  • Data to use
  • How to verify effectiveness
Consult on AI adoption for your business

You can consult with us from the initial conceptual stage. Details from this article will be carried over to the inquiry form.

Receive the latest articles by email