メインコンテンツへスキップ
見出し画像

AIが書く「動くけど古いWebコード」を根絶する——Chrome・Edge・Firefox・MDN連合の『Modern Web Guidance』が凄まじい

    ブラウザの現代教科書だー。


    Claude CodeやCodex、CursorなどのAIコーディングエージェントにWebフロントエンドを書かせたとき、もどかしさを感じません?

    「動くことは動くけれど、いまだに古いJavaScriptや大量の `<div>` と自前JSでモーダルやツールチップを作ってしまう。今のブラウザならネイティブのCSSやHTMLだけで数行で書けるのに……」

    LLMの学習データには過去の膨大なレガシーコードが含まれているため、何もしないとエージェントはどうしても「ひと昔前のベストプラクティス」を出力しちゃう。

    いや、資料渡せば良いんですけども。めんどい

    この構造的なギャップを埋めるために、Google Chromeが主導し、Microsoft Edge・Mozilla Firefox・MDNのチームが共同で管理している公式プロジェクトが 『Modern Web Guidance』(`GoogleChrome/modern-web-guidance-src`) 。

    4,820 Starsを集めるこのリポジトリ。

    中を覗いてみると、単なるドキュメント集ではなく、「オフラインRAG検索 × Playwright自動評価 × ASTレガシースキャナ」を備えた極めて科学的な知見注入システムになっていましたー。


    1. 全体像と規模:4大ブラウザ陣営が本気で作る「252本のガイド」

    まずはプロジェクトの基本スペックを見てみましょう(2026年11月13日時点の最新データ)。

    • リポジトリ:`GoogleChrome/modern-web-guidance-src`(配布側:`GoogleChrome/modern-web-guidance`)

    • 規模:4,820 Stars / 269 Forks / ライセンスはコードが Apache-2.0、ガイド本文が CC-BY 4.0

    • 収録規模:252本のガイド(17カテゴリ / 計 35,824行・約 1.88 MB)

      • 具体的なユースケースガイド:226本

      • 概念ハブとなるディシプリンガイド:26本

      • カバーするWebプラットフォーム機能(`web-features` ID):ユニーク 305機能

    • メンテナンス体制:Paul Irish氏をはじめとするChrome/ブラウザ関係者が日々コミットを重ね、直近ではレガシースキャンの4.5倍高速化や `.scss` / Litテンプレートリテラル対応などが進んでいます。


    2. なぜ「プロンプトに貼る」より優れているのか?(3つの仕組み)

    252本(約1.9 MB)ものドキュメントをそのままコンテキストに放り込むことはできません。Modern Web Guidance は、エージェントが必要な知識だけを最小限のトークンで取り出せるよう、以下の仕組みを備えています。

    ① 初期わずか約205トークン & 完全オフライン意味検索

    導入されるスキルパック(`modern-web-guidance` は約205トークン、`chrome-extensions` は約175トークン)は極めて軽量。

    エージェントはタスクに応じてローカルCLI経由で `search`(検索)→ `retrieve`(取得) を呼び出します。

    検索エンジンには量子化済み埋め込みキャッシュとBM25を組み合わせたローカル意味検索を採用しているため、ネットワーク通信も外部APIキーも不要で高速に動作します。

    ② Baseline連携による「未成熟APIのゲート制御」

    「最新だからといって、まだ一部ブラウザでしか動かない実験的機能を勝手に使われたら困る」という実務上の懸念にも対応しています。

    `@mdn/browser-compat-data` などのBaselineデータと連携しており、Origin Trial機能や単一エンジンの不安定(volatile)な機能を含むガイドは、既定では `retrieve` がブロックされます。

    使いたい場合だけプロジェクトの `.mwgrc`(`allowOriginTrials` / `allowVolatileFeatures`)で明示的に解放する設計。

    ③ 既存プロジェクトの時代遅れを検知する `legacy-scan`

    このリポジトリにはTypeScriptのAST(抽象構文木)などを使った静的スキャナ(`src/analyzing/`)が組み込まれており、手元のプロジェクトに対して `legacy-scan` を走らせると、古い書き方(`innerHTML` の多用や古い日時処理、CSSの古いハックなど)を検出して、該当するモダンなガイドをピンポイントで提示してくれます。


    3. 252本のガイドが映し出す「2026年のモダンWeb標準」

    17カテゴリ(最多は `ui-behaviors` 45本、`performance` 29本、`ui-components` 28本、`forms` 27本、`visual-design` 27本、`css` 20本、`security` 17本…)のガイドから、特に参照回数が多いWeb機能ID(`web-features`)を集計すると、現在のWebフロントエンドで何が重視されているかが一目瞭然になります。

    • UI・レイアウトの最新潮流

      • `popover`(22ガイド参照) / `anchor-positioning`(14) / `dialog`(7)

      • `scroll-driven-animations`(13) / `scroll-snap`(11) / `container-queries`(12) / `masks`(12)

      • `view-transitions`(11) / `:has()`(9) / `invoker-commands`(9:JSなしでボタンからモーダル等を制御) / `customizable-select`(7)

    • JS・セキュリティ・新領域

      • `Temporal`(5:タイムゾーンやカレンダーを正しく扱う次世代日時API)

      • `webauthn`(7:Passkey認証・登録・管理)

      • Built-in AI(4ガイド):ブラウザ内蔵の `Prompt API` / `Summarizer` / `Translator` / `LanguageDetector`

      • WebMCP(3ガイド):HTMLフォームやJS関数をブラウザ上からAIエージェントのツールとして公開する新仕様

    これらが単なるAPIリファレンスではなく、「IME変換中のEnter誤送信を防ぐフォーム」「スクロール端で軸が反転するドロップダウン」「モーダル背後のスクロール防止」といった具体的なUIの悩み単位で書かれている点が非常に実用的です。


    4. 「役に立たない助言は削る」Playwrightによる科学的ベンチマーク

    このプロジェクトが本当に凄まじいのは「ガイドの品質をPlaywrightグレーダーで毎回自動測定している」点。

    全252本のうち 209本が「Stage 3(評価完了)」 に到達しています。評価手順は極めてシビア。

    1. `daily-grind`(汎用タスクアプリ)と `devtools-times`(Astro製のメディアアプリ)という2つの実在ベースアプリを用意。

    2. ガイドの想定解(Golden patch)が 100% pass し、無改造のベースアプリが 0% pass になるようテスト(`grader.ts`)を較正。

    3. プロンプトに「使うべきAPI名」を一切書かずに、実際のAIエージェントに実装させる。

    4. ガイドなしの「Unguided」と、本スキルありの「Guided」でパス率を比較。すでにモデルが自力で解ける領域の助言は刈り込み、苦手な領域を厚くするという改善を回しています。

    驚異のUplift(パス率向上)実績(2026年11月8日時点)

    • `antigravity_cli`(gemini-4-argon)[214タスク / 1,673アサーション]
      Unguided 58% → Guided 94%(+36ポイント改善 ※11/6回では60%→96%)

    • `claude_code`(opus-5-5)[215タスク / 1,801アサーション]
      Unguided 57% → Guided 88%(+31ポイント改善 ※11/6回では56%→90%)

    • `codex_cli`(gpt-6.1-sol)[215タスク / 1,795アサーション]
      Unguided 54% → Guided 82%(+28ポイント改善 ※11/6回では53%→86%)

    どの最新フロンティアモデルを使っても、ガイドを併用するだけでテスト合格率が約30ポイント近く跳ね上がることが実証されています。


    5. 今すぐ試せるCLIと導入方法

    自分の開発環境やエージェントに導入するのはとても簡単。まずは導入せずに検索やスキャンだけを試すこともできます。

    # 対話ウィザードで主要エージェントへ導入
    npx modern-web-guidance@latest install
    
    # インストール不要で検索・取得を試す
    npx modern-web-guidance@latest search "animate a dialog modal backdrop"
    npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"
    
    # 手元のプロジェクトのレガシーな書き方をスキャンする
    npx modern-web-guidance@latest legacy-scan .

    各エージェント向けの直接インストール経路も幅広く用意されています。

    • Vercel Skills:`npx skills add GoogleChrome/modern-web-guidance`

    • GitHub CLI:`gh skill install GoogleChrome/modern-web-guidance`

    • Claude Code / Copilot / Codex / Cursor / Antigravity / Grok / Kimi:各プラグインマーケットプレイスやCLIコマンドから導入可能

    (※匿名利用統計のテレメトリは `DISABLE_TELEMETRY=1` でオプトアウトできます)


    おわりに

    `Modern Web Guidance` はAIがより良いコードを書けるように、ブラウザベンダーとMDN自らが標準化したAIのための現代Web教科書。

    AIにフロントエンド開発を任せている人はもちろん、

    「自分のプロジェクトで時代遅れの実装が残っていないか点検したい」
    「そもそも2026年時点でどのWeb標準APIが実戦投入できるのか知りたい」

    という人間にとっても、252本のユースケース一覧と `legacy-scan` はこれ以上ない羅針盤になりそうな感じ。

    まずは手元のフロントエンドリポジトリで `npx modern-web-guidance@latest legacy-scan .` を実行してみてはいかがでしょうかー。

    レガシースキャンって技名っぽい。

    関連リンク

    あなたへのおすすめ