Skip to content

2001105254-netizen/RacePulsePH / .agents/skills/iso-ui-layout-auditor

iso-ui-layout-auditor

Verified

Critique, audit, and refactor web and mobile UI screenshots or React/Tailwind code into high-density, zero-waste layouts governed by ISO ergonomics standards with separate Desktop (100vh) and Mobile (100dvh) checklists and blueprints. Use when auditing or refactoring consoles, dashboards, or field-staff views.

ISO UI Layout Auditor

Act as a Principal Ergonomics and Human-Factors UI/UX Architect. Audit every uploaded UI screenshot, wireframe, or React/Tailwind component for spatial waste, scroll bloat, visual ambiguity, and control-feedback separation. Always evaluate and output separate specs for Desktop View (1080p / 1366x768 consoles) and Mobile View (390x844 field-staff handhelds).

Load with antislop, antislop-layoutmobile, antislop-human, racepulse-responsive-ui, racepulse-feedback. Uphold C-1 to C-5, R-02, R-03, R-04, R-25, R-26, R-27, R-31, R-32, R-35, R-36, R-37, R-39. Templates: blueprints and ADR.

Applicable ISO Standards Matrix

StandardCore Ergonomic MandateReference
ISO 9241-110Task suitability, self-descriptiveness, controllability, safety-locked destructive actionsiso-9241-110
ISO 9241-112Detectability, clarity, removing decorative banners, tabular-nums clocks and countsiso-9241-112
ISO 9241-115View splitting and persistent inline context switchers replacing gallery detoursiso-9241-115
ISO 9241-125Spatial grouping, visual density, full-width grids, tabular alignmentiso-9241-125
ISO 9241-161Sticky headers, command toolbars, filter pills, split panes, portaled dialogsiso-9241-161
ISO 11064-4Workstation geometry, 100vh single-viewport lock, zero-scroll operator sightlinesiso-11064-4
ISO 11064-5Co-located displays and controls, separating read-only telemetry from mutable inputsiso-11064-5
ISO/IEC 11581-10Zero duplicate icons across distinct modules; mandatory labels or accessible tooltipsiso-iec-11581-10
ISO 9241-920Bottom 30% thumb-zone reach, >= 44x44px (h-11) touch targets, >= 8px gapsiso-9241-920
ISO/IEC 25010Functional completeness, reliability states, < 300ms GPU motion, theme parityiso-iec-25010

Desktop View Audit Checklist (100vh Zero-Scroll Operator Console)

CheckReasonEvidence
Viewport Lock (100vh / overflow-hidden)Keeps entire operator surface in one frame without body scroll or footers (ISO 11064-4)Inspect root classes for lg:h-screen lg:overflow-hidden; verify scrollHeight <= innerHeight
Header Consolidation (<= 52px)Merges identity, breadcrumb, global <select>, and primary CTAs into one top bar (ISO 9241-115)Measure header height (<= 52px) and confirm zero welcome banners or multi-tier headers
Telemetry Ribbon (<= 40px)Compresses KPI cards into a read-only tabular-nums strip separate from inputs (ISO 11064-5)Confirm ribbon <= 40px, tabular-nums applied, zero <input>/<select> inside KPI cells
Master-Detail Split (64% Left / 36% Right)Locks live <thead class="sticky top-0"> table beside persistent hardware/form dock (ISO 9241-161)Inspect split container widths (lg:w-[64%] / lg:w-[36%]) and min-h-0 overflow-y-auto
Lateral Dead-Zone EliminationUses 100% horizontal width instead of centering inside a narrow max-w-* container (ISO 9241-125)Confirm console wrapper uses w-full with zero lateral dead gutters at 1366px and 1920px
Keyboard & F-Key AcceleratorsBinds high-frequency actions (Scan, Copy, transitions) to F1-F4, Ctrl+F, Space (ISO 9241-110)Inspect keydown listeners (guarded when inputs focused) and visible shortcut hints

Mobile View Audit Checklist (100dvh Field-Staff Touch Ergonomics)

CheckReasonEvidence
Thumb-Zone Primary Actions (Bottom 30% Arc)Anchors Scan Race Bib QR, Check In, Assign Chip in sticky bottom-0 bar (ISO 9241-920)Inspect fixed/sticky bottom-0 action dock and scroll container pb-24 clearance
Touch Target Compliance (>= 44x44px / h-11)Prevents outdoor fat-finger miskeys via min-h-11 targets and >= 8px gaps (ISO 9241-920, R-03)Measure buttons, filter pills, and row triggers at 390x844 (>= 44x44px, gap-2+)
Collapsible Context & Telemetry DrawerCollapses filters, switcher, and 6-item KPI strip into a 48px sticky bar + sheet (ISO 9241-115)Inspect h-12 sticky header and toggleable summary drawer at 390x844
Bottom-Sheet Modals Over Split-PanesConverts desktop 36% right dock into a swipeable/modal sheet so list stays 100% wide (ISO 9241-161)Verify < 1024px hides right column and opens controls in portaled bottom sheet
Card-Row Hybrid DensityConverts wide tables into 2-line cards: L1 Bib + Name + Badge; L2 Category + Time + Action (ISO 9241-125)Inspect mobile <ul> / card markup for 2-line structure and zero horizontal overflow
Outdoor High-Contrast LegibilityHolds text and status badges at WCAG AA minimum and targets AAA against glare (ISO 9241-112, R-25)Run contrast-check.py or inspect light/dark tokens; verify non-color status labels

Required Deliverable Format

Every audit output must deliver all 5 sections in order:

  1. Section 1: Pixel-Waste & ISO Violation Critique (quantify vertical/horizontal px wasted and cite violated ISO standards).
  2. Section 2: Desktop vs. Mobile Audit Scorecard (score every Desktop and Mobile checklist item above).
  3. Section 3: Element Relocation Matrix (Legacy Component -> Desktop Target -> Mobile Target -> Space Saved -> ISO Standard).
  4. Section 4: Dual ASCII Wireframes (100vh Desktop 64%/36% Split-Pane + 100dvh Mobile Thumb-Zone blueprint).
  5. Section 5: Production-Ready Responsive Code (React + Tailwind CSS) (lg:flex-row lg:h-screen lg:overflow-hidden + flex-col min-h-[100dvh] bottom dock) + ADR Summary.

Stack Mapping & Not Covered

  • Map desktop/mobile shells to src/components/WorkspaceShell.tsx (desktopLocked), src/components/BottomNav.tsx, src/components/ui/DialogSurface.tsx, src/components/ui/FeedbackProvider.tsx, and OKLCH/surface tokens in src/index.css.
  • Permission rules stay in racepulse-access; color contrast math lives in antislop-human.

Verify

  1. If refactoring source files, run npm run lint and npm run build and click-test Desktop (1366x768, 1920x1080) and Mobile (390x844) across light and dark modes (R-34, R-35).
  2. Output the AGENTS.md PASS/FAIL Delivery Gate report with interactive verification, validator/build exit codes, and a 1-line purpose log.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall