概要
Modern Web Guidance は、Web プラットフォームのベストプラクティスとブラウザ互換性データを、コーディングエージェントに Agent Skills(必要に応じて読み込む手順書・知識のパッケージ)として渡す Google Chrome チームのオープンソースプロジェクト(GoogleChrome/modern-web-guidance)。2026 年 5 月の Google I/O でアーリープレビュー、11 月 10 日に 1.0 になった。Firefox と Edge のチームも協力している。
詳細
なぜ AI のフロントエンドは古くなるのか
- 新しい機能を知らない:学習データにはネイティブ機能が登場する前の「JavaScript で頑張る」コードが多い
- 知っていても使い方やサポート状況を誤る:構文が古い、どのブラウザで使えるかの前提が違う
同じプロンプトでガイダンスの有無だけ変えた比較(LogRocket)では、次のような差が出た。
| 機能 | ガイダンスなし | ガイダンスあり |
|---|---|---|
| モーダル | JS の状態とタイムアウトで開閉 | ネイティブ <dialog> + CSS トランジション |
| カードの出し分け | メディアクエリ | コンテナクエリ |
| 2,000 件の検索 | useMemo で同期フィルタ | scheduler.yield() で分割処理 |
| ツールチップ | Floating UI ライブラリ | CSS Anchor Positioning |
仕組み
- Baseline に基づく:互換性の判断に Baseline を使い、既定は「Baseline Widely available」。必要ならフォールバックやプログレッシブエンハンスメントを付ける
- 検索して必要なガイドだけ読む:スキルがエージェントに CLI を呼ばせ、タスク内容でガイドを検索(
search)し、該当する Markdown を取り出す(retrieve)。全ガイドを常にコンテキストに載せない - カテゴリ:accessibility、css、forms、performance、security、ui-components、built-in-ai、webmcp など
- 1.0 の追加:HTML・CSS・JS・
package.jsonを静的解析して安全に上げられる箇所を探すモダナイズのワークフロー(対応パターンは限定的)と、支援技術を使ったアクセシビリティのレビュー
導入と設定
- 推奨:
npx modern-web-guidance@latest install(対話式ウィザード、自動更新あり)。プレビュー版からはupdate - Claude Code のプラグインとして:
claude plugin marketplace add GoogleChrome/modern-web-guidance→claude plugin install modern-web-guidance@googlechrome - Codex・Copilot CLI・Gemini CLI などにも手順があり、
npx skills addやgh skill installでも入る - Baseline ターゲットは
CLAUDE.mdやAGENTS.mdに一文(This project's Baseline target is Baseline 2024.)書くだけで指定できる。ターゲットで「そのまま使うか、フォールバックを付けるか」が変わる - 単一エンジンだけの実験的機能や Origin Trial は既定では取り出せない。
set-allow-volatile-features/set-allow-origin-trialsで必要なものだけオプトインする
効果と限界
公式の評価ダッシュボードは、完成したアプリを Playwright で実ブラウザで開き、要件ごとのチェックの合格率で測る。導入事例では note が 180 回の評価で合格率 61% → 94% と報告されている。一方で、出回っている「56% → 88%」という数字は公式ブログでは確認できない。
ガイダンスは出発点を良くするもので、コードレビューや実ブラウザでのテスト、アクセシビリティの確認(<dialog> のフォーカスの戻り・キーボード操作・読み上げ)の代わりにはならない。実行時の検証には Chrome DevTools for agents(低スペック CPU での INP 計測、メモリリーク調査)を組み合わせることが勧められている。
関連ページ
- Claude Code — プラグインとして導入できるエージェント
- Astro — このブログのフロントエンドと、表示性能の切り分け事例
- AI エージェント