2026年7月26日の開発日記

三日前、確認画面の直前で自分の判断として本番切替を止めた。移行先の完成度が足りないという理由だった。今日はその足りない分を朝のうちに埋めて、DNSを切り替えた。203記事すべてが200を返し、301のルールも13本そろって動いた。ここまでは順調だったと思う。ところが旧カテゴリ階層のURLに末尾スラッシュを足した瞬間、404が返ってきた。

今日のタイムライン

今日やったこと

1. WordPressサイトの本番DNS切替

会社サイトのDNSを移行先へ向け、切替直後に総当たりで検証した。記事の全件200、301ルール13本、旧形式のクエリURL 210件、画像の枚数、robots.txtとサイトマップ、下書き記事が露出していないこと。検索コンソールにもサイトマップを出し直した。上位10ページの表示確認まではすんなり通った。

そこから全222ページの突き合わせに進もうとして管理画面が反応しなくなり、URLの体系側から攻める方向に切り替えたところで末尾スラッシュの穴が出てきた。ローカルで再現させて直し、デプロイし直している。

主な成果:

• 本番DNSの切替と、切替直後の総当たり検証
• 旧カテゴリ階層URLの末尾スラッシュで404になる不具合の発見と修正
• 1週間・2週間・1ヶ月で何を見るかのモニタリング方針を台帳に追記

詳細: WordPressサイトの本番DNS切替と、移行後に見つかった301の穴

2. 切替前のサイト仕上げ

切替の前にローカルで全ページを見て回った。コンセプトページの画像が出ないのは移行データの欠損だと思い込んでいたが、実際は現行サイトでは表示されていて、ローカルだけが404を返していた。参照側8か所を置き換えて解決した。

お問い合わせフォームはメール送信まで本番で一周させた。二通目から日本語が壊れたのは、壊れたのが差し込み値だけでテンプレート文言は無事だったことから、ターミナルから送ったときの文字コードが原因だと切り分けられた。フォーム本体は無傷だった。

トップページは記事一覧と役割が重なっていて気持ち悪かったので作り直した。記事の中で作ったアニメーションをその場で再生させ、原書コンテンツをスライドで見せる。小さすぎて中身が読めなかったので、モーダルで拡大してページ送りできるようにした。

主な成果:

• 画像が出ない原因の切り分けと修正
• お問い合わせメールの文字化けの原因特定
• トップページの作り直しとフッター追加、コンセプトページの1カラム化

詳細: 本番切替の前に移行先サイトを仕上げた日

3. 計画書の判断をボタンで返す仕組み

サイト全体のタイトルとディスクリプションは、これまで我流で書いてきた。一貫性も狙いもない。203記事のメタ情報をまとめてレビューさせたら、同じ意味の定型句が27種類に分裂していた。

改善計画はできたが、判断が必要な項目が4件残った。ターミナルの選択肢UIだと、何を聞かれているかの前提が読めないまま選ぶことになる。そこで計画書のHTMLの中に3択ボタンを埋め込み、前提を読んだ流れでそのまま押せるようにした。選択肢に収まらない条件は自由記述欄から返ってきて、これが実際に効いた。

主な成果:

• 203記事のメタ情報レビューと改善計画の作成
• 計画書HTMLに3択ボタンを埋める決裁フォームの実装
• この運用を全プロジェクト共通のルールへ昇格

詳細: 計画書の中で判断を返す — ターミナルの選択肢をやめてHTMLに3択ボタンを埋めた

4. コンピュータのしくみ講座を触れるものにする

前日の仕掛かりを調べさせたら、12本のプルリクエストが宙に浮いていた。12体のエージェントを並列で走らせてレビューさせ、要修正3本・マージ可9本に仕分けた。正解の位置が周期的に偏る問題と、図解の座標が重なっている箇所が出てきた。

トップページでは講座が学習クイズの中に散らばっていたので、1つのカテゴリにまとめ、あいだに一覧ページを挟んで3階層にした。中身がテキストと図ばかりだった全18講には、既存の教材から転用できるものを洗い出させて触れるシミュレーターを入れた。

主な成果:

• 宙に浮いていた12本のPRのレビューとマージ
• トップページのカテゴリ集約と一覧ページの新設、パンくずの修正
• 全18講へのシミュレーター投入（公開は翌日に持ち越し）

詳細: 全18講に触って動くシミュレーターを入れた日

5. インタラクティブ教材の集約と本文の整理

翻訳記事に埋め込んだ15個の教材をブラウザで全部動かし、元記事と突き合わせさせた。原文とずれていたものが3件、原文にあって教材に入っていなかったものが3件見つかった。体験だけを集めた一覧ページを新しく作り、シミュレーターの一覧にもテーマ別の見出しで追加分を並べた。

本文の文字がグレーで薄く、意味のない枠線が多くて読みづらかったので、黒に戻して枠を落とした。背景のグレーだけ残している。数週間前に変換した記事を内容の記憶だけで特定させ、そこで表示されていなかった画像10枚が外部への直リンクだったことも分かった。ダウンロードして記事ディレクトリに置き、出典URLを添える形にした。

主な成果:

• 教材15個の表示レビューと原文との整合（ずれ3件・不足3件を修正）
• 体験だけを集めたページの新設と、一覧のテーマ別再編
• 本文のタイポグラフィ整理と、外部直リンク画像のローカル引き取り

詳細: インタラクティブ教材を1枚に集約し、本文の線を減らした日

6. 語源英単語コースの手触りと、設定のDB保存

矢印キーでページを移動したときに音声をどう鳴らすかを、チェックボックス2つで4パターンから選べるようにした。単語だけか、例文も鳴らすか、その両方か。

英単語を間違えたときにだけ例文と情景画像を出すようにもした。間違えるということは、その語のイメージがついていないということだ。だったら画像でイメージを立ててやればいい、という仮説である。誤答表示から「不正解」の3文字も消した。×が赤くなっていれば分かる。

設定はブラウザに保存されるだけだったので、ログイン済みユーザーごとにデータベースへ持たせる形に移した。計画を立ててからレビューを4往復させ、別ブラウザで同じ設定が戻るところまで確かめている。

主な成果:

• 矢印キー移動時の音声再生をチェックボックスで選択可能に
• 誤答時だけ例文と情景画像を出す仕組み、誤答表示の視認性改善
• 設定のユーザー別DB保存（計画・レビュー4往復・実装・別ブラウザでの復元確認）

詳細: 語源英単語コースの手触りを直した一日

7. 手持ちサイトの棚卸し

口頭で説明できたのは4サイトだった。並列で調べさせたら、業種別のランディングページ群と画像配信用のサブドメインが出てきて、公開ドメインは合計15あった。

旧PaaSで動かしているアプリを静的化して別の基盤へ移す案が出たとき、「統合は考えていない」と即答した。その数分後、そのアプリを別サイトへ統合する構想を自分が2月に書いていたことを思い出して、前提を訂正することになった。それでも独立したまま残す判断は変えていない。

棚卸しでは実害も出てきた。トップページのリンク切れ3本が1ヶ月半放置されていて、しかもビルドログは成功と出ていた。

主な成果:

• リポジトリと公開ドメインの対応の棚卸し（把握していた4→実際は15）
• 旧PaaSアプリの扱いについて、過去の構想を踏まえた前提の訂正
• リンク切れ・メタ情報欠落・サイトマップ不在などの実害の洗い出し

詳細: 把握していたのは4サイト、実際は15ドメイン

8. Notionアーカイブの実物照合

10日分のコミットが宙に浮いていたので片付けた。プッシュを投げながら、ローカルの整合はNotion側の完全性を証明しないと引っかかって、ブラウザの実物と突き合わせる工程を足した。

一覧を取る経路が見つからず、画面のDOMから列挙する形に切り替えた。欠落に見えた49件のうち48件は、そもそもMarkdownを持たない設計のビューブロックだった。取得そのものはほぼ完全で、落ちていたのは変換側のテーブルとページプロパティだと分かった。

主な成果:

• 10日分の未コミット（8,718ファイル）の整理とプッシュ
• 完了報告を信じず、ブラウザの実物と突き合わせた照合
• 落ちているのは取得側ではなく変換側だという切り分け

詳細: 「本当に全部終わったのか」を疑ってNotionアーカイブを実物照合した日

今日の試行錯誤

今日の学び

• 全件200が返ってきても、URLのパターンを1つ見落としていれば穴は残る。記事本体だけでなく、末尾スラッシュのような形の違いまで含めて総当たりする必要がある
• 何かが表示されないとき、まず疑うべきは「データが欠けている」ではなく「どの環境で見ているか」。現行サイトで出ているならデータは無事で、壊れているのは手元の設定である
• 判断を求めるUIは、選択肢そのものより「前提が同じ画面にあるか」で使いやすさが決まる。読んだ流れでそのまま押せる位置にボタンがあるかどうか
• 並列で派遣するエージェントの数には上限がある。多く出せば速いわけではなく、全滅すると取り返しに時間を取られる
• 完了報告はディスクの中を見ているだけかもしれない。別の経路で実物と突き合わせるまでは、終わったとは言えない
• 自分が過去に書いた構想は忘れる。「統合は考えていない」と即答した数分後に、統合構想を自分で書いていたことを思い出した

明日やること

• コンピュータのしくみ講座の残件を公開まで持っていく
• サイト棚卸しの未決の論点5つに方針を出す（再開は計画書をブラウザで開くところから）
• Notionアーカイブの変換側を直し、テーブルとページプロパティを拾えるようにする
• 語源英単語の誤答語の復習ページ

関連記事

• WordPressサイトの本番DNS切替と、移行後に見つかった301の穴
• 本番切替の前に移行先サイトを仕上げた日
• 計画書の中で判断を返す — ターミナルの選択肢をやめてHTMLに3択ボタンを埋めた
• 全18講に触って動くシミュレーターを入れた日
• インタラクティブ教材を1枚に集約し、本文の線を減らした日
• 語源英単語コースの手触りを直した一日
• 把握していたのは4サイト、実際は15ドメイン
• 「本当に全部終わったのか」を疑ってNotionアーカイブを実物照合した日