Search docs
Docs searchValidation rule
Back to Rule CatalogAP-ADR-004DocumentationRequired ADR missing for architecture context
Checks that key architecture topics have ADR coverage.
warningsetup-gapNo auto-fix
How to fix
- Add or update an ADR for the missing context.
- Use clear keywords for the architecture topic.
- Link the ADR from overview docs when it explains a central system decision.
What it means
ArchPilot expected an ADR for a configured or detected architecture context but did not find matching evidence.
Why it matters
Core choices such as tenant model, API style, and dependency boundaries should not live only in code.
Common causes
- A major architecture decision lacks an ADR.
- The ADR exists but uses different keywords.
- The required ADR context changed after configuration was written.
Example bad pattern
The repository config says REST, but no API style ADR exists.Example good pattern
An accepted REST API style ADR explains the decision and consequences.Related files/config
docs/adrsdocs/architecture/overview.md
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs