Lint Operation¶
Summary¶
The lint operation runs health checks on the wiki to keep it accurate and internally consistent as it grows. It is the self-healing mechanism that prevents the wiki from slowly drifting into quiet inconsistency.
Structural Checks¶
| Check | What It Finds |
|---|---|
| Orphaned pages | Files in wiki/ not defined in schema (no inbound links) |
| Missing pages | Schema slugs with no corresponding file |
| Broken cross-references | [[slug]] links pointing to non-existent pages |
| Stale embeddings | Pages not in the vector index |
| Missing source provenance | Pages without recorded source contributions |
Deep Lint (--deep)¶
The LLM checks tag-overlapping page pairs for factual contradictions — running a fact-checker across the wiki. This is slow and costs API calls but is essential for maintaining accuracy.
Fix Mode (--fix)¶
All embeddings are regenerated from scratch to heal a stale index. Useful after significant page updates or embedding model changes.
When to Run Lint¶
- After every ~20 new pages
- Any time you add a source that significantly updates a topic already in the wiki
- Periodically as a maintenance routine (weekly health check)
Common Mistakes Without Lint¶
- Small errors propagate fast: a wrong claim on one page gets linked to by three others, creating organized misinformation
- Contradictions between pages go unnoticed
- Orphan pages represent wasted knowledge
- Stale claims from newer sources superseding old ones persist
Lint Prompt (Manual)¶
"Audit the entire wiki/ folder. Identify: 1. Orphan pages — pages that no other page links to 2. Missing pages — concepts referenced with
bracketsthat don't have their own page yet 3. Contradictions — claims that conflict across pages 4. Stale claims — things that may have been superseded by a more recent source in raw/ Suggest fixes and, where confident, apply them directly."