jackwener 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.