Modern Web Guidance

AI
AIツール

AIエージェント(Claude CodeやCodexなど)にWebフロントエンドのコードを生成させると、学習データに含まれる膨大な過去のコード資産の影響で、不要なJavaScriptを用いたレガシーな実装(例: ドロップダウンやドロワーの制御に数百行のJSを使用するなど)が出力されやすいという課題がある。

Modern Web Guidance  |  Chrome for Developers
ウェブ プラットフォームの専門知識とベスト プラクティスをコーディング エージェントに直接組み込むスキル。

この課題を解決するため、GoogleのChromeチームを中心に、Edge、Firefox、MDNの各チームが共同で策定・公開したAI向けスキル集が「Modern Web Guidance」(早期プレビューを経て1.0安定版がリリース)である。最新のブラウザ標準機能や代替処理(フォールバック)を構造化したガイド群をエージェントにインプットすることで、生成コードの品質向上とJS削減によるパフォーマンス改善を実現する。

GitHub – GoogleChrome/modern-web-guidance-src: Keep your coding agent up to date with the latest web best practices
Keep your coding agent up to date with the latest web best practices – GoogleChrome/modern-web-guidance-src

しかし、実務導入にあたっては、デフォルトで有効化されているテレメトリ(検索クエリや利用情報のGoogle送信)の仕様や、代替処理の品質に関するアクセシビリティ専門家からの指摘など、技術・セキュリティ両面での論点を正確に把握しておく必要がある。

事象の背景と構造

AIがレガシーなコードを生成する背景

AIは学習ソースに古いコードを大量に含んでいるため、CSSのみで実装可能な表現であっても、古いJavaScriptを用いた冗長な実装を出力しがちである。

  • 具体例(ドロワーメニュー):
  • ガイドなし: 指やマウスの動きを検知・制御するために数百行のJavaScriptを生成。モバイル端末等で動作がもたつく原因となる。
  • ガイドあり: スワイプで閉じる挙動をCSSの`scroll-snap`で制御し、背景の暗転をスクロール連動CSSアニメーションで実装。JSを大幅に削減し、ネイティブに近い滑らかな動作を実現する。

Modern Web Guidance 1.0 のカバー範囲

本ツールは、ブラウザ上で動作する標準技術(HTML、CSS、DOM操作を伴うJavaScript)に特化している。React等のフレームワーク内で記述されるHTML/CSS/DOMも対象となる。

対象となる領域対象外となる領域
フォーム、ダイアログ、パフォーマンス、セキュリティ、アクセシビリティなど(17分類・200以上のガイド)データベース、APIルートなどのサーバーサイドコード
ブラウザ標準機能を用いた実装、未対応ブラウザ向けの代替処理CI/CD設定、Docker設定、ビルドツール(Vite等)やLinter(ESLint等)の設定
[WordPress]表を横スクロールさせる方法
WordPressで作成した表を横スクロールさせる方法を解説。カスタムCSS(overflow-x: auto)の追加、HTML直接編集、プラグインの活用という3つのアプローチから、スマホ表示にも最適なテーブルの実装手順を紹介します。

コアとなる技術的仕組みの解説

1. エージェントのコンテキスト消費を抑える検索アーキテクチャ

200以上のガイドをすべてAIのコンテキストに投入すると、トークン消費が激増する。そのため、Modern Web Guidanceは二段階の読み込みアプローチを採用している。

  1. 初期フェーズ: エージェントは「スキルの説明」と「検索手順」のみをシステムプロンプト等として読み込む。
  2. 検索・取得フェーズ: 開発タスク(例: 「横から出てくるドロワーを作って」)が発生すると、エージェントは自律的に検索クエリ(例: `navigation drawer`)を生成し、ローカルパッケージ内で検索を実行。合致したガイドの本文のみをピンポイントで取得(Retrieve)してコード生成に反映する。
    • *技術的特徴*: 検索処理は手元のローカル環境(CPU)で完結するため、検索のたびに外部のAPIサーバーへ問い合わせる必要がない。

2. 標準機能を活用した実装パターン

ガイドには、最新のCSS/JS仕様を用いた具体的な実装コードが定義されている。

  • 入力エラーのスタイリング(JS不要の親要素制御):
    • 従来はJavaScriptで入力状態を監視し、親要素にクラスを付与していた。
    • ガイドでは、CSSの `:has()` セレクタと `:user-invalid`(ユーザー入力後にバリデーションエラーとなった要素を選択)を組み合わせ、CSSのみで親要素の枠線やラベルの色を変更する。
  • 新しい日時操作(Temporal API):
    • 従来の `Date` オブジェクトによるミリ秒単位の手動計算を廃止し、タイムゾーンや夏時間を考慮した正確な日付計算が可能な `Temporal` を用いた記述を推奨。
  • アクセシビリティ(セマンティックHTML):
    • `div` 要素に `role=”button”` を付与してJSで挙動を模倣するアンチパターンを避け、標準の `button` 要素を使用させる(キーボード操作やスクリーンリーダー対応をデフォルトで担保)。
  • ダイアログ/ポップオーバーのアニメーション:
    • 非表示から表示(およびその逆)への遷移を、CSSの `@starting-style`、`transition-behavior: allow-discrete`、および `overlay` プロパティを組み合わせて制御する。
    • *詳細な指示*: `transition-behavior` は、transitionの短縮記法より前に記述すると上書きされてしまうため、必ず「分けて後ろに記述する」といった、パーサーの挙動に踏み込んだ指示までガイドに含まれている。

3. Baseline基準に基づく互換性制御

モダン機能の採用基準として、主要ブラウザの対応状況を示す共通指標「Baseline」を活用している。

  • デフォルトの挙動: 主要ブラウザ(Chrome, Edge, Firefox, Safari)すべてに対応してから「30か月以上」経過した機能(Widely Available)を、代替処理なしでそのまま使用する。
  • 新しい機能の採用: 30か月未満の新しい機能を使用する場合、エージェントはガイドに記載されている「代替処理(フォールバック用JSなど)」をセットで実装する。
  • 試験的機能の制限: 1つのブラウザエンジンにしか実装されていないような未安定の機能は、プロジェクト側で明示的に許可しない限り、エージェントが検索結果から本文を取得できないように制御されている。
ベクトルDB比較
FAISS、Pinecone、Weaviateという代表的なベクトル開発ソリューションを徹底比較。プロトタイプ開発から商用RAG、複雑なメタデータ検索まで、各技術のメリット・デメリットと最適な技術選定ガイドラインを解説します。

周辺エコシステム・類似ツールとの比較

AIにWeb標準コードを書かせる、または検証するアプローチにおいて、Modern Web Guidanceと他のツールには以下のような設計思想の違いがある。

ツール名データの性質・ソース提供する価値動作タイミング
Modern Web Guidance専門家が執筆・審査したブラウザ標準機能のガイドと代替処理コード。最新の標準機能を用いた実装手順とフォールバックの提供。コード生成前(エージェントにインプット)
Context7 (Upstash)誰でも登録可能な各種ライブラリ/フレームワークのドキュメント。バージョンごとのAPIドキュメントやコード例の提供。コード生成前(エージェントにインプット)
MDN MCP serverMDN公式のドキュメント本文およびブラウザ互換性データ。ドキュメントと互換性データの直接参照(代替処理の設計はAI自身が行う)。コード生成前(エージェントにインプット)
use-baseline (ESLint/Stylelint)Baselineの互換性データベース。指定したBaseline基準を満たさないCSS記述の検知(静的解析)。コード生成後(Linterによる検証)

導入手順と実務上のセキュリティ論点

1. インストールとセットアップ

Node.js バージョン22以上が必要となる。

# 推奨される対話型インストール
npx modern-web-guidance@latest install

※Claude CodeやCodexのプラグインとしてマーケットプレイス経由で導入することも可能だが、一部の配布環境において古いバージョンで固定され更新警告が消えない事象が報告されているため、`npx` 経由での管理が確実である。

2. テレメトリ(利用情報送信)に関するセキュリティリスク

Modern Web Guidanceは、既定(デフォルト)で検索やガイド取得のたびに以下の情報をGoogleの収集APIに送信する仕様となっている。

  • 送信される主なデータ:
    • エージェントが生成した検索クエリ(文字列のまま加工・切り詰めなしで送信)
    • 操作されたガイドのID、コマンド種別、エージェント名、OS、CLI/スキルのバージョン、処理時間
  • 技術的懸念点:
    • エージェントがユーザーのプロンプト(依頼文)をそのまま検索クエリに流用した場合、未公開の製品名や機密情報がそのままGoogleのサーバーに送信されるリスクがある。
    • 同じGoogle製のツールである `Chrome DevTools for agents` では、文字列を長さの区分(バケット)に変換して送信し、CI環境下では自動停止する仕組みがあるが、Modern Web Guidance 1.0 は文字列をそのまま送信する。
    • このテレメトリ送信に関する説明は、公式サイトのドキュメントや1.0発表記事には明記されておらず、CLIの `install` 実行時にのみ告知が表示される(プラグイン経由で導入した場合は告知すら表示されない)。

対策:テレメトリのオプトアウト

機密情報を扱う商用開発や、不要な外部通信を遮断したい環境では、インストールおよび実行前に以下の環境変数をシェルの設定ファイル(`.bashrc` や `.zshrc`)に記述し、明示的に送信を停止する必要がある。

export DISABLE_TELEMETRY=1

※本ツールは、一般的なツールが対応している `DO_NOT_TRACK` や CI環境変数による自動停止を検知しないため、必ず `DISABLE_TELEMETRY=1` を指定する必要がある。この設定により、内部で動作するVercel CLIのテレメトリ送信も同時に停止させることができる。

今後の影響と論点

  1. エージェントの自律的な検証サイクル(Chrome DevTools for agents との連携)
    Chromeチームは、本ツールと `Chrome DevTools for agents` を組み合わせたマルチエージェントワークフローを推奨している。コード生成後にエージェントが自律的にChromeをヘッドレス操作し、レンダリング結果の確認、パフォーマンス計測、スクリーンショットによる描画崩れの検知までを行うサイクルが確立されつつある。
  2. 代替処理(フォールバック)の品質担保とアクセシビリティの限界
    ガイドが提供する代替処理の品質については、アクセシビリティの専門家から懸念も示されている。例えば、一部のコンポーネントにおいて「未対応ブラウザでは単なるチェックボックスに退化させる」といったフォールバックが、アクセシビリティ基準(WCAG)を満たさないケースや、特定ブラウザでアニメーションが動作しないケースが報告されている。AIが生成したコードは、最終的に人間のエンジニアが実機およびアクセシビリティツールの目で検証する必要がある。
Q よくある質問 (FAQ)
Q. Modern Web Guidanceを導入すれば、古いブラウザへの対応コードをAIが自動的に書いてくれますか?
A.
はい、ガイド内に未対応ブラウザ向けの代替処理(フォールバック)が定義されているため、プロジェクトが要求するBaseline基準に応じて、AIが自動的に代替コードを組み込んで生成します。ただし、その代替処理が要件を満たしているかは開発者自身による検証が必要です。
Q. テレメトリの送信を止めるために `DO_NOT_TRACK=1` を設定していますが、これだけで十分ですか?
A.
不十分です。Modern Web Guidanceは `DO_NOT_TRACK` や一般的なCI環境変数を検知して送信を止める仕様になっていません。必ず `DISABLE_TELEMETRY=1` を環境変数に設定してください。
Q. legacy-scan` コマンドを実行すれば、既存コードベース内の古い書き方をすべて最新化できますか?
A.
いいえ。1.0時点において、`legacy-scan` がルールベースで検出できるのはガイド全体の約2割の領域に限定されています。検出されなかったからといって、すべてのコードが最新標準に準拠しているとは限らない点に留意してください。

コメント

タイトルとURLをコピーしました