Search docs

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

ADR status missing or invalid

Checks that ADR files include a recognized decision status.

warningsetup-gapNo auto-fix

How to fix

  1. Add a clear status field or status heading.
  2. Use a supported value such as accepted where appropriate.
  3. Update old ADRs to the current template.

What it means

An ADR is missing status metadata or uses a status value ArchPilot does not recognize.

Why it matters

Status tells reviewers whether a decision is proposed, accepted, superseded, or retired.

Common causes

  • The ADR template was not used.
  • The status line was renamed.
  • The status value is free-form instead of a supported ADR status.

Example bad pattern

Status: maybe final

Example good pattern

Status: accepted

Related files/config

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

Related CLI commands

  • archpilot validate
  • archpilot validate --ci
AP-ADR-003 - ADR status missing or invalid | ArchPilot Docs