Wiki Lint

Inspect a markdown knowledge wiki for structural and content quality problems. Produce actionable findings that improve consistency, navigability, and trustworthiness without forcing unnecessary rewrites.

Lint workflow

1. Inspect the wiki schema and top-level structure
2. Review index.md and log.md when available
3. Sample representative topic, entity, concept, source, and analysis pages
4. Identify the highest-value consistency and maintenance issues
5. Group findings by severity
6. Recommend concrete fixes
7. When asked, implement the highest-value fixes first

What to look for

Check for:

• contradictions between pages
• stale claims superseded by newer material
• orphan pages with weak or missing inbound links
• duplicate pages with overlapping scope
• missing cross-links between obviously related pages
• important repeated concepts that still lack canonical pages
• broken naming conventions
• inconsistent frontmatter or page structure
• weak citation or source attribution
• analysis pages that should be linked from topic or entity pages but are not

Output shape

Prefer a concise report grouped into:

• critical consistency issues
• important quality improvements
• optional structure improvements

For each issue, include:

• what is wrong
• why it matters
• the smallest useful fix

Linting philosophy

Prefer gradual repair over massive rewrites. Follow existing conventions unless they are clearly harmful. If a larger schema change is justified, propose it before applying it.

References

Read references/lint-checklist.md for a compact checklist and reporting pattern.