{"slug": "maybe-don-t-rely-on-google-s-modern-web-guidance", "title": "Maybe Don't Rely on Google's \"Modern Web Guidance\"", "summary": "Google's new \"Modern Web Guidance\" tool, designed to help AI coding agents build accessible web experiences, produced a non-conformant accordion component that fails to work in Firefox and does not meet WCAG accessibility standards, according to an analysis by developer Adrian Roselli. The tool's launch example also lacked tailored accessibility guidance for common patterns like toast notifications, repeating past mistakes where Google released features without proper accessibility consultation. The findings raise concerns about the reliability of Google's AI-powered development guidance for building legally compliant, accessible web applications.", "body_md": "# Maybe Don’t Rely on Google’s “Modern Web Guidance”\n\nJust in time for Google I/O, the Chrome for Developers site announced *Modern Web Guidance* (MWG):\n\nModern Web Guidance is a set of evergreen and expert-vetted skills that guide your AI coding agents across many common use cases to build modern web experiences that are accessible, performant, and secure.\n\nI appreciate this set of LLM skills lists accessibility first, something I feel strongly *every* MVP (or early preview\n\nas Google calls this) must:\n\nSimply, if your MVP does not have accessibility factored in, it is not viable. If you claim accessibility is a core principle but your version 0 does not include it, then it is not a core principle.\n\nLast year I made a straightforward and simple request to Google (that also respects the law in most jurisdictions where Google does business):\n\nPlease, if your team cannot explain how\n\nthe thingsatisfies all[WCAG Success Criteria]at Level AA, then don’t releasethe thing.\n\nUnfortunately, MWG accessibility doesn’t satisfy. Partly because not every pattern has tailored guidance. For example, you may remember when Google ran at a toast pattern before abandoning it:\n\nAgain, the people designing the feature neither understood accessibility nor had consulted anyone who did while they designed it, instead relegating accessibility to the later stages of their design and assuming it could simply be remediated with a modest effort and without any serious redesign or rethink.\n\nI hoped Google also remembered and applied that experience here, making a skill tailored to toasts to avoid another debacle. Nope.\n\nReopening because this guide needs accessibility guidance in some form as there’s no general toast guidance.\n\nBut this is an early preview\n\nof what developers can do with MWG. It’s not going to cover every pattern. That would be absurd. So let’s look to a pattern Google decided to showcase at launch via this first example prompt on the page:\n\nCreate an accordion-style stats component that smoothly animates on open and close.\n\nI expected a pile of `<details name>`\n\nelements, maybe CSS `block-size`\n\nwith a JavaScript fallback, probably a couple placeholder images for generic stats, possibly a well-formed table to accompany them, and of course all of it passing WCAG. This is what Antigravity produced with MWG:\n\nSee the Pen [\nGoogle Modern Web Accordion](https://codepen.io/aardrian/pen/xbRdrrG) by Adrian Roselli ([@aardrian](https://codepen.io/aardrian))\non [CodePen](https://codepen.io).\n\nAntigravity with MWG went well beyond the prompt, providing a theme switcher, configuration settings, and plenty of calls to Google fonts. But it failed to do what I asked. The animation doesn’t work in Firefox. This despite the promise of baseline / Baseline support and fallbacks:\n\nProgressive Enhancement & Nuanced Fallbacks: We distinguish between purely additive enhancements (like speculative preloading) which are safe to let older browsers silently ignore, and critical behaviors (like dialog controls or network beacons) where we write highly considered, low-overhead fallbacks.- […]\nBaseline-Aware Integration: We leverage real-time compatibility data from theBaselineproject so agents can dynamically adapt to current browser support and any browser support preferences.\n\nThis is already worrisome given we know that three years on, Baseline still doesn’t really address baseline support:\n\nThe relatively new\n\nWeb Platform Baselineoffering does not track browser support for accessibility features built into the web platform. If you need to understand whether browsers support accessibility features as your own base level set of requirements, for legal or other compliance reasons, thenWeb Platform Baselinedoes not represent a baseline.\n\nLet’s ignore the non-DRY code, like duplicated HTML text in the script and stringing out the `transition`\n\ninstead of using `transition-property`\n\n. *Antigravity with MWG didn’t even create a WCAG-conformant example from its own prompt.* I found errors within moments. MWG failed its core promises of creating accessible and performant code. Despite its own explicit guidance.\n\nFor the first two of these MWG already had guidance, and the a11y skill just wasn’t picked up. Overall activation aside, this highlights the importance of including contextual a11y information.\n\n[…] [W]e should try to have one guide for each common interactive element summarizing and linking/embedding relevant bits of guidance (e.g. tabs, accordions, drawers, etc). The more scattered the use case guidance is, the less likely it is that agents will actually pick up all the pieces.\n\nAnd there’s the rub. There’s no way to guarantee you’ll get what you ask for, that you won’t get something else, and that these guides — the entire promise of MWG — will be honored. MWG asks authors to trust MWG when using an LLM to code interfaces. But MWG knows its guidance may be ignored:\n\nLLMs are non-deterministic. Even if we do everything right, there is no guarantee any guideline will be used for any given prompt. Even if the relevant guide is picked up, it may not be read fully. Case in point: As you say, MWG already had guidelines for many of these things!\n\nThe underlying code generation technology can’t be trusted to follow the rules and the rules aren’t robust enough to blunt that reality.\n\nIf your job requires you to burn tokens to satisfy some manager’s dashboard, then yes, grab the MWD skills files and integrate them into your LLM work. You’ll almost definitely get better output than if you do nothing at all. There are smart people working on this and many of the accessibility rules I saw were on-point.\n\nBut that output will be wrong in subtler and more nuanced ways across potentially fatter piles of code with more unrelated output and unwanted dependencies. It will require a more specialized set of skills to identify errors. And those errors will be different every time the code is generated.\n\nSo on the side, keep supporting any existing pattern library. If it’s built well, it’s copy-ready code that you can stuff into a project just as quickly as a chatbot could generate it. It’s deterministic, so you get the same code every time. Ideally it’s been vetted, so you don’t need to look for errors. It’s tailored to your context, meaning you don’t need to yank out random style switchers and typefaces (hoping you got all the dependencies).\n\nIf your job *doesn’t* require you to burn tokens, then probably ignore MWG and, by extensions, LLM for code. In case the environmental damage, intellectual property theft, wealth redistribution to the rich, encoded biases, and built-in support of fascism weren’t enough.", "url": "https://wpnews.pro/news/maybe-don-t-rely-on-google-s-modern-web-guidance", "canonical_source": "https://adrianroselli.com/2026/05/maybe-dont-rely-on-googles-modern-web-guidance.html", "published_at": "2026-05-26 09:12:58+00:00", "updated_at": "2026-05-26 09:38:17.272078+00:00", "lang": "en", "topics": ["ai-ethics", "ai-agents", "ai-tools", "ai-products", "ai-policy"], "entities": ["Google", "Chrome for Developers", "Modern Web Guidance", "WCAG"], "alternates": {"html": "https://wpnews.pro/news/maybe-don-t-rely-on-google-s-modern-web-guidance", "markdown": "https://wpnews.pro/news/maybe-don-t-rely-on-google-s-modern-web-guidance.md", "text": "https://wpnews.pro/news/maybe-don-t-rely-on-google-s-modern-web-guidance.txt", "jsonld": "https://wpnews.pro/news/maybe-don-t-rely-on-google-s-modern-web-guidance.jsonld"}}