2001105254-netizen/RacePulsePH / .agents/skills/iso-ui-layout-auditor
iso-ui-layout-auditor
VerifiedCritique, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.0 KB |
| references/desktop-mobile-blueprints.md | markdown | 20.7 KB |
| references/iso-11064-4.md | markdown | 3.5 KB |
| references/iso-11064-5.md | markdown | 3.8 KB |
| references/iso-9241-110.md | markdown | 4.2 KB |
| references/iso-9241-112.md | markdown | 3.7 KB |
| references/iso-9241-115.md | markdown | 4.1 KB |
| references/iso-9241-125.md | markdown | 4.2 KB |
| references/iso-9241-161.md | markdown | 3.9 KB |
| references/iso-9241-920.md | markdown | 3.8 KB |
| references/iso-iec-11581-10.md | markdown | 3.4 KB |
| references/iso-iec-25010.md | markdown | 3.6 KB |
references/iso-9241-115.md
View on GitHub# ISO 9241-115: Conceptual Design & Navigation
## Standard Identity & Scope
- **Designation:** ISO 9241-115 (Ergonomics of human-system interaction, Part 115: Guidance on conceptual design, user-system interaction design, user interface design and navigation design).
- **Scope:** Structuring the conceptual model, information architecture, windowing/view splitting, and navigation topology so users move cleanly between tasks without intermediate dead-end hubs.
## Core Principles Audited by This Skill
1. **Direct conceptual mapping:** Screen regions must match the operator's mental model (e.g., Event Context -> Live Runner Queue -> Field/Hardware Action Dock) instead of arbitrary grid mosaics.
2. **Shallow navigation depth:** Replace intermediate landing galleries, redundant "select a module card" detours, and nested sub-dashboards with persistent inline context switchers and direct view splitting.
3. **Windowing & simultaneous view splitting:** Keep related reference data and action panels visible side-by-side on large viewports rather than forcing tab-hopping or full-page route transitions that break context.
4. **Visible navigation state:** Show the active module breadcrumb, current event scope, and mode switch in one predictable, persistent location (`R-24`).
## Desktop Console Criteria (`1080p` / `1366x768`, `100vh`)
- **Consolidated header (`<= 52px`):** Merge brand mark, active module breadcrumb, global event/race `<select>` switcher, and primary toolbar CTAs into one compact top bar.
- **Inline context switching:** Switching the active race event, checkpoint, or filter view must update the split workspace inline without bouncing the operator back to a card selection gallery.
- **Persistent master-detail split:** Display the item directory/queue on the left (`64%`) and the active inspector, scanner, or configuration dock on the right (`36%`) so selection and action share one frame.
## Mobile Field-Staff Criteria (`390x844`, `100dvh`)
- **Single-row sticky context bar (`48px`):** Compress the module title, active event selector trigger, and telemetry drawer toggle into a single sticky header so content starts immediately at `y = 48px`.
- **On-demand detail sheet instead of route loss:** Tapping a runner card or primary tool (`Assign Chip`, `Filters`, `Telemetry`) opens a swipeable or dismissible bottom sheet over the list rather than navigating away and losing scroll position.
- **Predictable back/dismiss paths:** Every sheet and modal closes cleanly via backdrop tap, explicit Close button, or `Escape` (`R-32`).
## React & Tailwind Audit Patterns
```tsx
// Single-tier <= 52px desktop header combining identity, breadcrumb, context select, and CTAs
<header className="h-12 lg:h-[52px] shrink-0 px-3 lg:px-4 border-b border-[var(--border-default)] bg-[var(--surface-card)] flex items-center justify-between gap-3">
<div className="flex items-center gap-2 min-w-0">
<span className="text-sm font-semibold truncate text-[var(--text-primary)]">RacePulsePH</span>
<span className="text-xs text-[var(--text-muted)]">/</span>
<h1 className="text-sm font-semibold truncate text-[var(--text-primary)]">Timing Console</h1>
</div>
<div className="flex items-center gap-2 shrink-0">
<label htmlFor="race-context" className="sr-only">Active Race Event</label>
<select id="race-context" value={raceId} onChange={onRaceChange} className="h-9 lg:h-8 px-2 text-sm rounded-md border border-[var(--border-default)] bg-[var(--surface-page)]">
{races.map((r) => <option key={r.id} value={r.id}>{r.name}</option>)}
</select>
<button type="button" onClick={onExport} className="h-9 lg:h-8 px-3 rounded-md border border-[var(--border-default)] text-sm font-semibold">
Export (F4)
</button>
</div>
</header>
```
## Inspection Evidence
- Measure header height in rendered DOM (`<= 52px` desktop, `48px` mobile sticky bar) and verify zero intermediate card-gallery screens block direct access to the active queue.
- Confirm every navbar/switcher destination resolves to a live view (`R-24`, `R-26`).
- Verify mobile drawer/sheet dismissal restores the exact scroll position of the underlying runner list.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |