docs-audit

Documentation drift is detected by auditing project repositories to identify mismatches between code, README content, and API references. The audit generates structured findings that surface missing or outdated documentation across multiple project sources.

ADR coverage gap analysis validates the presence of Architecture Decision Records against actual code changes. It identifies missing ADRs and surfaces outdated architecture documentation to ensure project decisions are accurately recorded.

To audit API documentation alignment, run a documentation audit on your repository to validate API references against code changes. The process produces actionable findings and remediation guidance for misaligned or stale API docs.

README quality is assessed by auditing README sections across project directories to ensure consistency. The audit checks for required sections and identifies outdated content, producing structured drift findings for remediation.

The documentation audit is suitable for codebases with ADRs, architecture decisions, and multiple documentation sources. It evaluates READMEs, docs directories, and API references simultaneously to produce comprehensive drift findings.