ChromeのModern Web Guidance 1.0は、コードを書くAIに渡す手引きで、書かれたコードの検査は別の道具が受け持つ ── AIが書いたコードを、反応の速さ・動きの設定・安全な出力の面で確かめる13項目(2026年11月時点)
ChromeのModern Web Guidance 1.0は、コードを書くAIに渡す手引きで、書かれたコードの検査は別の道具が受け持つ ── AIが書いたコードを、反応の速さ・動きの設定・安全な出力の面で確かめる13項目(2026年11月時点)
目次
- 01 何が公開されたか — Modern Web Guidance 1.0は、コードを書くAIに、ウェブの知識を渡す手引き
- 02 なぜ・背景 — AIが書いたコードは、動いても、速さ・使いやすさ・安全で見落としが残る
- 03 用語 — 手引きの話に出てくる言葉を、先に分けておく
- 04 型別 — 適用範囲、書かれていないこと、確かめる手順
- 05 明日、担当サイトで確認できること
- 06 代替・他の選択肢 — 手引き、検査の道具、人の確かめは、受け持つ範囲が違う
- 07 当サイトで確かめたこと — この記事の時点では、確かめていない
- 08 このテーマの、ここまで — 「AIが書いたものを、誰が確かめるか」を、当サイトが扱ってきた記録
- 09 この記事のまとめ
01 何が公開されたか — Modern Web Guidance 1.0は、コードを書くAIに、ウェブの知識を渡す手引き
出典について
この記事は、2026年11月16日に開いて読んだ次のページの内容を書いている。ChromeのブログModern Web Guidance 1.0の発表(表示された日付は2026年11月10日)、ChromeのModern Web Guidanceの説明ページ(更新日の表示はなし)、web.devのINPの説明と長いタスクの最適化、MDNのprefers-reduced-motion、Content Security Policy、HTML Sanitizer APIである。英語の原文はこの記事では引用せず、読んだ内容を日本語でまとめた。読んだページに書かれていなかったことは、書かれていなかったと書き、この記事では確かめていない。
発表の中身
ChromeのブログとGoogleの説明ページによると、Modern Web Guidanceは、コードを書くAI(コーディングエージェント)に、ウェブ標準の知識、ブラウザごとの対応状況のデータ、良い書き方を渡す「スキル」の集まりである。ブログを書いたのはPhilip Waltonで、2026年11月10日に、1.0として安定版を出したと書いている。導入は、説明ページが勧めるコマンド(npxでmodern-web-guidanceのinstallを実行する)で行う。ほかに、エージェント用のスキルの仕組みや、いくつかのコーディング用の道具のプラグインとして入れる方法も、説明ページに挙がっている。
ブログが前提にしているのは、AIが書いたコードは動くことが多いが、速さ、使いやすさ、安全の面で、見落としが残ることがある、という点である。手引きは、AIがコードを書く前に参照する知識として働く。書かれたコードを人の代わりに検査する道具、とは書かれていない。この違いが、この記事の中心になる。
1.0で加わったこと
ブログは、1.0で加わったことを4つ挙げている。1つ目は、既存のコードを調べて、安全に置き換えられる箇所を見つける「近代化」の流れで、HTML、CSS、JavaScript、package.jsonを対象にする。最初の版は、限られたパターンを静的に調べる、とも書いている。2つ目は、手引きのデータベースを、AIが間違えやすいと確かめられた数百の点に対応する形に広げたこと。3つ目は、各分野の責任者による確認と、利用者に見える手引きのアクセシビリティの確認が入ったこと。4つ目は、AIに手引きを渡した場合と渡さない場合を比べる、公開の評価の画面である。
実務のヒント
「手引きを入れた」と「書かれたコードを確かめた」は、別の話として分けて聞く。手引きを入れたと聞いたら、書かれたコードを、誰が、どの画面で確かめたかを聞き返す。答えが返らなければ、確かめる工程がまだ無い、と読める。
Firefox・Edgeが加わったこと
ブログは、Chromeに加えて、FirefoxとEdgeがこのプロジェクトを支え、貢献に加わると書き、ブラウザ間で互換性を整える取り組みであるBaselineの上に作った共同の作業だと説明している。手引きの内容が、1つのブラウザだけの都合ではなく、複数のブラウザの視点を含むことを示す点で、読む価値がある。ただし、どの手引きがどのブラウザの担当者の確認を受けたかは、読んだページには書かれていなかった。
02 なぜ・背景 — AIが書いたコードは、動いても、速さ・使いやすさ・安全で見落としが残る
「動く」と「良い」は別
ブログが手引きを作った理由として挙げるのは、AIが書いたコードが、画面では動いても、ウェブ標準の新しい機能を使えば簡単に済む所で古い書き方のままだったり、反応の遅さや使いにくさ、安全面の弱さを残したりすることである。ブログは、この点を示すために、別のブログ記事(AIがウェブ開発で間違えやすいこと10個)にもリンクしている。この記事は、そのリンク先を開いて確かめていない。
制作の現場で見れば、これは新しい話ではない。人が書いたコードでも、動いているものが速いとは限らない。ただ、AIは短い時間で大量のコードを出せるので、確かめる前にコードが溜まる。手引きは、書く前の段階で質を上げる試みで、確かめる作業の必要を無くすものではない、というのがこの記事の読み方である。
手引きと検査は、別の道具が受け持つ
Googleの説明ページは、手引きと並べて、Chrome DevTools for agentsという別の道具にも触れている。この道具は、速さの監査を行ったり、画面の読み上げの木構造を調べたりできて、手引きと組み合わせて修正に使える、という説明である。ブログも、ある事例で、手引きとDevTools for agentsを組み合わせたと書く。つまり、公式の書き方では、書く前の知識と、書いたあとの検査は、別の道具の仕事として並んでいる。
注意
説明ページは、Modern Web Guidance自身が書かれたコードを検査する、とは書いていない。「Chromeが公式に、AIのコードを確かめる仕組みを出した」と読むのは言い過ぎになる。出たのは、書く前の手引きの安定版である。
発注側のディレクターに関係する場面
外部の制作会社が、AIを使ってコードを書く場合、発注側のディレクターは、納品されたものを受け取る立場になる。このとき、制作会社が手引きを使っているかどうかは、納品物の質を保証する話ではない。手引きは、書く側の準備の話で、受け取る側の確かめは、納品の条件として別に決めておくのが、現場では扱いやすい。たとえば、納品前に、長い処理の数、動きの設定への対応、HTMLを画面に入れる箇所の数を、数字で報告してもらう。数字の形で受け取れば、前回との比較もできる。
事例の数字は、各社の報告
ブログは、4つの会社の事例を挙げている。そのうち1社は、現代的な書き方の検査に通る率が、61%から94%に上がったと書く。ほかに、手引きを自動のレビューの仕組みとして動かす例や、社内の部品集と合わせて使う例も挙げる。これらの数字は各社の報告で、条件や測り方は、この記事では確かめていない。自分の現場の数字として当てはめる前に、まず自分の現場で、同じ種類の確かめをしてから見る、というのが妥当な読み方である。
03 用語 — 手引きの話に出てくる言葉を、先に分けておく
この記事で使う8つの言葉
表は、読んだページの説明を、筆者が整理したものである。ページによって使い方が違う言葉は、右の列で、どのページかを分けた。
| 言葉 | 読んだページが書く意味 | 読んだページ |
|---|---|---|
| Modern Web Guidance | コーディングAIに、ウェブ標準の知識・互換性のデータ・良い書き方を渡すスキルの集まり | Chromeの説明ページ |
| スキル | AIの環境に入れる、手引きの単位。導入はコマンドやプラグインで行う | Chromeの説明ページ |
| 近代化の流れ | 既存のコードを調べ、安全に置き換えられる箇所を見つける作業。1.0で加わった | Chromeのブログ |
| Baseline | 主なブラウザで使える状態になった機能を示す、ブラウザ間で共通の目安 | web.dev |
| INP | ページが、クリック・タップ・キー入力にどれだけ早く反応するかの目安。観測した中で最も長い反応が、外れ値を除いて、最終の値になる | web.devのINP |
| 長いタスク | メインスレッドで50ミリ秒より長く続く処理 | web.devの長いタスク |
| prefers-reduced-motion | 動きを減らしたいという利用者の端末の設定を、CSSで読むための指定 | MDN |
| CSP | ページが読み込めるものや、できることを限り、クロスサイトスクリプティングなどの危険を減らす仕組み | MDN |
「長いタスク」と「INP」の関係
web.devの長いタスクのページは、50ミリ秒より長く続く処理を「長いタスク」と呼ぶと説明し、その処理が続く間、ブラウザは入力に応えにくくなる、という考え方を示す。ページの更新日の表示は、2024年12月19日(UTC)だった。INPのページは、良好の目安を200ミリ秒以下、改善が必要を200ミリ秒を超え500ミリ秒まで、不良を500ミリ秒を超える場合と書く(実際の訪問者の75パーセンタイル、更新日の表示は2025年9月2日(UTC))。2つの数字は別のもので、50ミリ秒は処理の長さの目安、200ミリ秒は反応の速さの目安である。
動きの設定とCSPが、確かめの対象になる理由
動きの設定は、見た目の好みの話ではなく、利用者の体調に関わる設定として、MDNのページに書かれている。AIが派手な動きを付けたコードを出したとき、設定への対応が抜けていないかを確かめるのは、受け取る側にしかできないことが多い。CSPは、ページが読み込めるものを限る仕組みで、AIが外部の部品を足したコードを書いた場合に、許可の範囲が広がりすぎていないかを確かめる入口になる。ただし、これは筆者の整理で、手引きがそう書いているわけではない。
用語が混ざりやすい所
INPの説明ページは、長いタスクが入力の遅れの原因になりうる、という書き方をしている。つまり、長いタスクがあるからINPが必ず悪くなる、とは書いていない。長いタスクは原因の候補の1つで、INPは結果の数字である。この記事の確認項目も、この違いに合わせて、処理の数を数える項目と、反応の数字を見る項目を別にした。
用語
メインスレッドは、ブラウザが画面の描画や入力の処理、JavaScriptの実行を、順番に行う場所のこと。長い処理が居座ると、その間、ほかの処理が待たされる。web.devの長いタスクのページは、処理を細かく分け、途中でブラウザに処理を戻す方法(scheduler.yield()など)を挙げている。
04 型別 — 適用範囲、書かれていないこと、確かめる手順
適用範囲: 誰に関係する話か
手引きの対象は、コーディングAIを使ってウェブのコードを書く、または直す人である。制作会社の担当者、自社の運用担当者、外部の制作会社に依頼する発注側のディレクターは、AIが書いた成果物を受け取る立場として関係する。説明ページは、新しい体験を作る、古いコードを近代化する、安全を改善する、速さを改善する、という4つの種類の依頼の例を挙げている。AIを使わずに書かれたコードには、この手引きは直接は関係しない。ただし、確かめる面は、人が書いたコードにも使える。
確かめていないこと
この記事は、次のことを確かめていない。手引きを入れたAIが、実際にどの程度、見落としを減らすか。公開の評価の画面の数字の中身。各社の事例の数字。近代化の流れが、実際のコードで何を見つけるか。パスキー(パスワードに代わるログインの方式)についての手引きの中身。ブログがパスキーに触れていることは確かだが、この記事では扱わない。読んだページには、これらについて、この記事が根拠にできる詳しい説明が見つからなかった。書かれていないことを、書かれていないまま持っておくのが、この記事の立場である。
3つの面を選んだ理由と、選ばなかったもの
ブログが手引きの分野として挙げるものは、3つより多い。キーボードで操作したときの焦点の扱い、フォームの入力の確認、画面のずれの防止、パスキーによるログインなどである。この記事が3つに絞ったのは、1回の確かめが、1人で、1時間以内に終わる大きさにするためで、ほかの分野に価値が無いという意味ではない。選ばなかった分野は、この記事では確かめていない。担当サイトの事情に合わせて、面を差し替えてよい。差し替えるときも、数を数える、画面で見る、という形は保つと、記録の表に並べやすい。
手順: 受け取ったコードを確かめる順番
手引きとは別に、AIが書いたコードを受け取るときの確かめを、3つの面に絞る。反応の速さ、動きの設定、安全な出力である。この3つは、ブログが手引きの分野として挙げるものの中から、筆者が選んだ。ここで選んだのは筆者で、公式が確認項目として出したものではない。選んだ理由は、3つとも、画面と数字で確かめられるからである。1つ目は、Chromeの開発者ツールで長い処理を数える。2つ目は、端末の設定を変えて動きを見る。3つ目は、HTMLを画面に入れる箇所と、CSPの指定を数える。
確かめる対象は、1回に3つまでの画面や部品に絞る。全部を確かめようとすると、終わらない。反応の速さの数字を、ページ全体で見るには、🔧 WEBサイトの最大3ページ Lighthouse監査・チェックツールが使える。
実務のヒント
AIに「速くして」と頼む前に、現状の数字を1つだけ記録する。長いタスクの数でも、INPの数字でもよい。直す前の数字がなければ、直した後に、良くなったかを言えない。
05 明日、担当サイトで確認できること
このリストの使い方
このリストは、Chromeの開発者ツール、担当サイトのページのソース、公式の3つのページを開いた状態で、上から順に進める。この13項目は、公式が出した確認項目ではなく、手引きの内容から筆者が選んだものである。画面の名前は、時期や言語で違うことがあるので、近い名前の項目で読み替える。チェックの状態は、ブラウザに保存され、サーバーには送られない。数を書く項目は、記録の表に書き写す。
13項目
- Chromeの説明ページを開き、導入のコマンドと、挙げられた依頼の種類を、記録の表に書き写す(4種類あるかを数える)
- Chromeのブログを開き、1.0で加わったことを、記録の表に4つ書き出す
- 説明ページに、更新日の表示があるかを、ある・ないで記録の表に書く
- 自社で使っているコーディングAIの名前を、記録の表に書き、手引きの導入の方法が説明ページに載っているかを、載っている・載っていないで書く
- 担当サイトで、AIが書いたコードが入っているページを3つ選び、ページの題を記録の表に書く
- 選んだ3ページをChromeの開発者ツールのPerformanceパネルで操作し、50ミリ秒を超える処理の数を、ページごとに書く(0なら0と書く)
- web.devのINPのページを開き、良好の目安の数字を書き写し、選んだ3ページのINPの値が、その目安以下かを、以下・超えるで書く
- 選んだ3ページのCSSを開き、prefers-reduced-motionの指定があるページの数を書く(0なら0と書く)
- 端末の設定で動きを減らす設定をオンにして、選んだ3ページで動く部分が止まるかを、止まる・止まらないで書く
- 選んだ3ページのソースで、HTMLの文字を画面に入れている箇所(innerHTMLなど)の数を、ページごとに書く(0なら0と書く)
- MDNのHTML Sanitizer APIのページを開き、対応状況の説明が、どう書かれているかを、一言で記録の表に書く
- 選んだ3ページのレスポンスヘッダーで、Content-Security-Policyの指定があるページの数を書く(0なら0と書く)
- ここまでの数を、確かめた日付と一緒に記録の表にまとめ、次に確かめる日を、1か月後の日付で書く
06 代替・他の選択肢 — 手引き、検査の道具、人の確かめは、受け持つ範囲が違う
受け持つ範囲を並べる
表は、読んだページの内容と、一般的な運用を、筆者が整理したものである。公式の文書に、どれを選ぶべきという記述は無い。
| 手段 | 受け持つ範囲 | 書かれていること |
|---|---|---|
| Modern Web Guidance | AIがコードを書く前に参照する知識 | ウェブ標準の知識・互換性のデータ・良い書き方を渡す。書かれたコードの検査とは書かれていない |
| Chrome DevTools for agents | 速さの監査や、画面の読み上げの木構造の確認 | 説明ページが、手引きと組み合わせて使えると書く |
| 自動のレビューの仕組み | 書かれたコードを、決まりに沿って自動で調べる | ブログの事例の1つが、手引きを自動のレビューの仕組みとして動かしたと書く |
| 人の確かめ | 画面と数字で、受け取る前に確かめる | 公式が書く範囲ではない。この記事の13項目は、ここに当たる |
3つの面は、どの公式ページに根拠があるか
3つの面を選んだとき、それぞれの面で、公式のページに書かれていることを確かめた。反応の速さは、INPのページと長いタスクのページが、目安の数字を書く。動きの設定は、MDNのprefers-reduced-motionのページが、動きを減らしたい利用者の設定を読む指定だと書き、動きが、平衡感覚の障害のある人に不快感を与えうると説明する(ページの更新日の表示は2026年6月10日)。安全な出力は、MDNのCSPのページが、クロスサイトスクリプティングなどの危険を減らす仕組みだと書く(更新日の表示は2026年3月22日)。
注意
CSPは、入力のチェックをしなくてよくなる仕組みではない。MDNのページは、CSPを、入力の消毒が失敗した場合の備えとして働く、という趣旨で説明している。HTMLを画面に入れる箇所を減らす、または安全な方法に替える作業は、別に残る。
HTMLを安全に入れる方法の対応状況
MDNのHTML Sanitizer APIのページは、信頼できないHTMLを、DOMに入れる前に、危険な要素や属性を取り除く仕組みだと説明している。安全な入れ方のメソッドと、設定どおりにしか処理しないメソッドがあると書く。ページの更新日の表示は2026年11月9日で、主要なブラウザの一部で動かないため、Baselineではない、という扱いだった。どのブラウザが対応していないかは、読んだ内容には書かれていなかった。使う前に、自分の対象のブラウザの対応状況を、MDNの対応表で確かめる必要がある。
07 当サイトで確かめたこと — この記事の時点では、確かめていない
2026年11月16日の時点で確かめていないこと
この記事は、公式のページを2026年11月16日に読んで書いた。当サイトのページで、長い処理の数、動きを減らす設定への対応、HTMLを画面に入れる箇所、CSPの指定を数えた結果は、この記事を書いた時点では、ここに書く事実として確かめていない。当サイトの運営で、コーディングAIの手引きを使っているかどうかも、ここには書かない。05章の13項目を、当サイトで行ったかどうかも、確かめていない。
これから確かめること
この記事を本番に出したあと、運営の担当者が、05章の6項目目から12項目目までを、当サイトの3ページで行い、結果を、この章の末尾に日付つきで追記する。数だけを書き、設定の中身や、ページごとの結果の詳細は書かない。確かめられなかった項目は、確かめられなかったと書く。
実務のヒント
確かめた結果は、見つけた日と、確かめた人の役割だけを書く。「いつ、誰の役割が、何を見たか」の3つがあれば、あとから読み返せる。人の名前や設定の中身を書くと、記録の表が共有しにくくなる。
2026年11月17日 追記 ── 05章の6〜12項目目を、当サイトの3ページで行った
この記事を本番に出した2026年11月17日に、運営の担当者が05章の6項目目から12項目目までを、当サイトの3ページで行った。選んだのは、トップページ、この記事のページ、サイト総合分析ツールのページ。どれも、コードを書くAIが手を入れたコードを含む。画面のないブラウザで開き、下へ4回スクロールして測った。07章の約束どおり、数だけを書く。
| 項目 | トップ | この記事 | サイト総合分析 |
|---|---|---|---|
| 6 50ミリ秒を超える処理の数 | 2(長いもので169ミリ秒) | 0 | 1(79ミリ秒) |
| 7 INPが良好の目安以下か | まだ確かめていない(実際の利用者の値が要る) | ||
| 8 CSSにprefers-reduced-motionの指定 | 0(13ファイル中) | 0(9ファイル中) | 0(9ファイル中) |
| 9 動きを減らす設定で、動く部分が止まるか | 動いている部分0 | 動いている部分0 | 動いている部分0 |
| 10 innerHTMLで文字を入れている箇所 | 11 | 7 | 8 |
| 11 MDNのHTML Sanitizer APIの説明 | まだ確かめていない | ||
| 12 Content-Security-Policyの指定 | あり | あり | あり |
10項目目は、そのページが読み込む当サイトのJavaScriptのファイルの中で、innerHTMLに値を入れている箇所を数えた。ページごとの数は、読み込むファイルの数の違いでもある。どの箇所が外から来た文字を入れているかは、まだ1つずつ見ていない。
8項目目と9項目目は、指定は0だったが、動きを減らす設定にした時点で、動いている部分も0だった。動く部分を足すときに、指定を一緒に足す。
まだ確かめていないこと
7項目目(INP)は、実際に訪れた人の値で確かめる。11項目目は、MDNのページを開いて読む。どちらも、確かめたあと、この章の末尾に日付をつけて追記する。
08 このテーマの、ここまで — 「AIが書いたものを、誰が確かめるか」を、当サイトが扱ってきた記録
AIが作ったものと、確かめることの記録
当サイトは、AIが関わる成果物と、それを確かめる作業を、何度か扱ってきた。AIエージェントのコードに脆弱性が見つかった日は、AIが書いたコードの安全の問題を扱った。記事のチェック項目を自分のサイトに当てたら、自分のサーバーが対象だったは、記事で薦めた確認を、自分に当てた記録である。「0件」は安心ではない、「N件」は危険ではないは、数え方の針が、両方向に外れうることを扱った。
「使われていないコード」は証明できないは、コードの確かめの難しさを、ログインのCookieにSameSiteを書いたのに、応答には付いていなかったは、書いた設定が、実際に効いているかを応答で確かめる大切さを扱った。本番のコードが、試験環境の設定を読んでいたは、同じ名前が別の場所の設定を読んでいた、という記録である。この記事は、手引きが入っても、書かれたものを確かめる作業は残るという点で、これらの記録とつながっている。
当サイトのほかの記事との対応
AIの道具が書き出す成果物を選ぶ時の考え方は、AIライティングツールを選ぶ前に決めるのは、機能の数ではなく公開までの工程である。Googleの文書が問うのは、目的・量・事実確認・作り方の説明で扱った。ページがAIエージェントに道具を差し出す仕組みは、WebMCPは、ページがAIエージェントに操作の「道具」を差し出す実験段階の仕組みが扱っている。INPの数字の見方は、CrUXの2026年8月分でもINPの悪化が続き、原因は公式にも分かっていないと、Cloudflareの実ユーザー計測が、LCPを4段階・INPを3段階に分けて見せるようになった。直す前に、いちばん長い段階を決めるが扱った。
この記事の位置
この記事は、手引きが渡すもの、書かれていないこと、受け取る人が確かめることを、混ぜずに分けるための記事である。手引きの効果の数字は、各社の報告で、この記事では判断しない。確認の項目は、手引きの内容から筆者が選んだもので、公式が確認項目として出したものではない。
2026年11月16日 — この記事の確認日
この記事の内容は、2026年11月16日に、ページを開いて読み、日本語でまとめた。Chromeの説明ページには、更新日の表示が見つからなかった。ほかのページの更新日は、本文中に書いた。次に確かめる日は、2026年12月16日を目安にする。
現在の貴方のIPアドレス
このサイトで書いている人
WEBサイト