← ClaudeAtlas

ui-contractlisted

Use when work touches what a screen looks like: a new screen, a redesign of an existing screen, a visual defect to fix and show fixed, or a "looks right" claim with no image behind it. Fires on "what should this screen look like", "show me every state of this list", "check it in light and dark", "prove the layout is fixed", "I need a mockup of this screen", "redesign the existing home page", "the form overflows on mobile, fix it", "dark mode is wrong on this page". A visual defect (misaligned, overflowing, spacing off) owes a before/after image, so this fires even when a bug fix also applies. Not for: usability or accessibility audits with findings (/aidex:audit); choosing a test layer (/aidex:coverage); any `.context/` page or board, even a visual defect on one (/aidex:artifact); writing the implementation plan (/aidex:plan).
yacb2/aidex · ★ 2 · Web & Frontend · score 81
Install: claude install-skill yacb2/aidex
# UI contract > **Status: experimental.** Proven on owner-shaped harnesses; say so before relying on it. The contract for what "matches" means is a **state gallery rendered by the project's real components** against fixture data — one entry per state-matrix cell — reviewed by the owner through a consultation page. Not a drawn mockup: a drawing cannot be checked against reality and shows things the real components cannot do. Canon: ADR `2026-09-21-ui-contract-state-galleries-and-evidence-gate`. ## When this fires | Moment | What this skill owes | |---|---| | A screen is being designed and no plan exists yet | **Step 0**: the harness check, then the design discussion, ending in a standalone `ui-contract.md` | | A plan is being written and the work touches UI | the plan's **UI-contract section** (below), with the level proposed | | A UI phase is about to close | the three parts of **"verified"** in the Execution log | | A visual bug is being fixed | a before/after gallery consultation (`/aidex:artifact`) for the owner: the proof a regression test cannot be. The contact sheet, and any HTML built from it, is yours: never opened for the owner | If the work touches no screen, this skill owes nothing and costs nothing — say so in one line and stop. ## Step 0 — At fire time: the harness, then the design discussion **Check the harness first, before any plan or discussion.** Read the testing profile's `gallery_gate_cmd`, `gallery_scripts` and `ui_patterns_ref` (optional keys; th