Linting is the immune system of the wiki. It finds structural decay and logic drift before fluent, source-looking pages become unreliable.
Lint checks
| Check |
What to find |
Typical fix |
| Broken wiki-links |
[[links]] pointing to missing pages or renamed pages. |
Create the missing page, update the link, or add a redirect note. |
| Orphan pages |
Pages with no inbound links from index.md or related concepts. |
Add real connections or mark the page as archival. |
| Contradictions |
Claims that cannot both be true under the same scope and date. |
Record both claims, add source context, and request human review. |
| Stale claims |
Pages with outdated dates, superseded tools, or unsupported freshness. |
Mark Needs Update and add a source-refresh task. |
| Missing provenance |
Claims without a source path, source summary, or review note. |
Add source links or demote the claim to draft. |
Copy-paste lint prompt
Run a lint pass over wiki/.
Check:
- index.md contains every public wiki page and no missing files.
- Every [[wiki-link]] resolves.
- Every page has title, type, status, source_status, and related fields.
- Orphan pages are listed with proposed inbound links.
- Contradictions are listed in wiki/contradictions.md.
- Claims older than the review threshold are marked Needs Update.
- log.md receives a lint entry with findings and files changed.
Do not delete pages. Propose removals separately.
Severity levels
| Severity |
Meaning |
Action |
| Blocker |
Raw source loss, public false authority claim, or broken core route. |
Stop and ask for human decision. |
| High |
Unsupported claim, contradiction, or missing source on a relied-upon page. |
Mark visibly and schedule review. |
| Medium |
Broken link, orphan page, stale review date, or weak metadata. |
Fix during lint if safe. |
| Low |
Formatting, naming, or related-page cleanup. |
Batch with routine maintenance. |
