WordPressサイト: 空フォルダから本番公開まで
このキットは方法論とスタータープロジェクトを兼ね備えています。実際に顧客が支払いを行う多言語予約サイトで培われました。ステージは順番通りに進めてください。各ステージの最後にはゲートがあり、そのゲートが真であり、その証拠が文書化された場合にのみ次のステージに進むことができます。
1. プロジェクトの現在地を特定する
- プロジェクトルートに
SITE_STATUS.mdが存在するか確認します。- 存在しない場合: プロジェクトは未開始です。wp-kickoff を使用してください。
- 存在する場合: 内容を読んでください。現在のステージは、チェックが入っていないゲートを持つ最初のステージです。
AGENTS.md(プロジェクトのルール)を読み、次にSESSION_LOG.mdとDECISIONS.mdの最新行を確認します。- オーナーに対して、現在のステージと次の具体的な手順を2行で伝えます。
2. ステージ一覧
| # | ステージ | スキル | ゲート(証拠は SITE_STATUS.md に記載) |
|---|---|---|---|
| 1 | キックオフ | wp-kickoff | オーナーがブリーフを承認、決定事項がロックされて文書化、プライベートリポジトリ、認証情報が名前でリストアップされている |
| 2 | デザイン | wp-design | 静的プロトタイプが承認済み(スクリーンショット+日付)、トークンが設定済み、フォントがセルフホストされている |
| 3 | ビルド | wp-build | ローカルサイトが動作、コアプラグイン+子テーマが有効、実際のアイテムがコア関数でレンダリング、問い合わせが転送前に保存される、構造テストがグリーン |
| 4 | コンテンツ | wp-content | すべての公開ページにオーナー承認済みのコピーと実際の写真がある、法的ページが存在する、未承認のAIテキストがない |
| 5 | SEOと言語 | wp-seo | タイトル、説明、canonical、schema、hreflang テストがグリーン、古いURLのリダイレクトマップ、各追加言語がパイロットテストを通過 |
| 6 | 品質 | wp-quality | 完全スイートがグリーン、アクセシビリティ違反0、パフォーマンスバジェットをステージングで達成 |
| 7 | 出荷 | wp-ship | ステージングが本番環境をミラーリング、ハードニング適用済み、launch-auditor が PASS、カットオーバー完了、7日間監視 |
| 8 | 運用 | wp-operate | 自動バックアップがオフマシンコピーあり、リストアドリルを1回実施、更新とアラートのルーチンが記述されている |
- ステージの作業をビルダーエージェント(Antigravity、Codex、別のClaude)に委任する場合: wp-task-file
- マージ前のレビュー: エージェント wp-rules-reviewer。公開前: エージェント launch-auditor
3. ハードルール(すべてのステージ、すべてのエージェント)
- プラグイン優先。 ロジック、データ、ポリシーテキスト、フォーム、スキーマ、SEO はコアの must-use プラグインに配置します。テーマはレイアウトです。スキンは見た目です。リデザインで機能を失ってはいけません。
- テンプレートにカード、価格、スラッグをハードコードしない。 コンテンツタイプをクエリし、コアのレンダリング関数を通してレンダリングすることで、CMSの編集が全域に反映されるようにします。
- リードは先に保存する。 フォームは nonce 付きで
admin-post.phpに投稿します。サイトはリードを自身のデータベースに保存してから転送します。ページ内にAPIキーやサードパーティのエンドポイントは含めません。 - 偽の証拠は禁止。 誰も証明できない評価、レビュー数、お客様の声を表示してはいけません。インポートされた、または「レガシー」なレビュー数は、証明されるまで偽物とみなします。
- 実際の写真 名前付きの場所、部屋、製品、人物には必ず実際の写真を使用します。AI画像は一般的な風景としてのみ使用し、ファイル名は
ai-*とし、ログに記録し、「これがあなたの部屋です」と提示してはいけません。 - 事実はオーナーから得る。 価格、ポリシー、含まれるもの、安全に関する事実は決して創作してはいけません。AIコピーは、オーナーが承認するまでドラフトです。不明な場合は
PENDING-<who>とします。 - AIが書いたPHPを本番環境に投入しない ブランチ、ローカルテスト、diff、人間によるマージなしでは禁止。WordPress Coding Standardsに従い、すべてにプレフィックスを付けます。
- ページビルダーは禁止。Googleフォントの呼び出しは禁止。 フォントはセルフホスト:ドイツの裁判所は、Googleからのフォント読み込みが訪問者のIPアドレスを漏洩させるとして損害賠償を命じました。
- ステージングとローカルはインデックス禁止 実際の顧客にメールを送信してはいけません。
- テストを弱めてグリーンにしてはいけない: 削除、スキップ、再スナップショットは禁止。テストの名称変更にはオーナーの承認が必要です。
- デプロイはオーナーの責任。 コミットから
scripts/deploy-safe.shを通じて:最初にドライラン、最初にバックアップ、人間がliveと入力します。 - データベースはコンテンツです。 変更はレビュー可能な変更ファイルと、ドライラン付きのガードされたスクリプトを通じてのみ行います。データベース変更の前には必ずバックアップを取ります。
- 機密情報は絶対に git、ログ、プロンプト、ページに入れません。
CREDENTIALS_INVENTORY.mdには名前と各機密情報の保存場所のみを記載し、値は絶対に記載しません。 - スキーマの所有者は1人(通常はSEOプラグイン)。価格なしで
Offerを出力してはいけません。
4. 最初にオーナーに確認すること
- プラグイン、テーマ、ツール、有料サービスのインストール(ページビルダーは絶対に不可)
- 価格、通貨、ポリシー、ブランド名、ロゴの変更。新しい言語の公開。
- DNS、Cloudflare、ホスティング、ステージング、本番環境に影響するすべてのこと。破壊的なDBやファイルコマンド。
- コードや顧客コンテンツをサードパーティのAI APIに送信すること。
5. 作業方法
- 一度に1つのステージ、一度に1つの小さなステップ。意味のあるステップごとにコミットします(Conventional Commits)。
- ブランチ、ローカルテスト、diff、その後オーナーがマージします。エージェントは、オーナーがそのアクションを明示的に依頼しない限り、プッシュ、マージ、デプロイ、サーバーへの
sshを決して行いません。 - すべての決定は
DECISIONS.mdに記録します(日付、誰が、なぜ)。各セッションの終了時にはSESSION_LOG.mdに行を追加します。 - 「完了」とは確認済みを意味します:ページを開き、テストを実行し、サーバーの応答を読みます。他のエージェントの「解決済み」を自分で確認せずに繰り返してはいけません。
6. 他のキットからの便利なスキル(インストールされている場合)
- agent-skills-kit:
wordpress-modern、wp-plugin-development、wp-wpcli-and-ops、wp-performance(WordPress APIの詳細) - agent-loop-kit:
supervised-build、agent-supervisor(ゲートとレビュアー付きの無人ビルダーループ用)