Modern Web Guidance 1.0公開、AIが書く古いWebコードを直す
Chromeチームが2026年11月10日、AIコーディングエージェント向けスキル集「Modern Web Guidance」1.0を公開。モダナイズ機能と導入手順、扱う領域をまとめます。
Chromeチームは2026年11月10日、AIコーディングエージェント向けのスキル集「Modern Web Guidance」のバージョン1.0を公開しました。エージェントが書くHTML・CSS・JavaScriptに、最新のWebプラットフォームの知識とブラウザ互換性のデータを持ち込む仕組みです。1.0では既存コードを調べて現代的な書き方へ直す「モダナイズ」のワークフローが加わり、FirefoxとEdgeも参加するクロスブラウザの取り組みになりました。日本語では窓の杜が11月17日に取り上げています。
この記事の目次
1.0で何が増えたか
Chromeのブログ記事(執筆はPhilip Walton氏)によると、Modern Web Guidanceは2026年5月のGoogle I/Oで先行公開されたものです。コーディングエージェントは動くコードを書けても、Webの専門家が見ると、もっと速く、アクセシブルに、安全にできる箇所が残る、という問題意識から作られています。1.0で安定版とされた変更点は、公式の記事では次の4つに整理されています。
- モダナイズのワークフロー:既存のコードベース(HTML、CSS、JavaScript、package.json)を走査し、安全に置き換えられる箇所を見つけて、エージェントが変更を進めるのを支援します。最初のリリースは静的解析で、確認できるパターンは限られています。今後は、エージェント自身がコードを読んで判断する「エージェント型の監査」を計画していると書かれています。
- ガイドのデータベースの拡充:AIが苦手とする、検証済みでブラウザ間の互換性も確かめた解決策を、数百件の単位で収録しています。
- 専門家レビューの深掘り:すべてのガイドを人がレビューし、領域ごとのテックリードが承認します。ユーザーに見える部分のガイドは、支援技術を使ったアクセシビリティの専門家によるテストも受けます。
- 評価の全件実施:すべてのガイドを評価し、ガイドありとなしのエージェントを比べた結果を、公開ダッシュボード(goo.gle/mwg-evals)に載せています。
あわせて、FirefoxとEdgeがChromeに加わり、互換性の面でプロジェクトを支える・改善する・貢献する立場になったと説明されています。推奨する実装は、Baselineとブラウザサポートのデータをもとにプロジェクトごとに調整されます。
導入は npx 1コマンド、更新は update
導入は、プロジェクトのディレクトリで次のコマンドを実行します。
npx modern-web-guidance@latest install
以前のバージョンから1.0へ上げるときは、同じ形式のupdateコマンドです。
npx modern-web-guidance@latest update
モダナイズの呼び出し例として、公式の記事には/modern-web-guidance Modernize the code in this directoryが載っています。npxを使わなくても、Claude Code、Codex、Cursor、Antigravity、Copilot、WebStorm、Kimi Code、Grok Buildのプラグインマーケットプレイスから導入・更新できます。ドキュメントはdeveloper.chrome.com/docs/modern-web-guidanceにあり、GitHubのリポジトリとコントリビューションのガイドも案内されています。
どの領域の「AIの苦手」をカバーするのか
公式の記事は、最先端のモデルでもまだ弱い領域として、次を挙げています。
| 領域 | 例 |
|---|---|
| アクセシビリティ | キーボードフォーカスとinertの管理、reduced-motionへの対応、アクセシブルなフォーム検証、ARIAの誤用 |
| ユーザー体験 | スワイプやタッチ操作、ダイアログ・ポップオーバーの遷移、ライト/ダークテーマの実装 |
| パフォーマンス | メインスレッドのタスクスケジューリング、画面外描画の分離、レイアウトシフトの防止 |
| セキュリティ | HTMLのサニタイズ、厳格なContent Security Policy、パスキーの資格情報管理 |
方針としては、独自のJavaScriptで作り込む前に、popoverやdialogのアニメーション、スクロールやスワイプの機能、ビュートランジションといったネイティブのHTML・CSSの機能を優先する姿勢が示されています。決済フローではパスキー(WebAuthn)とオートフィルを勧めています。
DevTools for agentsと組み合わせて検証する
Chromeチームは、Modern Web Guidanceを「実装前に専門知識を渡す側」、Chrome DevTools for agentsを「実行時の検証とデバッグの側」と位置づけ、併用を勧めています。記事に挙がっている使い方は3つです。ひとつは、CPUを遅くしたシミュレーションでトレースを取り、メインスレッドを50ミリ秒を超えて塞ぐタスクがなくなるまで繰り返す方法で、INPを低く保つのに役立つとされています。ふたつめは、モーダルやツールチップ、ポップオーバーのアニメーションを記録して確認し、prefers-reduced-motionが守られているかを検証すること。みっつめは、SPAのビューキャッシュがメモリリークを起こしていないかをメモリツールで確かめることです。
導入事例の数字は「各社の報告」として読む
記事には、導入した企業の数字も載っています。いずれも各社の報告として紹介されているもので、条件が違うため横並びで比べるのは向きません。
- Policybazaar:トラフィックの多い約30のランディングページでパフォーマンス監査を自動化し、手作業の監査を92%減らしたとされています。
- WeTV(Tencent):CI/CDパイプライン内のエージェントが、失敗したパフォーマンスチェックの90%を解消。デバッグと解決の時間は、手動評価を含めて4時間から30分に、87%短縮したそうです。
- note:本番コードベースでの180回の評価で、モダンWebのチェックの合格率が61%から94%に上がったと記載されています。431件のマージ済みプルリクエストで、LCP画像の優先付けが28%改善したとも書かれています。
- MetaMask:プルリクエストごとの自動レビューボットとして運用し、最初の5週間で約480件をレビュー、64件にコメント、43件の指摘をエンジニアが修正しました。コメントから修正までの中央値は15分です。
どれも「導入したら必ずこうなる」という数字ではありません。自社のコードベースの状態や、エージェントの使い方で結果は変わります。
試すなら、まず小さなディレクトリで
制作の現場で試すなら、いきなり本番のリポジトリ全体に走らせるより、小さなサイトや検証用のブランチで、モダナイズが何を提案するかを見るのが安全だと思います。1.0のモダナイズは静的解析で、検出できるパターンが限られるので、「見つかった分だけ直す」ツールと割り切ると期待値が合います。差分は通常のコードレビューと同じく人が確認し、アクセシビリティや表示崩れはブラウザで実際に確かめる前提で使うのがよさそうです。
一方で、AIが古い書き方を出しやすい、という課題そのものは、今後も続きます。ガイドの評価結果が公開ダッシュボードで見られる点は、導入前の判断材料になります。自分が使っているエージェントで差が出るのか、一度ダッシュボードを見ておくとよいでしょう。
出典
- Chrome for Developers「Modern Web Guidance 1.0」(2026年11月10日)
- 窓の杜「AIが時代遅れのWebサイトを書くのを防ぐスキル『Modern Web Guidance』が安定版に」(2026年11月17日)
2026年11月19日時点の情報です。
本記事は情報提供を目的としています。ブラウザの仕様やライブラリのバージョンによって動作が異なる場合があるため、実際の開発では公式ドキュメントも合わせてご確認ください。
