lint

name	lint
description	Audit and safely maintain an LLM Wiki vault. Use whenever the user invokes `/lint`, asks to check wiki quality or health, or asks to find and optionally repair broken links, missing frontmatter, stale pages, orphan pages, source drift, or duplicate topics.

Lint an LLM Wiki

Audit structural integrity and knowledge quality. Read wiki-schema.md first; it is the authority for page types, fields, naming, and tags.

Scan

Inspect all wiki/ pages and sources/ files, then use llm-wiki graph to cross-check the wikilink graph. Report these categories:

• Structural: broken links, orphan pages, wanted pages, missing required frontmatter, missing aliases, naming violations, and duplicate topics.
• Content: conflicting claims, stale pages whose sources changed, unsourced claims, and pages too shallow to be useful.
• Sources: unreferenced or untracked source material and source drift.

Report

Present the findings before changing files unless the user explicitly passed --fix. Use this structure:

## Lint Report — YYYY-MM-DD

### Summary
- Total pages: N | Total sources: N
- Issues: N (critical: X, warning: Y, info: Z)

### Critical
### Warning
### Info

Always write the same result in .llm-wiki/lint-result.yaml with date, summary counts, and issue objects (type, severity, page, detail).

Fixes

With --fix, repair only safe, evidence-preserving issues: add missing frontmatter defaults, repair or remove plainly invalid links, add clearly relevant backlinks, and merge unambiguous duplicates while retaining aliases. Never auto-resolve a contradiction. Do not edit raw files under sources/.

Record fixes and unresolved findings in wiki-log.md. Run llm-wiki sync when changes were made.