F Kitchen Sink

Accessibility audit rules

Handbook Sidebar Labels

Accessibility rule handbook metadata

Rule
AI.A11Y.KS.HANDBOOK_SIDEBAR_LABELS · lane ai · scope ks
Page status
current
page_version
deb6ef4f048aeac15193ad8e3306319fe865e3865df6e198fa13e3d496d6c1c9
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: 2.4.4, 4.1.2

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-ks-handbook-sidebar-labels. See Before / After below.

Purpose

AI judgment overlay (ks 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.KS.HANDBOOK_SIDEBAR_LABELS on the crawled URL.
  • Harness: auditor-tests/invoke-a11y-ruleset-harness.sh AI.A11Y.KS.HANDBOOK_SIDEBAR_LABELS expects ≥1 finding on the Before fixture.

Before example

Before (failing example)

Handbook Sidebar Labels

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

Rule: AI.A11Y.KS.HANDBOOK_SIDEBAR_LABELS · scope: ks

After example

After (passing example)

Handbook Sidebar Labels (remediated)

Signals satisfy the AI rule prompt expectations on review.

AI judgment overlay (ks scope).

Evidence and remediation

  1. Reproduce with analyze-website-a11y.mjs --only-deterministic-rule-ids AI.A11Y.KS.HANDBOOK_SIDEBAR_LABELS 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.