Search docs

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

Suppression reason missing

Checks that suppression entries include a reason.

warningviolationNo auto-fix

How to fix

  1. Add a clear reason.
  2. Include owner or review context where your workflow expects it.
  3. 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 validate
  • archpilot validate --ci
AP-SUP-001 - Suppression reason missing | ArchPilot Docs