a11y agent fixed contrast by changing brand colors: broke design approval

a11y agent fixed contrast by changing brand colors: broke design approval - how to fix it

TL;DR

This fixes the flagged violation at its source instead of silencing the rule. The agent fixed contrast by swapping brand colors and broke the approved design, a process failure not a color failure. Follow the steps, re-run the scan, and gate the rule in CI so it stays fixed.

The error, verbatim

a11y agent fixed contrast by changing brand colors: broke design approval

Fix it step by step

Step 1

Revert the brand color change and fix contrast surgically: darken text or lighten the surface it sits on.

Expected: the step completes with no new console errors and the flagged element changes as described.

Step 2

Scope agent color edits to text and background tokens only, never brand palette tokens.

Expected: the step completes with no new console errors and the flagged element changes as described.

Step 3

Add a design-token diff review step: any agent PR touching color tokens needs a designer sign-off.

Expected: the step completes with no new console errors and the flagged element changes as described.

Step 4

Re-run the contrast check on the surgically fixed pair.

Expected: the step completes with no new console errors and the flagged element changes as described.

When to use this skill

• Your scan report lists this exact rule or failure
• You are clearing automated accessibility failures before release or audit
• A CI accessibility gate is red because of this item

When NOT to use this skill

• Contrast fixes that redesign the brand will always be reverted; fix the pair, not the palette.
• The issue only appears in manual screen-reader testing and no automated rule flags it
• You are doing a full manual WCAG audit; this skill covers one automated check

Compatibility

Agent workflow guardrail; verify with axe color-contrast.

Variant phrasings

agent contrast fix changed brand colors broke design approval

Same underlying issue and the same fix. Searchers phrase it different ways; the remediation does not change.

Why it happens

The agent fixed contrast by swapping brand colors and broke the approved design, a process failure not a color failure. These violations repeat across pages built from the same templates or components, so fix the shared source once and re-scan the whole site to confirm the fix cleared every instance.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_wV3tx2kpvgNj2RCwPrkspw