| name | wiki-lint |
| description | Use when auditing wiki health for contradictions, broken links, orphan pages, stale content, and missing cross-references, then log findings. |
Wiki Lint
Run a health audit over wiki pages.
Scope
Scan under src/content/docs/, excluding:
src/content/docs/index.md
src/content/docs/log.md
Checks
Priority order:
- Errors:
- Broken relative links.
- Missing required frontmatter fields (
title, description).
- Duplicate
# H1 heading that repeats frontmatter title (Starlight already renders the title as H1).
- Warnings:
- Orphan pages (no inbound links).
- Contradictory statements between pages.
- Clearly stale claims.
- Info:
- Missing cross-references between related pages.
- Concepts repeatedly mentioned but lacking a dedicated page.
Process
- Build page/link inventory.
- Produce severity-grouped report with concrete file paths.
- Suggest precise fixes for each issue.
- Append
src/content/docs/log.md:
## [YYYY-MM-DD] lint | <N issues found>
Quality Bar
- Findings first, summary second.
- Prefer actionable fixes over generic advice.
Done Criteria
- Severity-ordered findings are reported.
log.md has lint entry.