Search docs
Docs searchValidation rule
Back to Rule CatalogAP-ADR-001DocumentationADR directory missing
Checks that the configured ADR directory exists.
warningsetup-gapNo auto-fix
How to fix
- Create the ADR directory.
- Move ADRs into the configured path or update the configuration.
- Add a template ADR so future decisions have a consistent shape.
What it means
ArchPilot expected an ADR directory but could not find it at the configured path.
Why it matters
Architecture decisions need a durable home so validation and review can find decision context.
Common causes
- The docs/adrs directory was not created.
- ADR files live in a non-standard path.
- The architecture docs path changed without updating configuration.
Example bad pattern
Architecture decisions are scattered across pull requests and tickets.Example good pattern
docs/adrs exists and contains accepted ADRs plus a reusable template.Related files/config
docs/adrsdocs/architecture/overview.md
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs