Codexでカード一覧をランキング化する時の完了条件

今回やった作業

カード一覧に順位バッジを付けるだけでは、ランキングページとしてはまだ弱い場合があります。順位、指標、並び順、比較材料、内部導線まで揃えて完了条件を決めます。

今回の作業では、ランキング型サイトの見た目だけを整えるのではなく、ランキングとして成立する根拠を確認することを優先しました。カード一覧、順位表示、指標、並び順、内部導線を分けて確認し、Codexへの指示も「見た目を直して」ではなく、完了条件を確認する形にしました。

作業前の状態

作業前は、カードが並び、ランキング風に見せたい意図はありました。しかし、順位だけを追加しても、何を基準にしているのか、読者がどの情報を比較すればよいのか、内部詳細ページへ進めるのかが十分に伝わらない状態でした。

この段階で重要だったのは、画面に出ている見た目と、裏側で実際に行われている並び替えや表示条件を分けて考えることです。見た目だけがランキング風でも、データの根拠や内部リンクが弱い場合、読者が比較できるページにはなりません。

作業前に問題だったこと

「ランキング風」と「ランキングとして成立」は違います。カード一覧に番号を付けても、順位を決める指標、指標に基づく並び順、比較材料、詳しく確認できる内部導線がないと、ランキングページとしての役割が弱くなります。

ランキング改善では、カードを大きくしたり、色を付けたり、順位バッジを足したりする前に、何を基準に順位が決まっているかを見る必要があります。ここを飛ばすと、Codexの作業報告では完了しているように見えても、実画面では根拠が伝わらない状態になります。

Codexに任せたこと

Codexには、カード一覧の現在構造、順位表示の有無、順位指標の有無、内部詳細ページへのリンク、外部リンクとの役割分離、公開HTML、実画面を確認させました。単にCSSを足すのではなく、完了条件を満たしているかを確認させた点が重要です。

Codexには、修正そのものだけではなく、調査と確認も任せます。対象ファイル、公開HTML、表示文言、内部リンク、既存のcanonicalやrobotsを確認させることで、余計なファイルに触らず、必要な範囲だけを見られるようにします。

人間が判断したこと

人間側では、順位だけでは完了にしないこと、指標が見えない場合はランキングとして弱いこと、外部リンクが主導線になりすぎるとサイト内比較が弱くなることを判断しました。

Codexはファイルや表示を確認できますが、どの表現を使うべきか、どこまでをランキングと呼ぶべきか、読者に誤解を与えないかは人間が判断します。ランキング表現は便利なぶん、指標や並び順と一致しているかを人間側でも見ます。

実際に使った指示文の考え方

Codexへの指示では、見た目改善ではなく完了条件を渡します。順位、指標、並び順、比較材料、内部詳細ページへの導線を確認し、不足がある場合は何が足りないかを報告させます。

指示文では、やることだけでなく、やらないことも明記します。DB構造、cron、.htaccess、robots.txt、ads.txt、広告タグ、Search Console確認タグは触らないと書くことで、ランキング表示の調整が不要な範囲へ広がらないようにします。

うまくいった点

完了条件を先に定義したことで、Codexの作業が見た目だけに寄りすぎるのを防げました。ランキングページとして成立しているかを、人間が確認しやすい項目に分解できた点も有効でした。

作業を完了条件に分解したことで、Codexの報告を確認しやすくなりました。順位、指標、並び順、公開HTML、実画面確認のように項目を分けると、どこまでできていて、どこが未確認なのかが見えやすくなります。

詰まった点・危なかった点

危なかったのは、順位バッジを追加しただけで完了扱いにすることです。見た目はランキング風でも、指標や内部導線がなければ、読者が比較できないカード一覧のままになります。

• 見た目だけを先に変える
• 順位や指標の根拠を確認しない
• 公開HTMLを見ずに完了扱いにする
• canonicalやrobotsを不用意に触る
• 内部リンクのクリック先を確認しない

ランキング系の作業は、見た目の変化が分かりやすいため、ついCSSやカード装飾から入りがちです。しかし、根拠や指標がないまま装飾すると、ページの説明力は上がりません。

作業後に確認したこと

作業後は、公開HTMLと実画面で、順位、順位指標、比較材料、内部詳細ページへのリンクが確認できるかを見ます。さらに外部リンクが補助導線として残っているか、主導線になりすぎていないかも確認します。

さらに、対象ページが200 OKであること、CSSが読めていること、Fatal errorや500がないこと、スマホ表示で大きく崩れていないこと、内部リンクが404になっていないことも確認します。記事化する場合は、実ドメイン名や内部情報を出さないように一般化します。

次から使える指示文テンプレート

以下は、同じ種類のランキング改善をCodexへ依頼する時に使えるテンプレートです。

以下の公開中サイトで、カード一覧をランキングページとして成立させるための確認をしてください。
順位バッジを追加するだけで完了にしないでください。
ランキングとして成立する条件は、順位、順位を決める指標、その指標に基づく並び順、比較材料、内部詳細ページへの導線です。
現在のカード構造、表示指標、内部リンク、外部リンク、公開HTML、実画面を確認してください。
完了条件を満たしていない場合は、何が不足しているかを報告してください。

確認チェックリスト

作業後は、見た目だけでなくランキングとして成立しているかを確認します。

• 順位がある
• 指標がある
• 指標順に並んでいる
• 比較材料がある
• 内部詳細ページへ進める
• 外部リンクが主導線になりすぎていない
• 公開HTMLで確認した
• 実画面で確認した
• 完了条件を満たしている

関連する使い方ガイド

注意書き

この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。

ランキング型サイトの改善では、表示文言、指標、並び順、内部導線が一致しているかを確認することが重要です。Codexに任せる場合も、作業範囲と停止条件を先に決めてから進めます。