Three Months of my LLM-wiki: A Follow-Up and an Update

· Source: AI on Medium · Field: Technology & Digital — Artificial Intelligence & Machine Learning, Software Development & Engineering, Research Methodology & Innovation · Depth: Intermediate, medium

Summary

The author provides a three-month follow-up on their LLM Research Wiki, a knowledge base built on Andrej Karpathy's pattern and maintained by Claude Code. The wiki nearly doubled in size, growing from 185 to 367 pages, with cross-references increasing from 9 to 12 per page. This growth exposed a design flaw: the LLM agent's "LINT" workflow struggled with mechanical checks at scale, becoming slow and token-expensive. Inspired by projects like Tome and Engram, the author developed "wiki lint", a small, dependency-free tool. This "hands layer" handles deterministic tasks such as resolving broken links, identifying orphan pages, checking index-disk consistency, and validating frontmatter. The "wiki lint" tool successfully identified 10 orphan pages and 9 unindexed pages in the live wiki, which were subsequently corrected. The author retained specialized features like richer page types and epistemic markers for humanities research. The open template is now called Zissa Wiki and includes this new linter.

Key takeaway

For Research Scientists or AI Engineers building LLM-maintained knowledge bases, you should explicitly separate the LLM's interpretive role from mechanical validation tasks. Implement dedicated, deterministic tools like "wiki lint" to handle checks such as broken links, orphan pages, and index consistency. This approach ensures scalability and accuracy, preventing silent data rot as your knowledge base grows, allowing your LLM agent to focus on higher-value synthesis and judgment.

Key insights

LLMs excel at interpretive tasks but require deterministic tools for mechanical validation in large, evolving knowledge bases.

Principles

Method

Implement a "hands layer" tool to offload deterministic knowledge base checks from LLM agents. This tool performs link resolution, orphan page identification, index-disk comparison, and frontmatter validation using a configuration file.

In practice

Topics

Code references

Best for: AI Engineer, Research Scientist, Software Engineer

Related on AIssential

Open in AIssential →

Editorial summary, takeaway, and curation by AIssential. Original article published by AI on Medium.