2026年7月24日の開発日記

朝いちばんに聞いたのは「昨日の積み残し、何かありましたっけ」だった。答えはすぐ出た。ただ、一緒に困ったことも出てきた。前日に作ったはずの機能の経緯が、コミットにもメモにもどこにも残っていない。やった実感だけが手元にある。

そこから動き出して、日が暮れるまでに教材が3本増え、挿絵が1,000枚以上生成され、移行サイトの目次が作り直された。ただ、あとから振り返って印象に残ったのは、作った量のほうではなかった。この日は「やめておく」と決めた場面が三度あって、そのどれもが結果として正解だった。

今日のタイムライン

今日やったこと

1. コンピュータの原理を扱う教材を、1日で3講分積み上げた

前日の積み残し1本をコミットするところから始まり、続けて2本目の教材化まで未明に片づけた。そこで手を止めて、残り全章のロードマップを作らせ、章ごとに手作業を繰り返す前に共通基盤へのリファクタを挟んだ。この寄り道が効いた。以降は「計画書 → Codexレビュー → データ・図解・ページの3並列 → 検証 → コミット」という同じ型で流せるようになり、第3講・第4講・第5講が同じ日のうちに積み上がった。

主な成果:

• 第3講（10進法は絶対じゃない、演習26問）を13時、第4講（ビットの正体、演習25問）を16時、第5講（論理とブール代数、演習20問）を19時にコミット
• 学習コース共通基盤を新設し、既存2コースを移行
• セッションは1日で3回切り替え、そのたびに引き継ぎプロンプトでつないだ
• 学習ゲートは2回スキップした（1回はその場の判断、1回はクイズ無回答のタイムアウト）

詳細: コンピュータの原理を教材化する学習コースを1日で3講分作った

2. 語源英単語コースの挿絵を、全語洗い直しにかけた

例文と挿絵が噛み合っていない。その違和感の出どころを掘っていくと、最初に数千語を一気に生成したときのプロンプトに「人物を描写しない」という制約を入れていたことに行き当たった。人を描けない分、絵は行為や感情を物や図形の比喩に置き換え、意味の通らない構図を量産していた。洗い直しの対象は最終的に1,724語。仕分けにかけた2,418語の7割強で、コース全体の4,000語で見ても4割強にあたる。

主な成果:

• 消えていた画像159枚をR2から復元（削除して構わない生成物だと思い込んでいたが、残す約束をしていた141語分が丸ごと含まれていた）
• 「R2に反映されていない」と見えた3枚が、読み出しコマンド側の異常だったと切り分け。書き込みは最初から111/111成功していた
• 例文不一致340語（Round4）を設計図から書き直して本番反映
• 抽象・境界の1,384語（Round5）は並列20で着手し、1,576枚中1,037枚（66%）まで進めて夜間体制に切替

詳細: 語源英単語コースの挿絵を全語洗い直しした記録

3. WordPress移行サイトのカテゴリとナビを作り直した

移行済みの記事は200本を超えていた。それでもカテゴリページを開くと、記事が日付順に積まれているだけで、ひとまとまりの目次に見えない。旧サイトの同じカテゴリには30本近い記事が整理されて並んでいるのに、移行先では粗い分類に埋もれていた。

主な成果:

• WordPressのカテゴリDBから機械的に組み直したが、本番トップの三段階の枠組みはDBのどこにもなく、HTMLの中にしか存在しなかったと判明。本番構造を洗い直して作り直し
• 9トピック28記事のタイトルを内容ベースで判断させ、25個のサブグループに再設計（「その他」落ちゼロを確認）
• 長いタイトルで崩れていた横3列を、1トピック全幅の縦積みに変更
• 本番と同じ8項目のヘッダーナビとロゴを移植
• 書籍紹介は専用ページではなくホームページ下部へ置き直し

詳細: WordPress移行サイトのカテゴリとナビゲーションを作り直した一日

4. 本番切替を確認画面の直前で止め、旧サーバーの畳み方を決めた

知人から届いた旧サーバーの保守提案を、そのまま受けるのではなく自分で裏取りした。PHPのサポート期限切れもバックアップ不在も、指摘はいずれも事実だった。手動バックアップを取ろうとした段で管理者権限が手元にないことに気づき、起動プロセス経由の復旧を別のCLIに委譲して権限を取り戻した。

そのうえで、恒久的な保守契約ではなく「一括でバックアップを取って畳む」方針に決めた。近く退役させるサーバーだからだ。同じ日、移行先への本番切替がDNS変更の確認画面まで到達したが、移行先のトップページが挨拶文だけで記事一覧を持っていないことに気づいて中止した。

主な成果:

• 保守提案の指摘内容を一次情報で検証し、方針を「契約」ではなく「退役」に確定
• 本体とDBの手動バックアップを取得し、ハッシュ照合とアーカイブ整合性まで検証
• 切替は中止したが、現行設定値・到達した手順・ロールバック手順は文書に残した
• 「トップページに全記事のインデックスを作る」が切替再開の前提条件として確定

詳細: WordPress本番切替を土壇場で止め、旧サーバーの畳み方を決めた

5. 画像が出ないバグを追ったら、ビルド除外の設計に行き着いた

ローカル専用の記事を開くと、本文は読めるのに画像が31枚とも真っ白だった。devサーバーを再起動しかけて止め、そのまま調べさせると、犯人は配信ミドルウェアのアクセス制御だった。getRequestIP がプロキシ経由のヘッダーを見ない設定で呼ばれていて、IPが取れず、ローカルホスト判定が常に外れ、常に404を返していた。

直したあと、話は「そもそもこの仕組みはいるのか」に転がった。既存の非公開記事の一覧と照らし合わせると、既存の仕組みは本番から消すだけでリポジトリには残す。今回の記事は機密情報が写り込んでいて、中間データにも残したくない。守る対象の重さが違うとわかって、追加実装は残すことにした。

主な成果:

• getRequestIP(event, { xForwardedFor: true }) への修正で31枚とも200を確認
• _local-unpublished が触る5箇所を洗い出し、.gitignore の1行で記事も画像も一度もGit管理に入っていないことを確認
• 溜まっていた未コミットの変更を意味の単位で7本に分けてコミット
• 決算データ取得バッチのレート制限対策（71銘柄一括 → 12銘柄チャンク＋バックオフ）で71/71成功

詳細: Nuxtで画像が表示されないバグを追ったら、ビルド除外の設計に行き着いた

6. M&A案件から事業アイディアを棚卸しした

売り案件サイトを調べさせ、自分の開発資産と突き合わせて事業アイディアを検討メモにまとめた。価格や収益の記述は検証エージェントにソースページを再取得させて裏取りさせている。内容が内容なので非公開扱いにしてあり、ここには書かない。

今日の試行錯誤

今日の学び

• 大量に流す前に、100件だけ見る。 挿絵のプロンプト制約も、カテゴリの機械分類も、小さく検収してから広げていれば、この日1日分の作業がまるごと要らなかった。同じ失敗を別のプロジェクトで同じ日に踏んでいる
• 「反映されていない」と「読めていない」は別の話。 対象を疑う前に、見ている側の道具を疑う番があった
• 消す前に確かめる。 いらないと思った実装は、既存の仕組みと守る対象の重さが違っただけだった。疑いを晴らすのに使った時間のほうが、バグを直す時間より長い
• 記録がないと、自分がやったことすら思い出せない。 前日に作った機能の経緯が残っておらず、実機を開いて確かめ直すところから朝が始まった
• 止める判断は、進める判断と同じだけ仕事をしている。 削除を止め、切替を止め、レート制限を使い切るのを止めた。三つとも、進めていたら取り返しがつかないか、無駄に終わっていた

明日やること

• Round5 の残り539枚（週次レート制限の回復待ち）
• 移行先サイトのトップページに全記事インデックスを実装（本番切替の前提条件）
• 教材化シリーズの第6講

関連記事

• コンピュータの原理を教材化する学習コースを1日で3講分作った
• 語源英単語コースの挿絵を全語洗い直しした記録
• WordPress移行サイトのカテゴリとナビゲーションを作り直した一日
• WordPress本番切替を土壇場で止め、旧サーバーの畳み方を決めた
• Nuxtで画像が表示されないバグを追ったら、ビルド除外の設計に行き着いた