jackwener/llm-wiki/lint

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.