Skip to content

Require 4.5:1 contrast for normal-size text - #15

Open
dbalders wants to merge 1 commit into
UCSD:mainfrom
dbalders:fix-text-contrast
Open

dbalders wants to merge 1 commit into
UCSD:mainfrom
dbalders:fix-text-contrast

Conversation

@dbalders

@dbalders dbalders commented Oct 10, 2026 •

Copy link
Copy Markdown

Part of #12.

Why

The accessibility rule allowed 3:1 contrast for all text:

Minimum 3:1 contrast against adjacent colors for UI components, graphical objects, and text.

WCAG 2.1 AA, which the rule cites, requires 4.5:1 for normal-size text (1.4.3). 3:1 applies only to:

  • large text: 18pt, or 14pt bold, which is 24px or 18.66px bold
  • UI components and graphics (1.4.11)

An agent following the rule could ship body text that fails AA. The skill's summary bullet said the same 3:1.

What changed

  • rules/40-accessibility.md, "Content and presentation": "Contrast is at least 4.5:1 for text, 3:1 for large text (24px, or 18.66px bold), and 3:1 for UI components and graphics against adjacent colors."
  • skills/ucsd-decorator/SKILL.md: the Accessibility summary bullet says the same.
  • Generated files: recompiled CLAUDE.md, AGENTS.md, .cursorrules, .github/copilot-instructions.md, and references/accessibility.md, and resynced library/.
  • CHANGELOG.md: one entry under Unreleased → Fixed.

CLAUDE.md goes from 24,770 to 24,822 characters (budget 25,000).

Verification

The accessibility rule allowed 3:1 for all text. WCAG 2.1 AA (1.4.3) requires
4.5:1 for normal-size text; 3:1 applies to large text and, under 1.4.11, to UI
components and graphics. The skill's summary bullet said the same 3:1 and is
corrected too. Part of UCSD#12.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant