cyberneticlibrary

Health-check wiki for inconsistencies

lintcommandsetup L14
IvanKRZ/LLM-Wiki-Template
What it does

Scan wiki health: contradictions, orphans, stubs, stale claims, broken links

Best for

Periodic health check of a wiki to surface decay (orphans, broken links, stubs) without auto-fixing

Inputs
  • · wiki/ directory with markdown pages
  • · Frontmatter on pages (evergreen flag, ingested_at timestamp)
Outputs
  • · Lint report at wiki/lint-reports/YYYY-MM-DD.md
  • · Log entry appended to wiki/log.md with issue count and critical summary
Requires
  • · Read (all wiki/*.md files)
  • · Write (wiki/lint-reports/**, wiki/log.md)
  • · Bash (grep for links, page count, term frequency)
Preconditions
  • · wiki/ directory with markdown pages
  • · wiki/lint-reports/ and wiki/log.md can be created
  • · Pages use [[PageName]] link syntax
Failure modes
  • · wiki/ directory does not exist
  • · grep or file I/O fails on large wiki
  • · Inconsistent frontmatter format across pages
Trust signals
  • · Distinguishes orphans (no inbound links) from stubs (< 50 words)
  • · Detects stale claims (sources > 180d old without evergreen flag)
  • · Checks index drift (pages missing from index.md)
  • · Report is read-only, user decides action per item
  • · Logs critical counts (contradictions, broken links) for quick scanning