wordpress-performance-best-practices

WordPress パフォーマンスのベストプラクティス

AI エージェントと LLM 向けに設計された、WordPress 開発のための包括的なパフォーマンス最適化ガイドです。8 つのカテゴリにわたる 34 のルールを収録し、コードレビューとコード生成の指針となるよう、影響度の高い順に優先順位を付けています。

適用する場面

以下の作業を行う際に、これらのガイドラインを参照してください。

• WordPress プラグインまたはテーマを作成する
• WP_Query またはデータベース操作を扱う
• キャッシュ（トランジェント、オブジェクトキャッシュ）を実装する
• アセットの読み込み（スクリプト、スタイル）を最適化する
• パフォーマンス上の問題がないか WordPress コードをレビューする
• REST API または AJAX ハンドラーを扱う

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	データベースの最適化	CRITICAL	db-
2	キャッシュ戦略	CRITICAL	cache-
3	アセット管理	HIGH	asset-
4	テーマのパフォーマンス	HIGH	theme-
5	プラグインのアーキテクチャ	MEDIUM-HIGH	plugin-
6	メディアの最適化	MEDIUM	media-
7	API と AJAX	MEDIUM	api-
8	高度なパターン	LOW-MEDIUM	advanced-

クイックリファレンス

1. データベースの最適化（CRITICAL）

• db-prepared-statements - クエリでは必ず $wpdb->prepare() を使用する
• db-avoid-post-not-in - post__not_in を避け、代わりに PHP でフィルタリングする
• db-use-wp-query - データベースへの直接クエリではなく、WP_Query/get_posts を使用する
• db-limit-query-results - posts_per_page => -1 は決して使用しない
• db-meta-query-indexing - メタクエリを最適化し、タクソノミーの使用を検討する
• db-fields-optimization - ID だけが必要な場合は fields => 'ids' を使用する

2. キャッシュ戦略（CRITICAL）

• cache-transients-proper-use - 外部 API 呼び出しにはトランジェントを使用する
• cache-object-cache - キャッシュグループとともに wp_cache_* を使用する
• cache-remote-requests - wp_remote_get のレスポンスは必ずキャッシュする
• cache-invalidation - 正確でイベント駆動型の無効化を実装する
• cache-fragment-caching - コストの高いテンプレートの断片をキャッシュする

3. アセット管理（HIGH）

• asset-proper-enqueue - wp_enqueue_script/style を使用し、ハードコードはしない
• asset-conditional-loading - 必要な場所でのみアセットを読み込む
• asset-defer-async - クリティカルでないスクリプトには defer/async を使用する
• asset-dequeue-unused - 使用されていないプラグインのアセットを削除する
• asset-minification - アセットを圧縮し、クリティカル CSS を使用する

4. テーマのパフォーマンス（HIGH）

• theme-avoid-queries-in-templates - テンプレートファイル内でクエリを実行しない
• theme-template-parts - データを渡して get_template_part を使用する
• theme-loop-optimization - ループを最適化し、メタ／タームキャッシュの事前設定を使用する
• theme-hooks-placement - 適切なフックの優先度を使用する

5. プラグインのアーキテクチャ（MEDIUM-HIGH）

• plugin-conditional-loading - 必要な場合にのみコードを読み込む
• plugin-autoloading - PSR-4 オートローディングを使用する
• plugin-activation-hooks - セットアップタスクには有効化フックを使用する
• plugin-hook-removal - 対応する優先度を指定してフックを適切に削除する

6. メディアの最適化（MEDIUM）

• media-responsive-images - srcset および sizes 属性を使用する
• media-lazy-loading - ファーストビューより下の画像は遅延読み込みし、LCP は優先読み込みする
• media-image-sizes - 適切なカスタム画像サイズを定義する

7. API と AJAX（MEDIUM）

• api-rest-optimization - REST エンドポイントを最適化し、キャッシュヘッダーを追加する
• api-admin-ajax - フロントエンドでは REST API を使用し、admin-ajax は避ける
• api-nonce-validation - 適切な nonce 検証を実装する

8. 高度なパターン（LOW-MEDIUM）

• advanced-autoload-optimization - 自動読み込みされるオプションを 800KB 未満に保つ
• advanced-cron-optimization - システム cron を使用し、時間のかかるタスクをバッチ処理する
• advanced-memory-management - バッチ処理を行い、メモリを解放する
• advanced-query-monitor - 最適化の前にプロファイリングを行う

使用方法

詳しい説明とコード例については、各ルールのファイルをお読みください。

rules/db-prepared-statements.md
rules/cache-transients-proper-use.md
rules/_sections.md

各ルールのファイルには、以下が含まれています。

• 重要である理由の簡単な説明
• 説明付きの誤ったコード例
• 説明付きの正しいコード例
• 追加の背景情報と参考資料

完全版ドキュメント

すべてのルールを詳しく記載した完全なガイド：AGENTS.md