今回やった作業
今回やった作業は、公開中サイトのトップページを、単なるカード一覧やリンク集ではなく、サイト全体の案内板として読めるページへ補強したことです。トップページにはすでにカード、ランキング、内部リンクがありましたが、それだけでは初めて来た読者に全体像が伝わりにくい状態でした。
そこで、H1付近または主要カード一覧の前に、サイトの役割、読者ができること、カテゴリやランキングの見方、重要ページへの導線を説明するguideを追加しました。カードを増やすのではなく、カードの意味を説明する方向です。
この作業では、トップページのtitle、description、H1、canonical、robotsを変えず、既存カードやランキングを壊さないことを優先しました。トップページは影響が大きいので、静的partsで小さく補強する方針にしました。
作業前の状態
作業前のトップページには、コンテンツ自体はありました。カードやランキング、内部リンク、最新情報など、要素はそろっていたものの、読者が最初に見た時に「このサイトは何を整理しているのか」「どこから見ればよいのか」が分かりにくい状態でした。
カードが多いページほど、説明が不足するとリンク集に見えやすくなります。カードの数が多いことは便利でも、読者が選ぶ基準を持てなければ、どれをクリックすればよいか迷います。
また、トップページは検索エンジンだけでなく、人間の第一印象にも関わります。奥のページがいくら作り込まれていても、入口でサイトの役割が伝わらないと、回遊につながりにくくなります。
作業前に問題だったこと
問題だったのは、トップページがサイト全体の母艦として機能しきれていなかったことです。内部リンクはあっても、リンクに意味づけがないと、読者はただ並んだカードを眺めるだけになります。
特にランキング型サイトや情報メディアでは、トップページが「何を比較できるのか」「どのカテゴリから探せるのか」「ランキングと個別ページをどう使い分けるのか」を説明する必要があります。これがないと、ページ数が多くても情報のまとまりが弱く見えます。
AdSense審査や内容品質を意識する場合も、トップページでサイトの価値が伝わることは重要です。広告や検索のためだけではなく、読者が自分で見て理解できる入口にする必要がありました。
Codexに任せたこと
Codexには、トップページの実ファイルを確認させ、H1直下や主要カード一覧の前にguideを追加できる位置を探してもらいました。ページ本体に長文を直接増やしすぎず、可能なら専用partsとして追加する方針です。
また、追加リンク先が200 OKか、既存カードやランキングが壊れていないか、title、description、H1、canonical、robotsが維持されているかを確認させました。トップページの補強では、本文追加と同じくらい既存要素の維持が重要です。
- トップページの実ファイルを確認する
- H1付近またはカード一覧前の追加位置を確認する
- サイトの役割を説明するguideを作成する
- カテゴリやランキングの見方を説明する
- 重要ページへの導線を整理する
- 追加リンク先のHTTP 200を確認する
- 既存カードやランキング表示を維持する
- title、description、H1、canonical、robotsを維持する
- PCとスマホ表示を確認する
人間が判断したこと
人間側で判断したのは、トップページを先に母艦化することです。奥のページを増やす前に、トップがサイト全体の案内板になっていないと、読者がどこへ進めばよいか分かりません。
また、Search Consoleの反応待ちを理由に止めず、まず人間が読んで分かるトップにする方針にしました。計測を見ることは大切ですが、トップがリンク集に見える状態を放置して待つだけでは、構造改善は進みません。
説明の量も人間が判断しました。トップページにすべてを書きすぎると重くなるため、サイトの役割、探し方、主要導線に絞り、詳細は下層ページへ任せる構成にしました。
実際に使った指示文の考え方
指示文では、「トップページを良くして」ではなく、「トップページをサイト全体の案内板として補強してください」と伝えました。何を追加するかを明確にしないと、カード追加や装飾変更に寄りやすくなります。
触らない範囲も明確にします。DB、カード部品、共通header/footer、広告タグ、Search Console確認タグ、robots.txt、ads.txtには触らない条件を入れました。トップページは影響が大きいため、既存の動作を保つことが重要です。
確認項目も具体化しました。トップページの200 OK、追加guideの表示、リンク先200 OK、titleやcanonicalの維持、PC/スマホ表示、未作成URLなしを報告させることで、補強後の公開状態を確認できます。
うまくいった点
うまくいった点は、トップページに「このサイトで何ができるか」が入ったことで、カードやランキングの意味が伝わりやすくなったことです。読者は、カードを見る前にサイト全体の見方を理解できます。
また、重要ページへの導線を自然に置けるようになりました。内部リンクはただ増やすのではなく、サイトの案内文の中で「次に見るページ」として置くと、読者にとっても自然です。
静的guideとして追加したことで、DBやランキング集計処理を触らずにトップページの役割を強められました。重い変更を避けながら、ページの意味づけを増やせた点が成果です。
詰まった点・危なかった点
危なかった点は、トップページに説明を増やしすぎることです。案内板にしたいからといって、下層ページの内容まで全部書くと、トップが長すぎて読みにくくなります。
もう一つの危険は、重要ページへ無理に大量リンクすることです。内部リンクは多ければよいわけではありません。読者の流れに合う導線だけを入れ、関係の薄いリンクは入れない判断が必要です。
また、トップページのSEOタグや確認タグを意図せず変えるリスクもあります。本文を追加するだけの作業でも、テンプレートを触るとtitle、canonical、広告タグに影響する場合があるため、作業後の確認が欠かせません。
作業後に確認したこと
作業後は、トップページがHTTP 200で表示されることを確認しました。次に、追加したguideがH1付近またはカード一覧前に表示されているかを確認しました。
追加リンク先がすべて200 OKかも確認しました。案内板としてリンクを置いても、リンク先が404では逆効果です。未作成URLや文脈に合わないURLを追加していないかも見ます。
最後に、title、description、H1、canonical、robots、noindexなし、CSS読み込み、PC/スマホ表示、既存カードやランキングの維持を確認しました。トップページの補強は、既存要素を壊していないことまで確認して完了です。
- トップページがHTTP 200
- guideがH1付近またはカード一覧前に表示されている
- サイトの役割が説明されている
- カテゴリやランキングの見方が説明されている
- 重要ページへのリンクがある
- 追加リンク先が200 OK
- 未作成URLを追加していない
- title、description、H1を変更していない
- canonical、robotsを維持している
- 既存カードやランキングが壊れていない
- PCとスマホで大きく崩れていない
次から使える指示文テンプレート
次回トップページを案内板化する時は、カード追加ではなく、サイトの役割と読み方を追加する指示にします。
以下の公開中サイトで、トップページを単なるリンク集ではなくサイト全体の案内板として補強してください。
H1直下または主要カード一覧の前に、サイトの役割、読者ができること、カテゴリやランキングの使い方、重要ページへの導線を説明する静的guide partsを追加してください。
title、description、H1、canonical、robotsは変更しないでください。DB、カード部品、共通header/footer、広告タグ、Search Console確認タグは触らないでください。
追加リンク先はすべて200 OKを確認し、未作成URLや404リンクは追加しないでください。作業後に、トップページの200 OK、guide表示、内部リンク、PC/スマホ表示、既存カード維持を報告してください。確認チェックリスト
トップページのチェックでは、本文の追加だけでなく、入口として読めるか、既存導線を壊していないかを確認します。
- トップページがHTTP 200
- サイトの役割が説明されている
- 読者ができることが書かれている
- カテゴリやランキングの見方がある
- 重要ページへの導線がある
- 追加リンク先が200 OK
- 未作成URLを追加していない
- 既存カードやランキングが維持されている
- title、description、H1を変更していない
- canonicalとrobotsを維持している
- スマホ表示で大きく崩れていない
まとめ
トップページは、サイト全体の案内板です。カードやランキングが並んでいても、何をどう見ればよいかが分からなければ、入口としての役割は弱くなります。
Codexに任せる時は、カードを増やすのではなく、サイトの役割、探し方、重要ページへの導線を追加する作業として依頼すると安全です。触らないタグやファイルを指定し、追加リンク先の200 OKまで確認します。
人間が判断するのは、どこまでトップで説明し、どこから下層ページへ任せるかです。トップは詳しすぎても弱く、薄すぎても弱い。読者が次に進める案内板として設計することが大切です。
注意書き
この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。
同じ作業でも、サイト構成、公開環境、利用しているテンプレート、GitHub運用の有無によって確認すべき点は変わります。実作業の前には、対象ファイル、触らないファイル、停止条件、確認項目を決めたうえで進めてください。