validate-links

Broken link detection in markdown files works by cross-referencing internal links against actual file paths on disk. It identifies missing referenced files and reports them as failures, ensuring all internal markdown documentation links resolve correctly.

Back-link symmetry validation checks that schema and requirement markdown files reference each other correctly. It verifies that if a schema links to a requirement, the corresponding requirement file also links back to that schema.

Index completeness validation ensures all markdown requirements and schemas are properly listed in the project's index files. It audits the index coverage to surface any documents that are missing from the central registry.

Yes, you can automate documentation consistency by running validation scripts from the repository root. These scripts execute five core checks including content completeness and counter consistency, reporting all failures and a summary of checks performed.

Counter consistency verification aligns documented file counts with actual on-disk files in your markdown project. If the counters do not match, the validation scripts will report a failure indicating that the tracked counts need updating.