/wiki-lint

Run health checks on your compiled wiki to find stale articles, missing links, and contradictions.

/wiki-lint audits your compiled wiki and surfaces issues before they cause problems. Run it after a compile, after ingesting new sources, or anytime you want to check the state of your knowledge base.

Command

/wiki-lint

What gets checked

Check	What it looks for
Stale articles	Topics whose source files have changed since the last compile
Orphan pages	Articles where source files have been deleted or moved, or articles with zero sources listed
Missing cross-references	Topic pairs that share 3 or more source files but don’t link to each other
Low coverage sections	Sections tagged [coverage: low] across all articles — flagged as improvement candidates
Contradictions	Conflicting facts across articles (different dates for the same event, conflicting metrics, decisions described differently in different topics)
Schema drift	Topics in topics/ that aren’t listed in schema.md, topics in schema.md with no corresponding article, or article sections that don’t match the schema’s defined structure

Output format

Wiki Lint: "My Research"
──────────────────────────
Stale:          2 topics (sources changed since last compile)
Orphans:        1 article with missing sources
Cross-refs:     3 missing links suggested
Low coverage:   5 sections across 3 topics
Contradictions: 1 found
Schema drift:   0 mismatches

Stale:
  - retention (3 source files changed since last compile)
  - onboarding (1 source file changed)

Orphans:
  - experiment-archive: source file "experiments/archive-2025.md" not found

Cross-references suggested:
  - retention ↔ experiment-design (share 5 sources)

After the summary, each finding is listed with a suggested fix:

• Stale topics — Run /wiki-compile to refresh
• Orphans — Source was deleted; recompile to remove stale references
• Missing cross-references — Consider adding a reference to [[topic-b]] in topic-a’s Summary section
• Contradictions — Check the named source files to determine the correct value
• Schema drift — Add or remove the listed topic from schema.md

Lint log

Each lint run is appended to {output}/compile-log.md:

### 2026-04-07 — Lint
- Stale: 2, Orphans: 1, Cross-refs: 3, Low: 5, Contradictions: 1, Drift: 0