ln-600-docs-auditor

Documentation auditing scans Markdown files in your repository to evaluate hierarchy, SSOT (single source of truth), compression, requirements coverage, actuality, and legacy issues. The auditor builds a CLAUDE.md-based hierarchy and produces a compliance score with actionable findings to improve structure and accuracy.

The auditor detects six categories of issues: hierarchy problems (structure and organization), SSOT violations (duplication across docs), compression failures (unnecessary verbosity), missing requirements, outdated information, and legacy content. Each category receives a score and remediation recommendations.

Yes. The auditor is designed for post-update reviews and CI pipeline integration to surface documentation quality issues automatically. It scans Markdown-based projects with CLAUDE.md as root, README.md, and docs/ directories, then outputs structured findings for gating or reporting.

The auditor works with Markdown-based projects, scanning CLAUDE.md (as the root reference), README.md, and docs/ directories. It builds hierarchy from CLAUDE.md structure and evaluates all Markdown files against the six audit categories.

The auditor generates a compliance score, per-category scores, and structured findings that include identified issues and concrete remediation steps. Output is formatted for integration into reports, dashboards, or CI workflows.

The auditor requires Markdown files organized with CLAUDE.md as the root hierarchy reference. It works best on projects with established README.md and docs/ directories, though it will audit whatever Markdown structure exists and identify hierarchy gaps.