F Kitchen Sink

UX audit rules

React A11Y Role

Rule handbook metadata

Rule
DET.REACT.A11Y_ROLE · lane deterministic
Page status
current
page_version
ff0b0c65b02fd5b179a0115612c24b1dd6493a03243d1208d1b8127f7aeab7bc
generated_at
2026-05-23T13:24:10Z
registry_fingerprint
2ce40848effce579d3e4879f6ca85535183a14db201870a6c007da424624550c

How this rule is fixed

Pilot deterministic fixer: handbook_after · harness mode standalone · verify expect_rule_clean.

  • Harness: apply-harness-fixture-remediation.py copies the After example HTML from this handbook page onto the defect fixture, then invoke-det-ruleset-remediation-verify.sh re-audits and expects zero findings for this rule.
  • Production sites: run-website-ux-remediation-loop.sh runs handbook_html_patch (HTML patches in lib/ux-deterministic-fixers/fixers/patches/) before invoking the Cursor agent when the quality gate still fails.

Detection module: docs/design/ux-audit/deterministic-design-rules.md#det-react-a11y_role. Scroll down for Before / After examples and Evidence and remediation steps.

Purpose

Bootstrap page for the DET ruleset harness. Examples are minimal Kitchen Sink markup aligned with design-rules/deterministic/generated/det-react-a11y-role.check.js.

Passing signals

  • After example satisfies the rule on audit.

Failing signals

Before example

Before (failing example)

After example

After (passing example)

Evidence and remediation

Run generator/build_rule_defect_fixtures.py and auditor-tests/invoke-det-ruleset-harness.sh --only-rule DET.REACT.A11Y_ROLE.