2026年5月15日の開発日記
朝6時から動き始めて、都道府県クイズの統計編12ページ（合計89問）と地図クイズ4種（by-prefecture / find-prefecture / 地形図モード / study-map）を1日で組み上げた。途中で「神経衰弱」を作らせたら却下されて全削除、ずんだもん音声を VOICEVOX 直接呼び出しから事前生成 MP3 + Cloudflare R2 配信に切り替え、Codex のプランレビューで合計21件以上の致命的指摘を拾って全件潰すという長丁場。並行して eurekapu-nuxt4 では全77ページ2カラム化と Part 2 教科書 CH8-12 をサブエージェント派遣、yomitoku 0.13.0 アップグレード、自炊書籍1冊（235ページの問題集）の OCR 取り込みまで進めた。最後は本番が404のまま全デプロイ失敗していた wrangler 問題を、4.91.0 更新と --commit-message ASCII 固定で復旧して締めた。
今日のタイムライン
今日やったこと
1. 都道府県クイズ統計編 12ページ完成（55→89問）
朝の段階では Phase 1 の4ページ24問しか手元になかった。共通composable usePrefectureQuiz に復習モード（localStorage で正誤保存→「未正解のみ」フィルター）を抽出させて4ページに展開し、Phase 2（人口・地理）、Phase 3（製造業・貿易港・財政・地価）、Phase 4（観光・教育・防災）と順に積んでいった。非加算指標（地価円/m²など）のため QuizQuestion 型に totalLabel? を追加してフッター表示を切り替える設計にした。さらに Phase 8 で全12ページに増問させて 55→89問（+34問）に拡張。
Codex（gpt-5.5）に通したら 10件の致命的誤り（県内総生産 total、海岸線延長順序、港湾コンテナ統一、最深積雪、活火山数、平均標高順序、人口密度解説の自己矛盾など）が出てきて全件修正させた。「フェーズ」表記は子供にとって分かりにくいので、本番向けに「📊 統計クイズ」「🗾 地図クイズ」の2カテゴリ表示に整理し直した。
詳細: 都道府県クイズに統計編12ページを増設し、89問へ拡張した日
2. 都道府県クイズ 地図クイズ4種を実装
Phase 5 で「県→特徴 逆引きクイズ」（by-prefecture）。最初は path 別になっていない Wikimedia SVG で簡略タイル地図にしていたが、Geolonia の japan-prefectures.svg（GFDL、47県が <g class="hokkaido prefecture" data-code="01"> でグループ化）に差し替えた。Phase 6A で「白地図クリック型」（find-prefecture）、6B で「地形図モード」（標高ティア段彩 CSS）。Phase 7 は「神経衰弱」を完成させたあとで、自分から「意図は地図クリックで県名カードを開閉する学習モードだった」と方針転換を入れて memory-game.vue を全削除させ、study-map.vue を作り直してもらった。
find-prefecture には「直近3回の正誤」を localStorage に保存する履歴管理＋連続誤答フィルター、地方別8チップでの色分けも追加させた。
詳細: 都道府県クイズに地図モードを4つ追加してずんだもん音声をR2配信に乗せた
3. eurekapu-nuxt4 全77ページ2カラム化 + Part 2 教科書 CH8-12
朝の段階で Part 2 投資判断クイズ18ページの動作確認、TS型エラー 62件を sed で !.id 一括置換してもらって 0件に。AnPerEmployee.vue のマゼンタハイライト時に白い箱の中の文字が消えるバグも潰した。そのあと、投資判断クイズの2カラム化を残り17ページに展開させ、別構造の practice-industry-quiz など5ページも PerQuizFigurePage ラッパーで統一して 全77ページ2カラム化 完了。スクロール spy で visible quiz の図を出す設計も足した。
Part 2 教科書 CH8-12 はサブエージェント並列で書かせた。CH8 をパイロットで先行、CH9-12 を並列起動。ただし4並列で派遣したら API Error 529 Overloaded で全クラッシュしたので 2並列×2セットに切り替え。当初は計画段階で書籍 Turso DB を裏読みさせていたため章立てが似ていた件を Codex に指摘されて、CH8-12 を Eurekapu 文脈にリライトさせた。
詳細: eurekapu-nuxt4 全77ページ2カラム化 + Part 2 投資判断クイズ + 教科書 CH8-12 実装
4. yomitoku 0.13.0 アップグレード + 自炊書籍 OCR
GitHub で yomitoku v0.13.0 が出ているのに気づいてアップグレード。pyproject.toml 経由で更新したら torch が CUDA版（2.7.1+cu118）→ CPU版（2.12.0）に置き換わって速度が落ちる落とし穴を踏んだ。PyTorch CUDA インデックス設定を pyproject.toml に追加させて GPU 版に戻した。
午後に自炊した1冊（235ページの問題集）を OCR に流した。GPU 処理で6分で完了したが、紙面の各ページに縦書きで「第N章 章名」のタブが印刷されていて全文に混入する問題に気づいた。「3個以上の章名が連続するブロックを検出して除去」する正規表現を yomitoku_import.py の前処理に追加させ、235ページ → 211チャンク → restructure-book で 45セクション に統合して Turso DB（book-knowledge-base）に格納させた。
詳細: yomitoku 0.13.0 アップグレードと自炊書籍の OCR 取り込み
5. テスト失敗修正・Cloudflareデプロイ復旧・公開記事3本
pnpm test:run で26件失敗していたのを、A-1（keydownハンドラに修飾キーガード1行）と A-2（共通composable useQuizSeoMeta を作って各ページに1行追加）で計123件パスに持っていってもらった。
夕方に「log.eurekapu.com/prefecture-quiz の目次ページが404」と気づいて、今日のデプロイが全失敗していたことに気づいた。原因は wrangler 4.68.1 が古い件と、Windows + 日本語コミットメッセージで code: 8000111（UTF-8として無効）で落ちる件。wrangler を 4.91.0 に上げてもらい、--commit-message で ASCII を明示指定する形に scripts/measure-deploy.ps1 を直してもらって再発防止。
合間に公開記事3本（CLI-Anything の検証、Notion CLI ntn の実態、Playwright Chrome拡張 vs Chrome DevTools MCP）も書いた。
詳細: テスト失敗修正・Cloudflareデプロイの日本語コミットメッセージ問題・公開記事3本
今日の試行錯誤
| # | テーマ | 試したこと | 結果 | 気づき |
|---|---|---|---|---|
| 1 | 神経衰弱 Phase 7 | memory-game.vue で県と特徴のペアマッチング型を完成まで作らせた | 自分の意図は地図トグル開閉だったと気づいて全削除 | 「神経衰弱」という単語から想像する形と、自分の意図がズレていた。画面で見せるまで認識合わせができない |
| 2 | Geolonia 日本地図 SVG | 最初は path 別になっていない Wikimedia SVG で簡略タイル地図にしてもらっていた | 自分で「もっと頑張ってほしい」と再指示 → Geolonia の japan-prefectures.svg に差し替えてもらった | 1回試して妥協した判断でも、自分が許容しないなら別ライブラリを当たり直す価値はある |
| 3 | VOICEVOX 直接呼び出し | useVoicevox.ts で localhost:50021 を fetch して wav 再生する設計にしていた | 開発では動くが本番で読者がエンジン起動していないと無音 | 「本番で誰の端末でも動くか」を最初に確認すべきだった。事前生成 MP3 + R2 に切り替えた |
| 4 | 4並列サブエージェント派遣 | CH9-12 を4並列でサブエージェントに派遣 | API Error 529 Overloaded で全クラッシュ | 2並列×2セットに切り替えて安定。並列度は API 負荷で調整する変数 |
| 5 | yomitoku 0.13.0 アップグレード | pyproject.toml で更新したら torch が CPU 版に置き換わった | pyproject.toml に PyTorch CUDA インデックス追加で GPU 版に戻させた | アップグレードで依存パッケージの index が消える落とし穴。index は明示しておく |
| 6 | TS型エラー 62件 → 0件 | BS/PL の v-if="deltaPopups[key]" ガード後の TS2532 を sed で !.id 一括置換させた | 一気に56件解消、全体 0件達成 | 同じパターンの narrowing 失敗は sed 一発で潰せる。手作業より速くて安全 |
| 7 | 章タブが全ページに混入 | 紙面の縦書き「第N章」が OCR で全文に入る現象を発見 | 「3個以上の章名が連続するブロックを検出して除去」する正規表現で前処理に追加させた | OCR の前処理は紙面構造を見てからルールを書く。1ページサンプルだけだと判断を間違える |
| 8 | wrangler 日本語コミットメッセージ | デプロイが全失敗、code: 8000111 で落ちた | wrangler 4.91.0 + --commit-message で ASCII 固定 → 復旧 | Windows + 日本語コミットメッセージは wrangler の自動取得で壊れる。固定形式に逃がす |
| 9 | Codex レビュー | プランと実装に対して codex exec -m gpt-5.5 で複数回通した | 致命的指摘21件以上を全件反映させた | 完成宣言の前に Codex に通すと矛盾と未完了タスクが大量に出る。レビュー先行を習慣化 |
| 10 | book Turso DB の参照タイミング | 計画段階で読ませていたが本文ドラフトでは読ませていなかった | Codex 指摘で CH8 リライトから書籍参照を明示、Eurekapu 文脈に書き換えさせた | 参照の有無と参照タイミングは別。引用箇所と引用元の対応が後で追えるようにしておく |
今日の学び
- 「○○みたいなやつ」は画面で見せるまで認識が合わない: 神経衰弱を作らせたら自分の意図は地図トグル開閉だった。最初に簡単なモックを見せてもらう流れに戻すと迷子コストが減る
- 本番デプロイの観点を最初から入れる: VOICEVOX 直接呼び出しは開発でしか動かない。読者の端末で動くかを実装着手前に決めたい
- 同型の TS narrowing 失敗は sed で潰せる:
v-ifガード後のdeltaPopups[key].idを!.idに一括置換させるだけで56件消えた。手作業より速い - アップグレードで依存 index が消える落とし穴: yomitoku 0.13.0 で torch CUDA→CPU。
pyproject.tomlに index を書き込ませて再発防止 - 並列度は API 負荷で調整: 4並列で 529 Overloaded、2並列×2セットなら安定。固定値じゃなく API 状況で変える変数
- Codex レビューは完成宣言の前に必ず通す: 1日で 21件以上の致命的指摘が出た。レビュー先行を計画書テンプレに組み込む
- wrangler の日本語コミットメッセージ問題は再現性が高い: 5/14 にも踏んで memo に対策を残しておいたから5/15に即解決できた。再発予防のために
--commit-messageをスクリプト固定
明日やること
- 未追跡ファイル（statistics/map両方）の
git add+git commit - Cloudflare Pages 環境変数
NUXT_PUBLIC_VOICE_BASE_URL=https://assets.otoarchive.com/prefecture-quizを設定して本番デプロイ - 本番デプロイ後の音声再生確認（公開URLでブラウザから実際に鳴るか）
- iPhone/Android 実機での 768px 以下レイアウト確認（Chrome DevTools エミュレーションは確認済み）
- eurekapu-nuxt4 Part 2 CH8-12 レビュー計画書の本実行（Codex アプリに派遣）
- テスト残り失敗（グループB系統）の調査