What problem does it solve?
Documentation in a growing repository drifts out of sync: relative links break, feature maps fall behind actual guides, TODO markers accumulate, and untracked files clutter the root. This Skill runs a structured audit that catches these issues before they reach a milestone commit.
Core Features & Use Cases
- Link Integrity Check: Scans all markdown files and verifies that every relative link points to an existing file, reporting the file and line of any breakage.
- Repository Health Checks: Verifies git working-tree state, warns when working directly on main, detects root clutter, and scans for unresolved TODO, TBD, and FIXME markers.
- Sync and Coherence Validation: Confirms the feature map matches actual guides, checks skill configuration coverage, and runs a semantic consistency review across CONTEXT.md and project skills.
- Use Case: Before merging a documentation update, invoke the audit to confirm no links broke, the feature map is current, and the working tree is clean.
Quick Start
Run the coherence audit across the repository documentation and report any broken links, out-of-sync files, or unresolved TODOs.