2026年8月18日の開発日記

朝いちばんに開いた画面には、前日の積み残しが6件並んでいた。夕方にもう一度数え直したときには、大項目だけで一覧に収まらなくなっていた。

この日は18のセッションを開いた。図を直すセッション、設問を抽出させるセッション、動画のレイアウトを試すセッションが別々に動いていた。作業そのものより、どこで手を止めるかを決める回数のほうが多かった。

今日のタイムライン

今日やったこと

1. 講義用テキストの図をSVGに描き直す

380枚がそろったところから、指摘が始まった。原図では四角どうしを線でつないでいるだけなのに、描き直した図には矢頭がついていた。しかも幹線と箱の隙間は14pxしかなく、そこへ矢頭を重ねていたので、つなぎの線まで潰れて見えなくなっていた。矢頭を44本から1本に減らさせると、接続はすべて線に戻った。一つ直すと隣が壊れる往復を、製造工程図、間接税法、法人税の順に繰り返した。

途中で、図を吐き出している生成スクリプトがGit管理から漏れていることに気づいた。出力だけコミットして生成元を置き去りにすると、次に同じ図を作れない。

主な成果:

• 原図にない矢頭44本の除去（幹線と箱の隙間が14pxしかない場所に矢頭を描いていたのが、線の潰れた原因だった）
• 推計区間の点線化と、読み順が意味を持つ図の番号入れ替え
• 生成スクリプトをGit管理下に置くルール化
• 確認用URLは節インデックス付きのフルパスで出す運用に修正

詳細: 原図にない矢印を消す。SVG図解のレビューで線と余白のルールを決めた一日

2. 財務諸表QAのフェーズを進める

参考書62冊から設問候補2,469問を抽出させ、夜には386問の統合問へ束ねた。抽出はサブエージェントを並列で走らせている。19体を投入した直後、残り時間と利用枠を見て手を止めた。

止めるかどうかを判断した材料は、進捗率ではなく残量だった。フェーズ3を完走させてから区切ると決めた。そこまで走らせて、セッションを閉じた。

主な成果:

• 62冊 → 設問候補2,469問の抽出（43冊分で1,709問まで到達した時点を含む）
• 386問の統合問へ束ねるフェーズを親セッションで直接実行
• 進捗ドキュメントを残して別セッションへ引き継ぎ

詳細: 62冊から2,469問を抽出し386問へ束ねるまで。利用枠とコンテキストの残量で作業の区切りを決めた記録

3. 書籍ナレッジベースに7冊を足す

蔵書386冊のDBに追加取り込みをかけた。元にしたい本を10冊まで絞ってから原本の在処を確認させたら、実行できるのは7冊だった。ライブラリに入っていることと、取り込みのパイプラインを通せることは別だった。コンソールが文字化けしてDB照合をやり直し、章見出しの誤マッチと固定レイアウト本での停滞誤検知に順につまずいた。詰まるたびに直して、クリーンアップまで一周させた。

運営しているサイトのコンテンツをどう増やすかも並行して考え、ナレッジベース側で先にディレクトリを作る順にした。まだ買っていない本があると分かったので、その分はタスクに積んだ。

主な成果:

• 蔵書386冊のDBへ7冊を追加取り込み（重複チェックからクリーンアップまで）
• Kindleのハイライト取得を、拡張機能のリロードを挟みながら再開
• 未購入分の書籍をタスクへ登録

詳細: 書籍ナレッジベースに7冊を追加取り込みして、文字化けとKindleキャプチャの誤検知を直した日

4. 縦型ショート動画のレイアウト

縦ショート用のレイアウトを新しく組む計画で着手した。ところが累進課税シミュレーターのページを縦幅で開いたら、既存のレスポンシブがそのまま縦積みになっていた。専用実装をやめて、撮る方式に切り替えた。

720×1280を1.5倍で撮って1080×1920に出す。他のセッションを止めた状態で、コミットからデプロイ、プッシュまで通した。

主な成果:

• 専用レイアウトの実装を取りやめ、既存レスポンシブでの撮影に方針変更
• 1080×1920の書き出しとダウンロードボタンの追加
• デプロイまで完走

詳細: 縦型ショート動画のレイアウトを専用実装せず、既存のレスポンシブ縦積みで撮った

5. 2台のPCをつなぐ経路とTTSのテンポ

これまで別のPCのセッションへ話しかけるとき、ブラウザを開いて入力欄に文字を流し込んでいた。その前提を疑ったら、LAN内で直接届く経路があった。作り直したら、往復が通った。

TTSナレーションのテンポ設計をどこに入れたかを確かめ、スキル側へ反映した。走りっぱなしのdevサーバーとMCPプロセスも一覧して掃除した。

主な成果:

• ブラウザ経由をやめ、LAN内で直接届く経路へ作り直し
• TTSナレーションのテンポ設計をスキルへ反映
• 走りっぱなしのプロセスを一覧して停止

詳細: ブラウザ経由をやめて2台のPCのClaude Codeをつないだ日と、TTSナレーションのテンポ設計

6. 積み残しの棚卸し

夕方、積み残しを大項目だけリストにさせた。棚卸しコマンドがこのリポジトリには入っておらず、状態ブロックも書かれていないので、今回は手で集計させた。

ついでにバンドルサイズの余裕を聞いたら、逼迫しているという答えが返ってきた。それが古い数値だった。実測はgzip 1.657 MiBで、上限3.0 MiBの55%しか使っていない。marginは1,374.9 KiB残っていた。

今日の試行錯誤

今日の学び

• 原図にない要素を足さない、という判断は、消す方向と足す方向で同じ強さでは働かない。矢印は消させたが、無い欄は足させている
• 出力だけをGitに入れて生成スクリプトを外に置くと、その図はもう作り直せない。生成物と生成元は同じ場所に置く
• 止めどきの材料は進捗率ではなかった。残り時間と利用枠を見て、フェーズの切れ目で閉じた
• ルールファイルに書いた数値は古くなる。逼迫していると言われたら、まず実測を取る
• 長く使っている方式ほど疑われない。ブラウザ越しの往復は、直接届く経路があるのに続けていた

明日やること

• 講義用テキストの図レビューの続き（残りの章の指摘対応）
• 財務諸表QAの次フェーズ（386問の統合問の精査）
• 書籍ナレッジベースの未購入分を買って取り込む

関連記事

この日の作業記録:

• 原図にない矢印を消す。SVG図解のレビューで線と余白のルールを決めた一日
• 62冊から2,469問を抽出し386問へ束ねるまで。利用枠とコンテキストの残量で作業の区切りを決めた記録
• 書籍ナレッジベースに7冊を追加取り込みして、文字化けとKindleキャプチャの誤検知を直した日
• 縦型ショート動画のレイアウトを専用実装せず、既存のレスポンシブ縦積みで撮った
• ブラウザ経由をやめて2台のPCのClaude Codeをつないだ日と、TTSナレーションのテンポ設計

この日に書いた解説記事:

• 別のPCのClaude Codeに話しかける — ブラウザ操作をやめてLANのHTTPで往復させた
• セミナー会場の全員のClaude Codeと会話する — 進捗を集めて、席に行かずに指示を出す
• Windowsのマイクで録ってMacに届ける — ブラウザを「マイクのドライバ」として使う
• 自分の声を複製して、BPM120のビートに乗せる — TTSで講義音声を作る実験