F Kitchen Sink

Accessibility audit rules

Visual Presentation

Accessibility rule handbook metadata

Rule
AI.A11Y.GENERIC.VISUAL_PRESENTATION · lane ai · scope generic
Page status
current
page_version
f48a8bd380b250514ec13d0791a4d90ed5edbca8d329ca822bf1e68b9f5bd626
generated_at
2026-05-28T05:09:12.000Z
registry_fingerprint
b3797010c3ca988bb0d21d5e85d4efece0b9e83f311c2d4981ebbf402df7a7c2

Related WCAG success criteria

Indicative mapping for compliance reporting — not a conformance claim. Criteria: 1.4.8

How this rule is checked

AI lane — enable with --enable-ai. Judgment runs via Cursor/agent using prompts under design-rules/ai/prompts/generated/.

Module: docs/design/a11y-audit/ai-enabled-a11y-principles.md#ai-a11y-generic-visual-presentation. See Before / After below.

Purpose

AI judgment overlay (generic scope).

Passing signals

  • DOM and/or repo signals satisfy the rule implementation in tools/website-a11y-auditor.
  • For axe-backed WCAG criteria, use --lanes axe,det with an appropriate --standard preset.

Failing signals

  • Auditor emits a finding with ruleId AI.A11Y.GENERIC.VISUAL_PRESENTATION on the crawled URL.
  • Harness: auditor-tests/invoke-a11y-ruleset-harness.sh AI.A11Y.GENERIC.VISUAL_PRESENTATION expects ≥1 finding on the Before fixture.

Before example

Before (failing example)

Visual Presentation

Content or UX likely fails human judgment for this AI overlay rule.

Rule: AI.A11Y.GENERIC.VISUAL_PRESENTATION · scope: generic

After example

After (passing example)

Visual Presentation (remediated)

Signals satisfy the AI rule prompt expectations on review.

AI judgment overlay (generic scope).

Evidence and remediation

  1. Reproduce with analyze-website-a11y.mjs --only-deterministic-rule-ids AI.A11Y.GENERIC.VISUAL_PRESENTATION when lane is deterministic.
  2. Apply the After markup pattern (or fix generator source for KS rules).
  3. Re-run harness or audit until the rule is clean on the target URL.