Key takeaways
- Stop your coding agent writing dated web code: curated guidance is fed into its context as it works.
- Less bloat: the project says native platform features often replace JavaScript agents still generate by habit.
- Broad coverage: the README lists 250 web features and 203 real-world use cases, from CSS to passkeys.
- Backed by the Chrome, Edge, Firefox and MDN teams, with the code open to read.
- The catches: this is the source repository, results are the project's own, and we did not run it.
What it is
Modern Web Guidance is a set of skills that embed web platform expertise, best practices and browser compatibility data directly into coding agents, according to its README. This repository, released under the Apache licence, is the source for authoring, calibrating and evaluating that content, and it sits on GitHub at GoogleChrome/modern-web-guidance-src.
The problem it solves
Anyone who lets an agent write front-end code has seen it reach for old habits. The project's explanation is that training data contains vast amounts of legacy code, so agents often default to older patterns.
The README says this often produces bloated JavaScript for tasks that now have native platform solutions. Web developers, and the people who maintain what agents write, feel it first.
What you get
- Fresher output: the skill steers agents away from legacy patterns and towards the modern web platform.
- Targeted help: a command-line tool returns curated guidelines directly into the agent's context window.
- Lighter pages: guidance prefers platform APIs that the browser can optimise, with built-in accessibility affordances, and lightweight fallbacks over heavy polyfills.
- Wide coverage: the README lists 250 web features and 203 real-world use cases.
- Trusted stewards: the Chrome, Edge, Firefox and MDN teams, alongside the web community, steward the project.
The catches
- Source, not product: this repository is where the guidance is authored and evaluated, so the published project lives elsewhere.
- Self-reported: the claims about quality and token efficiency are the project's own, based on its own evals.
- Moving target: coverage runs up to the cutting edge, and newer features may not work in every browser, so check compatibility before shipping.
- Setup: it installs through an interactive command-line wizard, so it suits people already comfortable with that.
What we did not test
We did not install the tool, run it with an agent or compare the code it produces with and without the guidance. Every claim here comes from a literal quote in the project's README or the GitHub API, and the benefits described are the project's own. We also did not check the browser support of any feature it lists.
Verdict
Editors' view: this is aimed at developers who already hand front-end work to a coding agent and are tired of dated patterns in the output. If you rarely use agents for web code, there is little here for you. If you try it, compare the agent's code with and without it on one small task before trusting it.
Sources
Need help adopting this, or have a software project in mind?
Tell us what you are building. The initial consultation is free. Email [email protected] or follow @zolnaltd.
Start a conversation →