align-architecture

To check if your codebase matches architecture decisions, you can compare ADRs and design docs against your actual code to detect boundary violations, missing components, and divergent patterns. This generates an Architecture Compliance Report.

Architecture compliance verification is the process of validating that code implementations reflect documented architectural intent. You need it when ADRs or design documents exist and you want to enforce architectural standards across your repository.

Yes, you can run architecture compliance checks on specific modules. The verification supports targeted incremental scope across modules as well as full repository verification to assess architecture compliance based on your needs.

To generate an architecture compliance report, compare your ADRs and design docs against the codebase. The output persists at docs/calibration/architecture-compliance.md, providing documented gaps, impact, root causes, and clear remediation guidance.

A key limitation when checking code for divergence is that it only applies when ADRs or design documents already exist. Without documented architecture decisions, the tool cannot identify boundary violations or generate a compliance report.