---
name: impeccable-ui
description: "Structure/a11y/responsive UI checks and command map. Adapted from pbakaus/impeccable. Use when: impeccable, audit UI, a11y, адаптив, harden, layout, typeset, critique structure. SKIP: visual slop-only (design-taste); DESIGN.md extract (project-design); Vue without a run (writer); PRODUCT.md / hooks."
argument-hint: "[info]"
license: Apache-2.0
---

# Impeccable UI

Lane adapter of [impeccable](https://github.com/pbakaus/impeccable).
Upstream is 23 slash commands + a binary + edit-hooks. **We do not install that.**

Visitor mode (pick from the surface, not the company):

| Mode | Surfaces |
|---|---|
| Persuade | marketing, landing, pricing |
| Operate | cabinet, admin, settings, tools |
| Read | docs, help |
| Experience | portfolio, gallery |

## Info (print and stop)

If `$ARGUMENTS` is `info` / `справка`: print the block below **verbatim**, then **stop**.

```text
impeccable-ui — структура и техника UI. Не хуки и не PRODUCT.md.

Оценка (design-lead, без кода)
- critique / typeset / layout / bolder / quieter / distill
- отчёт + Don'ts в DESIGN.md

Чинить (writer в ране)
- audit / harden / adapt / polish / animate / onboard
- craft-floor: references/craft-floor.md

Чужое
- clarify → copy-lead
- document / extract → project-design
- init / PRODUCT.md / hooks / live → нельзя

Роутер: /lane-stack:web-design info
```

## Command map

| Upstream | Lane |
|---|---|
| `critique` `typeset` `layout` `bolder` `quieter` `distill` | `design-lead` `MODE=audit` |
| `audit` `harden` `adapt` `polish` `animate` `onboard` `colorize` `optimize` | writer run, after «делай» |
| `clarify` | `copy-lead` |
| `document` `extract` `shape` | `project-design` / `page-prototype` |
| `init` `live` `hooks` `doctor` `craft` | **refuse** |

Optional CLI: if `impeccable` is already on `PATH`, `impeccable detect <path>` is allowed as evidence. Do not download the binary, do not enable hooks.

## Audit dimensions (evidence for observed; N/A for unverified)

1. Accessibility — contrast, labels, keyboard, headings, `prefers-reduced-motion`.
2. Performance — layout-property animation, lazy images, unused motion.
3. Theming — hardcoded hex vs `DESIGN.md` tokens.
4. Responsive — fixed widths, 44px targets, no horizontal dump on 375px.
5. States — hover/disabled/loading/empty/error actually exist.

Critique (design-lead) is **one pass**. Do not spawn dual sub-agents. If no screenshot: write `DEGRADED: no screenshot` and continue on source.

## Evidence before verdict

For each finding give the screen/path, observed behavior, user impact, smallest
correction and verification step. Mark each dimension as observed, source-only,
or not checked; an unobserved dimension is not a pass.
Use existing browser evidence or ask the parent for browser-qa. A URL alone is
not visual evidence. Keep subjective style preferences separate from defects.

For task-focused review, also inspect form labels/autocomplete, paste support,
error recovery, focus return from overlays, long/localized content, semantic
links versus buttons, image dimensions and navigation/back behavior. Apply only
checks relevant to the surface; report unavailable evidence explicitly.
Reference: [Vercel Web Interface Guidelines](https://github.com/vercel-labs/web-interface-guidelines).

For a11y/adaptation details and correct WCAG units, read the relevant section of
`web-design/references/specialist-checks.md`. The 44px target above is our comfort
recommendation, not a claim about WCAG AA's minimum. Match checks to actual input
methods and report which interaction states were exercised.

## NEVER

- `npx impeccable install`, `~/.impeccable`, project `.impeccable/` hooks.
- Write `PRODUCT.md`. Product truth is `CLAUDE.md`.
- Replace `DESIGN.md` via upstream `document`. That is `design-lead` extract.
- Fix Vue from the audit agent.