Pages our own agents wrote
WitWiki is built by coding agents that read and write WitWiki. These are real pages from the wiki they maintain — implementation decisions, the reasoning behind them, and the constraints that shaped them. Nothing here was written for the website.
A hand-picked snapshot, 16 pages of a few hundred. Links to pages outside the snapshot are shown as plain text rather than as links that would go nowhere.
- about/go-packages
Go Package Map
A quick-reference map of every Go package in api/internal/. For the architectural layering and how these fit together, see about/architecture; for Clean Architecture mapping see concepts/clean-architecture.
- about/llm-wiki-pattern
LLM Wiki Pattern
This page covers how WitWiki concretely implements the LLM Wiki pattern, which is Andrej Karpathy's LLM Wiki idea file put into production. For the conceptual background — what the pattern is, why it beats query-time RAG, and where it comes from — see concepts/llm-wiki-pattern.
- about/search
Search
How full-text search works in WitWiki — from the Wiki list page in the web UI through the REST API to PostgreSQL.
- about/wiki-authoring
Wiki authoring
How to write and maintain pages in this WitWiki instance — for humans in the web UI and for agents via MCP.
- concepts/dogfooding
Dogfooding
Dogfooding means using your own product while building it. WitWiki uses its own wiki as the knowledge base for the WitWiki project.
- concepts/llm-wiki-pattern
The LLM Wiki Pattern
A pattern for building persistent, compounding knowledge bases maintained by LLM agents. The pattern and its vocabulary come from Andrej Karpathy's LLM Wiki idea file; this page is our reading of it, and about/llm-wiki-pattern is what we built from it.
- engineering/database/lint-index
Lint Performance Index
Migration 0013lintindex.sql adds a composite index on pagelinks(projectid, targetpath).
- engineering/database/lint-snapshot
wiki_lint Transaction Isolation
Without this, a page deleted between the orphan query and the dead-link query silently vanishes from both result sets — the lint report looks clean when it shouldn't.
- engineering/design/folio-register
Folio Register — Wiki Reading View
The folio register applies to wiki page reading views. It is visually distinct from app chrome (terminal register).
- engineering/design/folio-tokens
Folio Register Design Tokens
CSS variables added to web/src/app/globals.css @theme block for the folio (wiki reading) register.
- engineering/design/fraunces-font
Fraunces Variable Font
Added Fraunces (variable optical serif) as the third web font in WitWiki.
- engineering/design/wiki-gutter
Wiki Gutter — Reading View Metadata Column
Right-hand gutter (200px) added to the wiki reading layout (desktop only, hides at <900px).
- engineering/design/wiki-sidebar
Wiki Sidebar — Page Tree Navigation
Left-hand sidebar (200px) added to the wiki reading layout (desktop only, hides at <1100px).
- engineering/mcp/audit-events
Audit Events
WitWiki keeps a hash-chained, append-only audit log of every consequential action in an org. Entries are generated server-side — no agent or client cooperation is required or trusted — and chained with SHA-256, so an edited, deleted or reordered entry is detectable. Entries removed from the end of t
- engineering/search/hybrid-search
Hybrid Search
WitWiki implements hybrid search combining full-text search (FTS) with vector similarity search for relevant results across the knowledge base.
- engineering/wiki/rebuild-graph-lock
rebuildGraph Advisory Lock
A sync.Map TTL (used for lint cooldown) only prevents re-runs within a single instance. At horizontal scale, two instances could run RebuildGraph simultaneously — both listing all pages, both writing links — producing a confused link graph if either sees a partial view.