| Trigger | Marked itself MANDATORY to run first for every HTML, CSS and client-side JS task, with a long keyword list. | Lists the phrases users actually say plus a When NOT to use section (typo and copy edits, renames, backend, build config, native apps), and applies only to the browser-side part of mixed tasks. |
| Offline core | Gave no guidance without running the npx CLI, so it did nothing offline or in sandboxes without network. | Adds references/offline-core.md, a paraphrased checklist from the upstream guides (HTML, overlays, CSS architecture, layout, forms, accessibility, dark mode, motion, performance, sanitizer, framework adaptation); the CLI becomes an optional deeper lookup. |
| Privacy and telemetry | Ran npx without mentioning that the CLI sends usage telemetry to Google by default. | Asks before the first network or npx call, discloses what is collected (query text, guide ids, agent name, OS), and recommends DISABLE_TELEMETRY=1 on every command. |
| Version pinning | Always ran modern-web-guidance@latest, so behavior could change between runs. | Gets the published version with npm view, has the user approve it, and pins that exact version for the session. |
| Output format | Required a self-promoting '### Modern Web Guidance' section, with verbatim quotes, at the end of every answer that used it. | Drops the required section. A guide id is cited only when that guide was actually read and used, and nothing is said when it did not apply. |
| Verification | Asked the agent to cross-check code against the retrieved guide, with no runtime checks. | Adds a checklist with pass conditions: Baseline status lookup, feature detection and fallbacks, keyboard pass, console errors, reduced motion, dark mode and performance audit, and lists any checks that could not be run. |
| Boundaries | Told the agent to request network approval proactively and gave no other stop points. | Adds stop points before npx use, before adding dependencies or polyfills, before large legacy-scan edits, and before writing a browser-support policy into AGENTS.md or CLAUDE.md. |
| Example and install | Showed query examples but no complete task, and gave only CLI-based install instructions. | Adds a full worked example (light-dismiss confirmation dialog with fallback, plus how to check it), a guide-id index, and copy-folder install paths for Antigravity, Claude Code and Codex. |