agent-adr-drift-detector

You can verify ADR compliance by running an audit tool that locates ADR files, extracts their documented decisions, and searches your source code for evidence of alignment or drift. It then generates a structured report highlighting deviations and recommended actions.

ADR drift detection is the process of auditing code compliance by comparing actual source code implementations against the decisions documented in Architecture Decision Records. It surfaces architectural deviations and generates actionable findings for compliance audits.

To audit ADR compliance, run a drift detector against your repository. It will automatically locate ADR directories, parse the ADR files and frontmatter to extract decisions, and verify them against your source files to produce a structured drift report.

Yes, ADR drift detection works with software repositories containing ADRs stored as files. It reads the ADR frontmatter and body text to extract core decisions, then searches your source files for evidence to verify alignment and produce a drift report.

The best way to generate an architecture compliance report is to use an automated ADR drift detector. It aligns your code with documented Architecture Decision Records and produces a structured report detailing alignment, deviations, and recommended actions.

ADR drift detection relies on locating ADR files and searching source files for evidence of stated decisions. It is limited to repositories containing ADRs and may require manual review to interpret nuanced architectural deviations surfaced in the generated drift report.