A UI change that compiles is not a UI change that works. "Done" for frontend work means the changed flow was driven in a real browser and watched doing the right thing — not that the build passed and the code looks correct.
When to use
- Any change to pages, components, styles, forms, navigation, or client state
- Before writing "fixed", "done", or "should work now" about anything user-visible
- Reviewing frontend work that arrives with no evidence it was opened
Steps
- Open the app with whatever browser automation or preview the environment provides; start the dev server if none is running. Behind a login wall, follow the verify-authed-apps skill instead of skipping.
- Drive the changed flow specifically — click the button, submit the form, follow the navigation. Rendering the page is not exercising the change.
- Watch the console and network while driving: new errors, warnings, failed requests, and hydration mismatches are failures even when the pixels look right.
- Check the mobile viewport (~375px) for layout, nav, and forms the change touches; then the state extremes the change can produce — empty, loading, error, long content.
- Capture evidence: a screenshot of the working flow, or the exact text observed. Report what was verified and on which viewport, not "it works".
Rules
- No user-visible change ships on build output alone — the browser check is the definition of done.
- Verify the failure path too: force the error branch once (bad input, failed request) and confirm the UI degrades as designed.
- When browser access is genuinely unavailable, say so explicitly, name what was verified instead, and mark the browser check as still owed — never silently downgrade "verified" to "compiled".
- Console noise that predates the change isn't yours to fix silently — note it, don't ignore it.
Examples
Good: "Drove signup -> verify -> dashboard at 1440px and 375px; console clean; error
branch (duplicate email) renders the inline message. Screenshot attached."
Bad: "Build passes and the logic is straightforward, so the flow should work."