ADR directory missing

How to fix

1. Create the ADR directory.
2. Move ADRs into the configured path or update the configuration.
3. Add a template ADR so future decisions have a consistent shape.

What the rule validates

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.

Typical violation example

Architecture decisions are scattered across pull requests and tickets.

Typical compliant example

docs/adrs exists and contains accepted ADRs plus a reusable template.

Related rules

Adjacent categories

Related files/config

• docs/adrs
• docs/architecture/overview.md

Related CLI commands

• archpilot validate
• archpilot validate --ci