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.

references/iso-9241-112.md

View on GitHub
# ISO 9241-112: Principles for the Presentation of Information

## Standard Identity & Scope

- **Designation:** ISO 9241-112 (Ergonomics of human-system interaction, Part 112: Principles for the presentation of information).
- **Scope:** Modality-independent principles ensuring presented information is detectable, distinguishable, clear, concise, consistent, and legible across visual and auxiliary displays.

## Core Principles Audited by This Skill

1. **Detectability:** Critical statuses, live connectivity indicators, and active timing counters must stand out immediately without hunting through decorative chrome.
2. **Discriminability:** Adjacent states (`Paid` vs `Pending`, `Finished` vs `DNF`, `Online` vs `Offline`, `Read-Only Telemetry` vs `Editable Input`) must differ clearly through shape, label, and contrast rather than subtle hue shifts alone.
3. **Clarity & Conciseness:** Eliminate verbose welcome paragraphs, marketing hero banners inside operational consoles, redundant multi-line card headers, and eyebrow capsule badges (`AGENTS.md` Hard Gate).
4. **Consistency:** Use uniform number formatting, timestamps, badge semantics, and unit placements across every row, telemetry strip, and modal.
5. **Legibility:** Enforce high contrast and `tabular-nums` alignment for all live clocks, bib numbers, split times, counts, and currency values so digits never jitter horizontally as values update.

## Desktop Console Criteria (`1080p` / `1366x768`, `100vh`)

- **Zero decorative welcome banners:** Strip greeting cards, explanatory prose blocks, and multi-tier headers that push operational data down the screen.
- **High-density telemetry ribbon (`<= 40px`):** Replace oversized KPI hero tiles with a single horizontal readout strip using `tabular-nums` (`font-mono tabular-nums` or `font-sans tabular-nums`) for aligned counts and clocks.
- **Strict column scanability:** Right-align numeric metrics, timestamps, and currency columns; left-align runner names and categories; truncate overflowing secondary strings with accessible full titles (`title` or expandable detail).

## Mobile Field-Staff Criteria (`390x844`, `100dvh`)

- **Outdoor sunlight contrast:** Enforce strong foreground-to-surface contrast (targeting WCAG AAA `7:1` where feasible for critical field status labels and primary action text, and strictly at least WCAG AA `4.5:1` / `3:1` large text per `R-25`).
- **2-line hybrid card legibility:** Restrict each row card to high-signal fields:
  - Line 1: `Bib #` (`tabular-nums font-semibold`) + `Runner Name` + `Status Badge`
  - Line 2: `Category` + `Official Time` (`tabular-nums`) + `One-Tap Action`
- **No color-only status encoding:** Pair semantic color fills/borders with explicit text labels or distinct icons (`R-39`).

## React & Tailwind Audit Patterns

```tsx
// Telemetry readout cell: tabular alignment + concise label + explicit contrast
<div className="flex items-center gap-2 px-3 py-1 border-r border-[var(--border-default)]">
  <span className="text-xs font-normal text-[var(--text-secondary)]">Checked In</span>
  <span className="text-sm font-semibold font-mono tabular-nums text-[var(--text-primary)]">
    {checkedInCount} / {totalCount}
  </span>
</div>
```

## Inspection Evidence

- Measure text and badge foreground/background contrast ratios across light and dark modes (using `antislop-human/contrast-check.py` or inspected tokens) to confirm `>= 4.5:1` normal / `>= 7:1` outdoor critical targets (`R-25`, `R-34`).
- Inspect numeric columns, live timers, and KPI strip values for `tabular-nums` classes (`font-mono tabular-nums` or `tabular-nums`).
- Confirm zero decorative hero banners, eyebrow pills, or redundant section titles remain inside the operational viewport.
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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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