F Kitchen Sink

UX audit rules

Section Heading

Rule handbook metadata

Rule
DET.SECTION.HEADING · lane deterministic
Page status
current
page_version
78c1baf2f436e662019243145c7d16e9ccd7421dd76c80e388e70a5aab80727a
generated_at
2026-05-23T13:24:10Z
registry_fingerprint
aef1de6082cf0f50d463783c843dee0ffb9132fbd5ed4ea6e5bb3f031f359c72

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-section-heading. 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-section-heading.check.js.

Passing signals

  • After example satisfies the rule on audit.

Failing signals

Before example

Before (failing example)

Page title

Skipped level

Heading hierarchy jumps from h1 to h3.

After example

After (passing example)

Forge UX rule handbook for section headings

Section

Sequential heading levels.

Evidence and remediation

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