The Web HIG: a versioned behavioral contract for humans, CI, and AI agents

Description and use

<p>Your design system probably nails color, type, and button variants. WCAG covers accessibility conformance. Your framework docs cover routing and data fetching.<br> Then you ask an AI agent to “add a delete project flow,” and you get a modal that optimistically removes the row, no focus trap, hex colors sprinkled in the CSS, and a toast that says “Success!” without telling anyone <em>what</em> succeeded.<br> That gap — <strong>portable, testable product behavior</strong> — is what <a href="https://github.com/frozonfreak/hig" rel="noopener noreferrer">The Web HIG</a> is for.</p> <h2> Not a co

Problem

<p>Your design system probably nails color, type, and button variants. WCAG covers accessibility conformance. Your framework docs cover routing and data fetching.<br> Then you ask an AI agent to “add a delete project flow,” and you get a modal that optimistically removes the row, no focus trap, hex colors sprinkled in the CSS, and a toast that says “Success!” without telling anyone <em>what</em> succeeded.<br> That gap — <strong>portable, testable product behavior</strong> — is what <a href="https://github.com/frozonfreak/hig" rel="noopener noreferrer">The Web HIG</a> is for.</p> <h2> Not a co

Outcome

<p>Your design system probably nails color, type, and button variants. WCAG covers accessibility conformance. Your framework docs cover routing and data fetching.<br> Then you ask an AI agent to “add a delete project flow,” and you get a modal that optimistically removes the row, no focus trap, hex colors sprinkled in the CSS, and a toast that says “Success!” without telling anyone <em>what</em> succeeded.<br> That gap — <strong>portable, testable product behavior</strong> — is what <a href="https://github.com/frozonfreak/hig" rel="noopener noreferrer">The Web HIG</a> is for.</p> <h2> Not a co

Evidence

The Web HIG: a versioned behavioral contract for humans, CI, and AI agents

Source