# ガイド追加・LOG518 移転のレビュー

レビュー日：2026-11-15

## 対象と検証範囲

`codex_review_request.md` の A1〜C2 に従い、`guide.diff` と同梱の `p2m-site/` を確認した。依頼書の対象は `0797043` だが、同梱リポジトリの HEAD は `c830133`（浅い履歴）だった。本報告は差分の変更意図と、実際に同梱されたソースの組み合わせに対する評価であり、`0797043` 単独の検証ではない。

書き込みは本報告のみ。依存関係のインストール、ビルド、プレビュー、デプロイは実施していない（同梱ソースに node_modules・dist がなく、これらの操作は報告以外のファイルを生成するため）。HTML の実生成、画面表示、Cloudflare 実環境での応答は未検証。以下ではコードで確認した結果と、設定・公式仕様からの推定を区別する。

## A1. 転送：要修正（P2：旧 HTML の別名が漏れている）

対象：`p2m-site/worker/index.js:86–88` の `MOVED`。

指定された以下の3形は正しい。転送先はすべて `/guide/generalist-ai-gen-1-5` で、クエリ文字列をそのまま引き継ぐ。

| 旧パス（旧 slug を S と略記） | 結果 |
| --- | --- |
| `/record/S` | 301 → ガイド |
| `/record/S/` | 301 → ガイド |
| `/record/S.md` | 301 → ガイドの HTML |

実際の Worker ソースを読み、import だけをメモリ上で除いて Node の VM で fetch ハンドラーを実行した。3形 × クエリ有無 × GET／HEAD の12ケースで、301・Location・静的アセット未呼び出しを確認した。転送先そのもの、`/record/day126`、旧 slug に `-other` を足した住所にはこの転送が適用されず、ループや前方一致による巻き込みはない。`run_worker_first` の対象にも `/record/` が含まれる。

**修正点：旧ページが存在したときに有効だった HTML の別名も、明示的に転送する。** Astro は `build.format: 'file'` なので旧記事は `record/S.html` に出力される。Cloudflare の `auto-trailing-slash` は、このファイルがあれば `/record/S.html`、`/record/S/index`、`/record/S/index.html` も正規パスへ案内する。しかし移転後は元ファイルがなく、これらは `MOVED` にもない。Worker が ASSETS に渡すことは実行確認済みで、そこから旧記事を復元できず404になると設定・仕様から判断する。実際にこの別名への外部リンクがあるかは未確認。

直し方：上記3つの完全一致キーを `MOVED` に足し、同じガイドへ301で直接送る。任意の拡張子や旧 slug で始まる住所を一括置換する必要はない。`.md/` は今回指定された全文ページの正規形ではなく、これも必須対応とはしない。

根拠：[Cloudflare HTML handling の対応表](https://developers.cloudflare.com/workers/static-assets/routing/advanced/html-handling/)。元の HTML アセットを取り除いた後も、以前の自動正規化だけで救済されるとは考えないこと。

## A2. 301 の選択：OK

記録からガイドへの恒久移転なので301でよい。公開当日であることや、2027年1月の SNS 予約本文に旧 URL があることは、一時転送にする理由にはならない。予約の旧 URL も転送で新記事に届く。

ただし移転後に301を撤去しないこと。予約投稿後にリンクを開く人もいるため、今回の転送は恒久的に残す運用が適切。検索向けにも Google は恒久転送を推奨し、転送は一般に少なくとも1年間保持するよう案内している。[Google の URL 変更を伴う移転の説明](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes)

SNS 予約本文や各サービスに保存済みのプレビュー画像は同梱資料にはなく、確認していない。今後予約を編集する際はガイドの URL にそろえるとよいが、予約の一括修正は公開の必須条件ではない。

## A3. 記録から除外した影響：OK（A1 の別名対応を除く）

- **記録一覧・前後の記事：** `allCards()` は records コレクションと `src/data/cards.json` から再計算する。旧 LOG518 の Markdown はなく、Studio 側の cards と記事 JSON にも同じ slug はなかった。固定の配列位置や LOG の連番で前後を決めていないため、残った同シリーズの記事同士につながる。
- **LOG518 のリンク：** `LOG517.md:17` の明示的な旧 URL リンクは301で救済される。公開ファイル `public/files/LOG517/LOG517_full.md` にある同じリンクも同様。LOG517 の過去の実行ログや説明に出る旧住所は、当時の記録として残してよい。
- **番号からの自動リンク：** `linkLogsHtml()` の番号表は `allCards()` のみを使うので、移転後の LOG518 は番号表から消える。`former_log: 518` は現状どこでも番号解決に使われていない。ただし現在の同梱記事では、裸の LOG518 の言及は LOG517 にあり、その前に明示リンクが置かれている。従来も同じ記事の2回目以降は自動リンクしないため、ここに新たなリンク切れは見つからなかった。将来ほかの記事で LOG518 を自動リンクしたい場合は、ガイドを記録一覧へ戻すのではなく、旧番号のリンク解決を別に設ける。
- **updates.json：** 最新10件の記録を `allCards()` から作るため LOG518 は外れる。配列は残りの記録で埋まり、消えた記事を指す新規項目は生成しない。ガイドの公開・更新は通知対象に追加されていないが、今回の依頼にはガイド通知の要件はない。
- **sitemap：** Astro のページルートから生成する構成で、ガイドの一覧と詳細が対象になる。旧 slug の記録ルートの生成元はなくなる。実際の XML はビルド未実施のため未確認。
- **全文ページ：** `/record/S.md` の静的生成元もなくなるが、Worker の301が先に動く。ガイドに `.md` を作らず HTML へ送るのは依頼どおり。
- **llms.txt／HTML版 llms：** 共通の `guideSections()` に `allGuides()` の節が追加され、記録一覧からは LOG518 が外れる。ガイドに存在しない全文 `.md` のリンクも追加していない。
- **サムネイル・OG・図解：** `public/thumbs/LOG518.html`、`public/og/LOG518.jpg`、`public/embeds/LOG518_gen_progress.html` は存在する。ガイドの `thumb` と OG のパス変換は旧アセットを引き続き参照する。LOG 番号をページに付けないために、これらのファイルまで削除・改名する必要はない。図解の高さ調整は Base 側にあるのでガイドにも適用される。

## B1. 「続き」の帯：OK

対象：`src/pages/record/[slug].astro:112–120,186`。

`day126` の値は実在するガイドの href と一致する。ガイドが見つかれば `contCard` を作り、帯のリンクは `nowCard.href`、表示は「ガイド＋題名」になる。

既存の記録 slug を指定した場合は従来どおり `allCards()` で検索し、href がないので `/record/${nowCard.slug}` にフォールバックする。優先順位も「明示的な続き → シリーズの最新 → サイト全体の最新」のまま。英語記事を除外する条件、60日の判定、計測名も維持されている。不明なガイドを指定しても不正な `/record//guide/...` を出さず、既存の最新記事案内へ戻る。

## B2. CSS の共通化：OK（ソース確認の範囲）

`guide.diff` から抽出した旧 `<style is:global>` と、同梱の `src/styles/record.css` を比較した。コメントと空白を除くと内容は完全一致し、メディアクエリと宣言の順序も保たれている。元からグローバル指定だったため、CSS ファイルへの移動で初めてスコープが外れる問題はない。

読み込みの経路は Astro の style タグから CSS import に変わるので、「出力順まで不変」とは断言できない。Base や RecordCard など、記事と併用される部品の CSS も確認し、今回の移動で結果が変わる同詳細度の競合は見つからなかった。`/_astro/*` の静的アセット経路も対象外設定のまま利用できる。[Astro の CSS 優先順位の説明](https://docs.astro.build/en/guides/styling/#cascading-order)

画面・生成 CSS の確認は未実施。公開用ビルドで、旧記事の PC／スマートフォン表示と、CSS アセットの取得を確認すると、この残る検証範囲を埋められる。

## C1. ガイドの SEO 情報：OK

対象：`src/pages/guide/[slug].astro`、`src/pages/guide/index.astro`、`src/layouts/Base.astro`。

詳細の title は記事題名＋サイト名で、旧 LOG518 をタイトルに付加していない。canonical と og:url、Article の url／mainEntityOfPage、パンくずの最終項目は、いずれも新しい `/guide/{slug}` に一致する。Article の公開日・更新日はコレクションの値を ISO 形式にしており、著者・発行者・日本語指定もある。LOG518 の OG 画像も存在確認済み。

一覧は `/guide` の canonical と CollectionPage を使い、hasPart の各 URL は `allGuides()` の href を使う。既存の `/gpu-buy-or-rent` を無理に `/guide/` 配下へ置き換えていない点も正しい。`build.format: 'file'` と Cloudflare の末尾スラッシュ正規化も、末尾スラッシュなしの canonical と整合する構成。

これはテンプレートとデータの整合性の判定であり、ビルド後の構造化データ検証や検索結果への表示保証ではない。

## C2. その他・公開後に戻しにくい問題：OK（A1 の修正を前提）

追加で公開を止める問題は見つからなかった。恒久移転先と旧 URL の対応は、SNS の予約投稿後も維持すること。本文を改訂するときもガイドの slug は固定し、updated を更新する運用なら今回の設計に合う。

なお `guide.diff` には、参照する新しい `record.css` 自体や記事の移動内容が含まれていないため、差分だけでは変更一式を再現できない。同梱ソースには必要ファイルが存在することを確認した。公開する実際のコミットにもそれらを含めること。本報告は依頼書記載コミットとの一致やビルド成功を証明するものではない。

直してから公開
