効果のあるパフォーマンス予算：高速なウェブアプリのための実践的な上限

なぜパフォーマンスには「予算」が必要か\n\nパフォーマンス予算は、ビルド前に合意する一連の上限です。時間（ページがどれだけ速く感じられるか）、サイズ（送るコード量）、あるいは単純な上限（リクエスト数、画像、サードパーティスクリプト）にできます。上限を超えたら「後で直すべき」ではなく、壊れた要件として扱います。\n\n遅くなるのは大抵、出荷が加算的だからです。新しいウィジェットが増えるたびに JavaScript、CSS、フォント、画像、API 呼び出しが増え、ブラウザの仕事が増えます。小さな変更でも積み重なってアプリが重く感じられ、特に中堅スマホや遅いネットワークでは顕著です。\n\n感覚や意見は守ってくれません。「自分のラップトップでは問題ない」と「遅い」の議論が続くだけです。予算は議論を終わらせ、パフォーマンスを測定・強制できるプロダクト制約に変えます。\n\nAddy Osmani の考え方と同様に、パフォーマンスをデザイン制約やセキュリティルールのように扱うべきです。セキュリティを「頑張って保つ」やレイアウトが「良く見えることを期待する」のではなく、基準を設定し継続してチェックし、壊す変更をブロックします。\n\n予算は実用的な問題を同時に解決します。トレードオフを明示化し（機能を追加するならどこかで代償を払う）、回帰を早期に捕まえ、全員に「十分に速い」の共通定義を与えます。リリース直前のパニックを減らす効果もあります。\n\n例えばリッチなチャートライブラリをダッシュボードに追加すると、全員に配信されメインバンドルが膨らみ、最初の有意味な画面が遅れます。予算がなければ「機能が動く」ので通ってしまいますが、予算があればチームは遅延読み込みにするかライブラリを替えるか表示を簡素化するかを選ぶ必要があります。\n\nこれは Koder.ai のように素早くアプリを生成・反復できる環境で特に重要です。速く作れるのは良いことですが、気づかないうちに余分な依存や UI の装飾を出荷しがちです。予算は速い反復が遅いプロダクトになるのを防ぎます。\n\n## シンプルな目標から始める：ページ、デバイス、ネットワーク\n\nパフォーマンス作業は「全部を測るが誰も責任を持たない」と失敗します。実際のユーザーに重要な一つのページフローを選び、予算の基準にします。\n\n良い出発点はコンバージョンや日常作業に影響する主要なジャーニーです（例：「ホーム→サインアップ」「ログイン後のダッシュボード最初の読み込み」「チェックアウトと確認」）。代表的で頻度の高いものを選び、エッジケースは避けます。\n\n### ユーザーに合ったターゲットを選ぶ\n\nアプリはあなたのラップトップで動いているわけではありません。高速マシンで問題なく見えても、中堅スマホでは遅く感じることがあります。\n\nまず一つのデバイスクラスと一つのネットワークプロファイルを決め、それを文章にして誰でも繰り返せるようにしておきます。\n\n例：過去2〜3年の中堅 Android スマホ、移動中の 4G（オフィス Wi‑Fi ではない）、コールドロード測定と主要なナビゲーション1回、ユーザーが多い地域で測定。\n\nこれは最悪ケースを選ぶという意味ではなく、実際に最適化できる代表的なケースを選ぶという意味です。\n\n### ベースラインのテスト設定を固定する\n\n数値は比較可能でなければ意味がありません。ある実行が「拡張機能ありの Mac の Chrome」で、別の実行が「スロットルしたモバイル」だとトレンドはノイズになります。\n\n予算チェック用に基準環境を一つ決めて守ってください：同じブラウザバージョン、同じスロットリング設定、同じテストパス、同じキャッシュ状態（コールドかウォームか）。実機を使うなら同じ機種を使います。\n\n「十分速い」を行動で定義します（完璧なデモではなく）。例えば「ユーザーが素早くコンテンツを読み始められる」や「ログイン後にダッシュボードが応答的に感じられる」です。それをこのジャーニー向けの一つか二つの指標に翻訳し、そこに予算を設定します。\n\n## 予算の種類：タイミング、サイズ、リクエスト、ランタイム\n\n予算はユーザーの体感（何を感じるか）とチームが制御できる要素（なぜ遅くなるか）を両方カバーすると効果的です。良いセットは体験指標とリソース／CPU の上限を混ぜます。\n\n### タイミング予算（ユーザー体験）\n\nこれらは実際の人にとってページがどう振る舞うかを追います。最も有用なのは Core Web Vitals に直結するものです：\n\n- LCP（Largest Contentful Paint）：主要コンテンツがどれだけ早く表示されるか。\n- INP（Interaction to Next Paint）：タップやクリック、入力時の応答性。\n- CLS（Cumulative Layout Shift）：レイアウトのズレの量。\n\nタイミング予算はユーザーの不満に直結するため北極星になりますが、何を直すかは示さないことがあるので、以下のタイプの予算も必要です。\n\n### サイズ、リクエスト、ランタイム予算（遅さの原因）\n\nこれらはビルドやレビューで強制しやすく、具体的です。\n\nウェイト予算は総 JavaScript、総 CSS、画像の重さ、フォントの重さなどを上限で縛ります。リクエスト予算は総リクエスト数やサードパーティスクリプトを制限し、ネットワーク上のオーバーヘッドやタグ・ウィジェットからの「驚き」を減らします。ランタイム予算はロングタスク、メインスレッド時間、ハイドレーション時間（特に React）を制限し、なぜページが中堅機で「重く感じる」かを説明する手がかりになります。\n\n実用的な React の例：バンドルサイズは問題なさそうでも、新しいカルーセルがクライアントレンダリングを重くし、ページは読み込まれてもフィルタ操作が引っかかることがあります。起動時のロングタスクを制限したり、ハイドレーションが中堅機で Y 秒以内に終わるようにするランタイム予算を設けると、ウェイト予算だけでは見えない問題を捕まえられます。\n\n最も強いアプローチはこれらを一つのシステムとして扱うことです：体験予算が成功を定義し、サイズ／リクエスト／ランタイム予算がリリースを正直に保ち、何が変わったかを簡単に答えられるようにします。\n\n## 実際に強制できる具体的なスタータ予算\n\n上限を多くしすぎると誰も気にしなくなります。まずはユーザーが最も感じる点に合い、かつ各 PR やリリースで測れる 3〜5 個を選んでください。\n\n実用的なスターターセット（後で調整）：\n\n- LCP：警告 2.5s、失敗 3.0s（モバイル、コールドロード）。\n- INP：警告 200ms、失敗 300ms（メニュー開閉やフォーム送信などの一般的な操作）。\n- CLS：警告 0.10、失敗 0.15。\n- JavaScript バンドルサイズ（初期ルート）：警告 170KB gzip、失敗 220KB gzip（アプリコードのみ）。\n- 画像（初期表示）：警告 800KB、失敗 1.2MB（最初の画面で転送される画像の合計バイト）。\n\n二段階の閾値にすると運用が現実的になります。警告は「ズレてきている」を知らせ、失敗はリリースをブロックするか明示承認を要求します。これで限界が現実のものになりますが、常時の火消しにはなりません。\n\n予算は共有場所に短く具体的に書いておいて、どのページ／フローをカバーするか、どこで測るか（ローカル監査、CI、ステージビルド）、どのデバイスとネットワークを使うか、指標の定義（フィールド vs ラボ、gzip vs 生データ、ルート単位 vs アプリ全体）を明確にしてください。\n\n## 現行アプリから予算を設定する手順\n\n繰り返せるベースラインから始めます。キーとなるページを一つ二つ選び、同じデバイスプロファイルとネットワークで毎回テストします。テストは少なくとも3回実行し中央値を記録して、一回の外れ値に方向性を左右されないようにします。\n\nシンプルなベースラインシートにユーザー指標とビルド指標を入れます。例：ページの LCP と INP、それにビルドの総 JavaScript サイズと総画像バイト数。こうするとラボの推定だけでなく「実際に何が出荷されたか」が見えるので予算が現実味を帯びます。\n\n現在の中央値より少しだけ良くなる設定にしてください。一気に非現実的な数値にするのは避けます。例えば LCP がベースラインで 3.2s なら、いきなり 2.0s を目指すのではなく 3.0s を最初の目標にします。守れることを証明してから徐々に厳しくします。\n\n各リリース前に簡易チェックを追加します。人がスキップしない程度に速くすることが重要です。シンプルな運用例：合意したページで単一ページの監査を実行し、JS や画像が予算を超えたらビルドを失敗させ、コミットごとに結果を保存していつ増えたかがわかるようにし、常に同じ URL パターンでテストする（ランダムデータは避ける）。\n\n違反は週次でレビューし、誰かが苦情を言うまで放置しないでください。違反をバグとして扱い、原因となった変更を特定し、今直すものと後で予定するものを決めます。徐々に厳しくし、数リリースにわたって守れたらさらに引き締めます。\n\nプロダクトの範囲が変わったら予算を意図的に更新します。新しい解析ツールや重い機能を追加したら、何が増えたか（サイズ、リクエスト、ランタイム）、その後でどう返済するか、いつ予算を元に戻すかを書き留めます。\n\n## クイック監査：何が変わったか素早く見る方法\n\n予算は素早くチェックできて初めて役に立ちます。10 分監査の目的は完璧な数値を出すことではなく、最後に良好だったビルドから何が変わったかを見つけ、何を先に直すかを決めることです。\n\n### 10 分監査の流れ\n\n代表的な一ページから始め、毎回同じ簡易チェックを実行します：\n\n- LCP 要素を特定する（ヒーロー画像、見出しブロック、製品ギャラリーなど）。LCP 要素が変わると結果が大きく変わることがあります。\n- JavaScript の重量と最大のチャンクを確認する。新しい依存、重複ライブラリ、大きな機能が全員に出荷されていないか探します。\n- 折り返し領域の画像に、圧縮不足、誤った寸法、レスポンシブソースの欠如といった共通ミスがないか見る。\n- サードパーティタグ（解析、チャット、A/B テスト）を確認する。新しいタグ一つが大きなダウンロードやロングタスクを追加することがあります。\n- ネットワークと CPU を合わせて見る：バイト数が増えたから遅いのか、ページがやり過ぎているから遅いのかを見極めます。\n\n### 数分で最大の問題を見つける方法\n\n通常はネットワークウォーターフォールとメインスレッドタイムラインの2つのビューで数分内に答えが出ます。\n\nウォーターフォールで重要なのはクリティカルパスを支配するリクエストです：巨大なスクリプト、ブロッキングフォント、遅れて開始する画像など。LCP リソースの要求が早くないと、サーバが速くても LCP 目標は達成できません。\n\nタイムラインではロングタスク（50ms 以上）を探します。起動周りでロングタスクが固まっていると、初回読み込みで JS が多すぎることが多いです。一つの巨大なチャンクはルーティングの問題か共有バンドルの肥大を示します。\n\n### 次回の比較を可能にするメモ\n\nクイック監査は毎回変わる実行で失敗します。基本情報を残して差分が明確になるようにしてください：ページ URL とビルド／バージョン、テストデバイスとネットワークプロファイル、LCP 要素の説明、追跡する主要数値（例：LCP、総 JS バイト、リクエスト数）、最大の原因に関する短いメモ。\n\nデスクトップテストはクイックなフィードバックや PR チェックに有用です。予算に近づいたとき、見た目が引っかかるとき、ユーザーがモバイル寄りのときは実機でテストしてください。モバイル CPU はロングタスクを明確にし、「ラップトップでは問題ない」が崩れる箇所を浮き彫りにします。\n\n## 何を先に直すか：時間を節約するシンプルなルール\n\n予算が破られたときに「すべて最適化する」のは最悪です。再現可能なトリアージ順を使い、各修正に明確な効果が見えるようにします。\n\n### 実用的なトリアージ順\n\nユーザーが最も気にするところから始め、細かな調整に進みます：\n\n- ファーストビューの主要要素を速くする。 最も大きく描画される要素を見つけ、その資産やレンダリング経路を修正します。画像のリサイズと圧縮、適切なフォーマットの使用、最初の表示をブロックする遅延フォントの回避など。\n- CSS を磨くより先に JavaScript を削る。 JS が多すぎると解析が遅く、メインスレッド作業が増え、描画が遅れます。未使用コードの削除、重いルートの分割、単純な UI はサーバレンダリングや静的化を優先します。\n- サードパーティスクリプトを早めに手なずける。 チャットウィジェット、解析、タグマネージャー、A/B ツールは大きなダウンロードやロングタスクを生むことがあります。初回表示に不要なら遅延読み込み、価値が低ければ削除します。\n- レイアウトシフトは設計で止める。 画像・広告・埋め込みのスペースを予約し、width/height を設定し、安定したプレースホルダを使い、読み込み後に既存コンテンツの上に UI を注入しないようにします。\n- 操作が重いならロングタスクを減らす。 INP が悪ければ大量のクライアント処理、大きな状態更新、高コストな JSON 処理を探します。処理を小さく分け、再レンダを減らし、非 UI 作業をクリティカルパスから外します。\n\n### 具体例\n\nあるチームが新しいダッシュボードを出し、一気に LCP 予算を外しました。キャッシュヘッダを調整する前に LCP 要素を調べると、フル幅のチャート画像が原因でした。画像をリサイズして軽いフォーマットで配信し、必要な部分だけ先に読み込みます。さらに大きなチャートライブラリが全ルートで読み込まれているのを見つけ、そのライブラリは分析ページだけで読み込み遅延するようにしました。サードパーティのサポートウィジェットも最初の操作後まで遅延させ、1 日でダッシュボードは予算内に戻りました。次のリリースでは「何が変わったか」が明確になりました。