skip to content
日替わり OSS
Table of Contents

リポジトリ

Modern Web Guidance とは

Modern Web Guidance は、Google Chrome、Microsoft Edge、Mozilla Firefox、MDNといった主要なブラウザ開発チームが共同で推進するオープンソースプロジェクトです。その目的は、大規模言語モデル (LLM) を利用したコーディングエージェントが、現代のウェブプラットフォームのベストプラクティスと最新技術を理解し、活用するための専門知識とガイドラインを提供することにあります。

LLMは膨大な既存コードを学習するため、時にレガシーなパターンを生成しがちです。Modern Web Guidance は、この課題に対し、ウェブプラットフォームの進化に合わせて更新される、専門家が厳選したガイドライン集を提供することで、コーディングエージェントの出力品質を向上させ、最新かつ効率的なウェブ開発を支援します。

なぜ今、現代的なウェブガイダンスが必要なのか

近年のウェブ開発では、多くのタスクがネイティブAPIやCSS機能で、より高速かつ効率的に実現できるようになりました。しかし、LLMを用いたコーディングエージェントは、学習データの特性上、依然として古いJavaScriptライブラリや非効率な手法を推奨してしまうことがあります。

たとえば、かつてはJavaScriptで複雑な処理が必要だったアニメーションやUIコンポーネントも、今ではCSSや新しいHTML要素、Web APIで簡潔に実装できるケースが増えています。LLMがこれらの新しいAPIの存在を知っていても、プロダクションレベルで利用可能な現代的な実装パターンに関する深い知識は不足しがちです。これにより、冗長でパフォーマンスの低いコードが生成されたり、アクセシビリティが考慮されないUIが提案されたりするリスクがありました。

Modern Web Guidance は、このような課題に対し、信頼できる解決策を提供します。このガイドラインは、コーディングエージェントが最新のブラウザAPIを適切に構造化し、パフォーマンスとアクセシビリティに優れたプラットフォームレベルのソリューションを優先し、必要に応じて軽量で適切なフォールバック手法を適用できるよう導きます。これにより、開発者はエージェントが生成するコードの品質を信頼し、より生産的に開発を進めることができるようになります。

Modern Web Guidance が提供する主な価値

Modern Web Guidance は、コーディングエージェントに対し、以下のような現代のウェブ開発に必要な要素を支援します。

  • 最新ブラウザAPIの活用: 効率的かつネイティブな機能を優先し、レガシーなJavaScriptライブラリへの依存を減らします。
  • パフォーマンスとアクセシビリティの向上: ブラウザ最適化されたAPIや組み込みのアクセシビリティ機能を活用することで、高品質なユーザー体験を提供します。
  • 責任あるフォールバック: 重いポリフィルではなく、軽量で適切なフォールバック手法を推奨し、広範なブラウザサポートと低オーバーヘッドを両立させます。
  • トークン効率の良いガイドライン: 大規模言語モデルが効率的に学習・利用できるよう、最新かつ重要な情報に焦点を当てて設計されています。

主要なガイドラインと対象分野

本プロジェクトは、ウェブプラットフォームの多様な新機能と最先端技術をカバーしています。主要な対象分野は以下の通りです。

  • ユーザーエクスペリエンス (UX): View Transitions、アニメーション、スクロールエフェクト、CSSのscrollbar-colorなど。
  • CSSレイアウト: コンテナクエリ、subgrid、モダンな色空間(oklch)、テキスト処理など。
  • パフォーマンス: 即時プリロード、INP診断、scheduler.yieldによるタスクスケジューリングなど。
  • フォームとUI: Anchor Positioning、Popover API、dialog要素、バリデーション、自動サイズ調整フィールドなど、ネイティブUIコンポーネント。
  • アクセシビリティ: スクリーンリーダー、キーボード操作性、コンテンツナビゲーションなど。
  • ブラウザ組み込み機能: ブラウザにネイティブに搭載されている翻訳、要約、言語検出APIなど、クライアントサイドでの処理。

これらのガイドラインは、具体的なコード例と共に提供され、例えば「ナビゲーションドロワー」のような一般的なUIコンポーネントに対しても、最新かつ効率的な実装方法を提示します。

導入と活用方法

Modern Web Guidance はCLIツールとして提供され、開発環境に容易に統合できます。

クイックスタート

以下のコマンドで、対話型ウィザードを通じてインストールできます。

Terminal window
npx modern-web-guidance@latest install

インストールせずに、機能を試すことも可能です。

Terminal window
# 関連するガイドを検索
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
# IDを指定してガイドを取得
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"
# コードベースをスキャンし、モダン化すべきレガシーパターンを検出
npx modern-web-guidance@latest legacy-scan .

これらのコマンドにより、コーディングエージェントや開発者は、特定の課題に対する最新のガイダンスを迅速に検索し、既存コードの改善点を見つけ出すことができます。

まとめ

GoogleChrome/modern-web-guidance-src は、大規模言語モデルを用いたコーディングエージェントが、現代のウェブプラットフォームの力を最大限に引き出し、高品質なウェブコードを生成するための不可欠なリソースです。主要なブラウザベンダーが協力して作成・維持しており、その信頼性は高く、常に最新の状態に保たれています。

ウェブ開発の現場において、コーディングエージェントの活用は今後さらに加速するでしょう。Modern Web Guidance のような専門知識レイヤーを組み込むことで、生成されるコードの品質とメンテナンス性が飛躍的に向上します。これにより、開発者は、レガシーな問題に煩わされることなく、より創造的な作業に集中できるようになります。このリポジトリは、現代のウェブ開発者、特にコーディングエージェントを積極的に導入しようとしているチームにとって、非常に強力な味方となるでしょう。