App shell integration — UX audit rules

Rule handbook metadata

Rule: DET.APP.SHELL_INTEGRATION · lane deterministic
Page status: current
page_version: d6679097aa455efb6b4abaa448d2f6f957fd8eae4f675b1d0610ad949156c25c
generated_at: 2026-05-28T17:05:34.736Z
registry_fingerprint: aef1de6082cf0f50d463783c843dee0ffb9132fbd5ed4ea6e5bb3f031f359c72

How this rule is fixed

Pilot deterministic fixer: handbook_after · harness mode standalone, live_scenario · 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-app-shell_integration. Scroll down for Before / After examples and Evidence and remediation steps.

Purpose

Inside app workspace shells, flag Bootstrap alert / badge patterns adjacent to governed react-primitive roots.

Before example

Before (failing example)

Failed step

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.APP.SHELL_INTEGRATION.