Skip to content

feat: add qprobe design command for deterministic UI design QA - #4

Merged
drepkovsky merged 1 commit into
mainfrom
feat/design-command
Jun 14, 2026
Merged

feat: add qprobe design command for deterministic UI design QA#4
drepkovsky merged 1 commit into
mainfrom
feat/design-command

Conversation

@drepkovsky

Copy link
Copy Markdown
Member

Adds qprobe design <url> — measure the rendered UI for layout and design-token defects, deterministically and without a vision model.

  • Launches headless Chromium; per --viewport, runs a DOM geometry scan (overflow, truncation, collapse, sibling overlap, near-miss misalignment, tap targets, sub-16px input fonts) and a CSS-variable token-conformance scan (off-palette colors, off-token box-shadows, off-token border-radii). Prints JSON findings.
  • The token scan learns tokens at runtime by probing every :root CSS variable through a throwaway element — no per-stack config, works on any CSS-variable design system, and sidesteps the text-format mismatch where a token shadow and a rendered shadow never compare equal as strings.
  • Scanners are shared verbatim with the agent-board agent-board-design-qa skill (one source of truth).

Dogfooded against a live app: 36 findings across two viewports (12 blocking overflow @375, off-token shadows, small tap targets), zero color/radius false positives. Typecheck + build + 213 unit tests + a CI-safe routing test green. Browser-launch isn't exercised in CI (no Chromium on the bare runner).

Changeset included (minor bump).

🤖 Generated with Claude Code

Launches headless Chromium and, per --viewport, runs a DOM geometry scan plus a CSS-variable token-conformance scan, printing JSON findings. The scanners are shared verbatim with the agent-board design-qa skill (one source of truth). Browser-launch is dogfooded; CI keeps a routing test since the bare runner has no Chromium.
@drepkovsky
drepkovsky merged commit 0bfb748 into main Jun 14, 2026
@drepkovsky
drepkovsky deleted the feat/design-command branch June 14, 2026 12:28
@github-actions github-actions Bot mentioned this pull request Jun 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant