wiki-lint

name	wiki-lint
description	Health-check the wiki for contradictions, stale claims, orphan pages, missing cross-references, and knowledge gaps. Use periodically or when the user says 'lint the wiki' or 'check wiki health'.
allowed-tools	Read Glob Grep

Wiki Lint

Audit the wiki for quality and consistency issues. Inspired by Karpathy's practice of running periodic LLM health checks over the wiki.

Workflow

Step 1: Read the full index

Read memory/wiki/index.md to get the complete page catalog.

Step 2: Check each category

Contradictions

• Scan pages that reference the same entities or concepts
• Flag claims that conflict across pages
• Note which sources support each side
• Recommend resolution (usually: update the older claim with a note)

Stale claims

• Check page frontmatter updated dates
• Flag pages not updated in recent ingests that cover topics where new sources exist
• Identify claims that newer sources have superseded

Orphan pages

• Find pages with no inbound [[wikilinks]] from other pages
• These may be valid standalone pages or may indicate missing cross-references

Missing pages

• Scan for [[wikilinks]] that point to pages that don't exist yet
• Identify important concepts mentioned frequently but lacking their own page

Missing cross-references

• Find pages that discuss the same entities but don't link to each other
• Suggest wikilinks that should be added

Knowledge gaps

• Based on the topics covered, suggest:
  • Questions worth investigating
  • Sources worth finding
  • Angles not yet explored
• The LLM may say: "I don't fully understand this concept. Can you give me more info or find more articles that cover this?"

Broken links check Run this check against the wiki:

# In wiki directory:
grep -roh '\[\[[^]]*\]\]' memory/wiki/ | sed 's/\[\[//;s/\]\]//' | sort -u > /tmp/wl.txt
find memory/wiki/ -name "*.md" -exec basename -s .md {} \; | sort -u > /tmp/fl.txt
comm -23 /tmp/wl.txt /tmp/fl.txt

Step 3: Report

Produce a structured report:

# Wiki Health Report — [date]

## Summary
- Total pages: X
- Sources ingested: X
- Last ingest: [date]

## Contradictions (X found)
- [page-a] vs [page-b]: [description of conflict]

## Stale Claims (X found)
- [page]: last updated [date], but [newer-source] may supersede

## Orphan Pages (X found)
- [page]: no inbound links

## Missing Pages (X found)
- [[concept-name]]: referenced in [N] pages but has no page

## Broken Links (X found)
- [[link-target]]: referenced but file doesn't exist

## Missing Cross-References (X found)
- [page-a] and [page-b] both discuss [topic] but don't link

## Suggested Investigations
- [question or source suggestion]

Step 4: Log

Append to memory/log.md:

## [YYYY-MM-DD] lint | Wiki Health Check
- Contradictions: X
- Stale claims: X
- Orphan pages: X
- Missing pages: X
- Broken links: X
- Missing cross-references: X