docs-check

To check ADR documentation quality, validate that each ADR contains the decision, context, and rationale. A 5-axis documentation check identifies decay, bloat, and missing rationale across ADRs to ensure current decisions are accurately reflected.

The best way to detect outdated file paths and duplication is performing a documentation hygiene scan. This checks for code-architecture mismatches, warns on obsolete paths, and identifies redundant content across flow, data-schema, and PRD documents.

Generate a remediation report by scanning docs/ for decay and bloat during a 5-axis check. The process produces a concise report containing practical cleanup suggestions tailored to reduce over-complicated sections and remove obsolete references.

Documentation governance requires ADRs to contain the decision, context, and rationale sections. Validating these elements ensures architectural decisions are self-evident and properly tracked within your project's governance workflow.

You can audit PRD and data-schema documents by running a 5-axis check targeting inference and duplication. This analysis detects overlapping content and implicit reasoning gaps across your documentation set to improve overall clarity.

Automated documentation quality checks are limited to structural analysis of ADRs, flow, data-schema, and PRD files. They cannot assess subjective business logic correctness but instead flag inference gaps, duplicated paths, and excessive code blocks.