Search docs

Docs search
Back to Rule Catalog
AP-ADR-001Documentation

ADR directory missing

Checks that the configured ADR directory exists.

warningsetup-gapNo auto-fix

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 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/adrs
  • docs/architecture/overview.md

Related CLI commands

  • archpilot validate
  • archpilot validate --ci
AP-ADR-001 - ADR directory missing | ArchPilot Docs