cyberneticlibrary

Health Check Wiki Integrity

wiki-lintcommandsetup L1277
shannhk/llm-wikid
What it does

Health-check wiki for contradictions, orphans, broken links, and stale content

Best for

Maintaining wiki coherence when contradictions and orphan pages must be discovered systematically before they compound.

Inputs
  • · Wiki directory structure with [[wikilinks]] and frontmatter
Outputs
  • · Report file: wiki/lint-report-{date}.md
  • · Contradictions, orphans, broken links, stale pages, duplicate concepts
  • · Automated fixes applied (broken links, missing frontmatter)
  • · wiki/log.md updated with findings
Requires
  • · Grep/Glob (find wikilinks and pages)
  • · CLAUDE.md (conventions reference)
Preconditions
  • · Wiki directory with .md files
  • · CLAUDE.md exists with conventions
  • · Frontmatter fields documented (date_modified, etc.)
Failure modes
  • · Circular wikilinks = linter detects but doesn't auto-break
  • · Stale threshold configurable = 6 months may not fit all projects
  • · Duplicate concept merge manual = auto-merge too risky
  • · Report not read = stale wiki grows unchecked
Trust signals
  • · Detects contradictions between same-topic pages
  • · Identifies unused pages (no inbound wikilinks)
  • · Flags pages not modified in 6 months
  • · Suggests merges for duplicate concepts