Search docs
Docs searchValidation rule
Back to Rule CatalogAP-ADR-003DocumentationADR status missing or invalid
Checks that ADR files include a recognized decision status.
warningsetup-gapNo auto-fix
How to fix
- Add a clear status field or status heading.
- Use a supported value such as accepted where appropriate.
- 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 finalExample good pattern
Status: acceptedRelated files/config
docs/adrsdocs/architecture/overview.md
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs