Accessibility audit rules — Forge Design System

Accessibility auditor ecosystem

Every rule has a handbook page at a11y-audit-rules/<rule-id-kebab>.html (example: DET.A11Y.GENERIC.LANG). See Accessibility auditor ecosystem for lanes (axe, DET, AI), standards presets, and KS auto-detection. Before/After gallery shows all rule fixtures on one page.

Lifecycle

Canonical definitions live under docs/design/a11y-audit/. The blender emits registry.generated.json. Handbook pages live in docs/design/a11y-audit/rule-pages/ and compile to showcase/a11y-audit-rules/.

Blend — npm run blend-rules in tools/website-a11y-auditor.
Bootstrap pages — python3 generator/bootstrap_a11y_rule_pages.py (initial/stub refresh).
build-showcase — compiles ecosystem, gallery, and per-rule HTML.

Refresh handbook

cd tools/website-a11y-auditor
npm run blend-rules
cd ../..
python3 generator/bootstrap_a11y_rule_pages.py
python3 generator/build-showcase.py

Coverage summary

Registry fingerprint: e11a2939d018a45bae7d6e23364aba2ae4e13f190d942f49891c89ea84c44c46
Total rules: 21
Deterministic: 17
AI: 4
Handbook current: 21

Deterministic rules (DET.A11Y.*)

Each rule has its own page under a11y-audit-rules/ — click the rule id or Open page for purpose, scope, Before/After, and remediation.

Rule	Scope	What it checks	Examples	Open page
`DET.A11Y.GENERIC.APP_FOCUS_TRAP` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.GENERIC.CONTRAST` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.GENERIC.DATA_TABLE_HEADERS` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.GENERIC.DIAGRAM_ALT` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.GENERIC.FOCUS_ORDER` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.GENERIC.IMAGES_ALT` current	`generic`	generic scope · Informative images need meaningful alt.	Before/After	Open page
`DET.A11Y.GENERIC.LANDMARKS` current	`generic`	generic scope · One main landmark and nav when chrome links exist.	Before/After	Open page
`DET.A11Y.GENERIC.LANG` current	`generic`	generic scope · Root html must declare lang.	Before/After	Open page
`DET.A11Y.GENERIC.MOTION_FLASH` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.GENERIC.MOTION_REDUCED` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.GENERIC.TITLE` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.GENERIC.VIEWPORT` current	`generic`	generic scope · Deterministic accessibility check (generic scope).	Before/After	Open page
`DET.A11Y.KS.BREADCRUMB` current	`ks`	ks scope · Deterministic accessibility check (ks scope).	Before/After	Open page
`DET.A11Y.KS.HANDBOOK_SINGLE_H1` current	`ks`	ks scope · One primary h1 inside handbook chapter layout.	Before/After	Open page
`DET.A11Y.KS.HASH_MARKERS` current	`ks`	ks scope · hash and data-ks-hash must agree on visual roots.	Before/After	Open page
`DET.A11Y.KS.PY_HASH_ATTRS` current	`ks`	ks scope · Deterministic accessibility check (ks scope).	Before/After	Open page
`DET.A11Y.KS.REACT_A11Y_ROLE` current	`ks`	ks scope · Deterministic accessibility check (ks scope).	Before/After	Open page

AI rules (AI.A11Y.*)

Each rule has its own page under a11y-audit-rules/ — click the rule id or Open page for purpose, scope, Before/After, and remediation.

Rule	Scope	What it checks	Examples	Open page
`AI.A11Y.GENERIC.FORM_ERROR_ASSOCIATION` current	`generic`	generic scope · AI judgment overlay (generic scope).	Before/After	Open page
`AI.A11Y.GENERIC.KEYBOARD_TASK_FLOW` current	`generic`	generic scope · AI judgment overlay (generic scope).	Before/After	Open page
`AI.A11Y.KS.HANDBOOK_SIDEBAR_LABELS` current	`ks`	ks scope · AI judgment overlay (ks scope).	Before/After	Open page
`AI.A11Y.KS.REGION_LABELING` current	`ks`	ks scope · AI judgment overlay (ks scope).	Before/After	Open page