ArchPilotExecutable architecture guardrails

Search docs

Docs search

Validation rule

Back to Rule Catalog
AP-SUP-004Documentation

Duplicate suppression entry

Flags duplicate suppression entries.

warningviolationNo auto-fix

How to fix

  1. Keep one suppression entry.
  2. Prefer the narrowest useful scope.
  3. Remove stale duplicates after merge conflict resolution.

What the rule validates

The same suppression appears more than once.

Why it matters

Duplicates make governance review noisy and can hide which approval is current.

Common causes

  • A suppression was added twice during conflict resolution.
  • Multiple tools wrote the same entry.
  • The same finding was suppressed at overlapping scopes.

Typical violation example

Two identical AP-DEP-004 suppression records exist for the same file.

Typical compliant example

One scoped suppression record explains the approved exception.

Related rules

AP-ADR-001 - ADR directory missingAP-ADR-002 - ADR file missing titleAP-ADR-003 - ADR status missing or invalidAP-ADR-004 - Required ADR missing for architecture context

Adjacent categories

Documentation Rules

Related files/config

  • .archpilot/suppressions.json
  • .archpilot/exceptions.json

Related CLI commands

  • archpilot validate
  • archpilot validate --ci

Related docs

Rule CatalogQuick Fixes, Exceptions & Suppressions
AP-SUP-004 - Duplicate suppression entry | ArchPilot Docs