ui-contract

UI Contract

Support production UI within the active workflow and its existing agent budget.

Mockup And Prototype Fast Path

For an explicitly bounded mockup, concept, or prototype, create no durable contract unless requested. Inspect the viewport/objective once; check only clipping, overlap, unreadable copy, broken assets, and major hierarchy failures; use no UI review agent under fast; stop after one successful visual pass. Do not invent production state matrices, breakpoints, or reusable behavior.

Production Define Mode

UI Reuse Gate

Before production JSX, CSS, or layout, inspect the closest screen, shared primitives, layout/responsive patterns, and tokens.

UI Reuse Receipt

Before the first edit, record in ui-contract.md or chat the target, shared path/export, layout precedent, reuse/adapt/none, and planned structural verification; reuse-gate.md defines the exact receipt. Named reuse is an architecture acceptance criterion, not visual equivalence. Resolve its path/export; do not substitute local markup or wrappers without explicit approval. Component reuse alone is insufficient; none needs evidence.

Reuse/adapt the closest primitive and named layout precedent. Do not introduce one-off components, arbitrary font/size/spacing values, or a parallel responsive/layout pattern when an established local pattern covers the need. A “shared components only” constraint forbids custom components/wrappers; compose/adapt or ask. Otherwise, a new primitive needs evidence no candidate fits.

Before substantial undecided production UI implementation, create/update the active plan's ui-contract.md; smaller named-reuse tasks record the receipt in chat. Include only acceptance-relevant details:

• objective and user job;
• surfaces and primary hierarchy/actions;
• typography, spacing, density, color/emphasis, icons, and copy constraints;
• accepted responsive targets;
• relevant loading, error, empty, disabled, partial, hover, focus, and success states;
• accessibility, overflow, and layout-stability constraints;
• reuse decision and any justified new primitive;
• non-goals and review acceptance criteria.