product-ui-audit git:20260906.ccd7eadA

Immutable. This exact content is served forever at /api/v1/blob/6ecb868de1511f27.

---
name: product-ui-audit
description: Review an existing product interface and recommend a product-specific UX direction without changing code.
---

# Product UI Audit

Audit how well an existing interface helps its real user understand, decide, and act.

Audit only. Do not edit code or design files. Use `design-system-ui` for an explicitly requested implementation and `wild-frontend` for explicitly requested unconstrained creative work.

## Goal

Give one coherent, product-aware direction that improves usability and visual quality without replacing required content, inventing product behavior, or defaulting to generic SaaS composition.

## Understand the Product

Inspect the actual screen or screenshot and the minimum relevant product context. When repository or live-page access exists, inspect nearby screens, shared components, tokens, content, and interaction patterns only until the local design language and workflow are clear.

Establish:

- **User**: who uses the interface and how often
- **Job**: the primary decision or action the screen supports
- **Information**: what must be scanned, compared, understood, or trusted
- **Scale**: realistic item counts, content length, and operational extremes
- **States**: loading, empty, error, partial, stale, selected, expanded, disabled, and recovery states that can actually occur
- **Constraints**: required content, business claims, accessibility, platform conventions, and existing product patterns

If key context is unavailable, state which conclusions are provisional. Do not fabricate product requirements from familiar UI patterns.

With screenshot-only evidence, direct observations cover only the visible state and viewport. Interaction, keyboard and screen-reader behavior, hidden states, and responsive behavior at other widths remain unverified. Label such claims as hypotheses and name the interaction or viewport check needed to establish them; do not present an unseen behavior as a confirmed defect or infer that it works from its appearance.

## Audit the Interface

Prioritize findings that materially affect the job:

- information architecture and workflow
- navigation, orientation, and progress
- scanning, comparison, density, and progressive disclosure
- visual hierarchy, typography, spacing, and composition
- interaction affordances and feedback
- accessibility and responsive behavior
- trust, operational clarity, and recovery

Judge the interface at representative scale, not only the visible fixture. A control that works for ten items may fail for hundreds; a compact label may fail with real localized content.

Separate:

- **Usability defect**: blocks, misleads, hides, or makes the task materially harder
- **Product gap**: information or behavior needed for the job is absent
- **Visual weakness**: composition or hierarchy reduces clarity or quality
- **Preference**: a defensible aesthetic choice, not a defect

## Choose a Direction

Recommend one dominant screen model rather than a collection of unrelated component suggestions. Prefer removal, consolidation, hierarchy, and progressive disclosure before adding new surfaces.

Avoid defaulting to:

- nested cards or boxed regions without a grouping purpose
- repeated status, badges, labels, or calls to action
- loading states for content that is static or immediately available
- ambiguous icons or controls that imply unsupported interaction
- dashboards, summaries, filters, or metrics that do not change a decision
- removing required copy or business content instead of improving its presentation
- generic advice such as “improve spacing” without a concrete compositional change

Preserve the product's domain language and distinguish authoritative facts from estimates, heuristics, or decorative indicators.

## Output

Lead with a direct verdict on the current interface and its largest usability gap.

Then provide, as applicable:

- **User and job**: the operative task model
- **Prioritized findings**: evidence, impact, and why the current design fails
- **Recommended direction**: the coherent screen model and hierarchy
- **Remove or consolidate**: what should disappear or merge
- **Critical states and scale**: conditions the redesign must support
- **Implementation handoff**: concrete behavior and composition guidance without writing code

Use a compact wireframe or flow only when it explains the proposed hierarchy better than prose. Do not pad the audit with generic design principles.

## Stop Rules

Stop when the dominant product problem, coherent direction, material findings, and required states are clear enough for design or implementation. If the current interface is already strong, say so and limit recommendations to genuine gaps.