Empty state usefulness — UX audit rules

Rule handbook metadata

Rule: AI.EMPTY_STATE.USEFULNESS · lane ai
Page status: current
page_version: 9dfe36943d68303cedadd835d7197d2e84cd60783464fff337e07c7f97efdf74
generated_at: 2026-08-13T02:31:57.139Z
registry_fingerprint: aef1de6082cf0f50d463783c843dee0ffb9132fbd5ed4ea6e5bb3f031f359c72

How this rule is fixed

This is an AI-enabled rule. Pass/fail requires model judgment; there is no deterministic fixer in the pilot registry.

Harness: invoke-ai-ruleset-harness.sh runs design-rules/ai/run-design-ai-rule.sh on the Before fixture and expects findings with matching principleId.
Remediation: Cursor agent plans from forge-ux-remediation.plan.md after sitewide audit — not handbook After copy.

Detection module: docs/design/ux-audit/ai-enabled-design-principles.md#ai-empty-state-usefulness. Scroll down for Before / After examples and Evidence and remediation steps.

Purpose

Empty views explain why data is missing and offer a concrete next step. Judgment overlay for AI.EMPTY_STATE.USEFULNESS.

Required finding metadata

Each finding must include: principleId, severity, deterministicCoverage, candidateDeterministicRule, screenshotOrDomEvidence, hashesOrContractsAffected, confidence, recommendedFixScope, sourceFilesLikelyAffected.