Search docs
Docs searchValidation rule
Back to Rule CatalogAP-SUP-001DocumentationSuppression reason missing
Checks that suppression entries include a reason.
warningviolationNo auto-fix
How to fix
- Add a clear reason.
- Include owner or review context where your workflow expects it.
- Prefer exceptions for governed temporary risk acceptance.
What it means
A suppression exists without enough justification for future reviewers.
Why it matters
Suppressions hide findings, so each one needs accountable context.
Common causes
- A suppression was added quickly to unblock CI.
- The reason field was left blank.
- An old suppression format was copied.
Example bad pattern
{ "ruleId": "AP-DEP-004", "reason": "" }Example good pattern
{ "ruleId": "AP-DEP-004", "reason": "Temporary migration approved until scheduler boundary lands" }Related files/config
.archpilot/suppressions.json.archpilot/exceptions.json
Related CLI commands
archpilot validatearchpilot validate --ci