2026年8月12日の開発日記

朝いちばんに前日の積み残しを並べさせたら、図解カタログの計画書が3本に分かれたまま残っていた。 そこから夕方まで、報告と画面のずれを拾い続けることになる。

うまく回っているに違いない、と思っていた時間のほうが長い。 テストは222ファイル19,681件が通り、通知のテスト送信は HTTP 200 を返し、非公開にした記事も一覧から消えていた。 どれも、自分で開いて数えるまでは正しく見えた。

今日のタイムライン

mdx-playground が15時間28分で13セッション、eurekapu-nuxt4 が5時間12分で2セッション。 家族旅行アーカイブに48分、支援先サイトに20分を使った。 合わせて17セッションで、こちらの発言は160件だった。 コミットは15本になった。

今日やったこと

1. 図解60型カタログのフレームを揃える

27系と33系のツリーが隣り合っているのに、縦横比もフォントも揃っていない。 その2つを同じキャンバスに乗せる作業を1日かけて回した。 グリッドが見えてくると、今度は口で場所を指すのに困る。 「ツリー図の上」「ページ番号の下」では毎回説明が要るので、領域そのものに名前を付けさせた。 天マージン、地マージン、版面、上の谷、下の谷、出典行、注記行。

夕方、カテゴリAの11型を仕上げたという報告を受けて詳細ページを開いたら、頼んでいない変更が成果として並んでいた。

主な成果:

• 幅1024、四辺の余白24、gutter 20、カラム幅63で確定した。16:9と4:3を1か所で切り替えられる形にさせた
• 領域名を .claude/references/slide-zone-names.md に置き、グリッド表示のときにスライド上へ13個のラベルを出させた
• フレームの持ち方をA案、B案、C案の3つでworktreeに並行実装させ、B案推奨まで出した。master には入れていない
• カテゴリA（階層・構造）の11型を同じキャンバスへ展開した。半端な座標は入れ子6件と33系トライアングル3件を整数に直した

詳細: 図解60型カタログのフレームを統一する。スライドの領域を命名して意味グリッドで揃えた1日

2. 会員登録のLINE通知と、管理者権限の置き場所

万が一、会員登録が入ったら自分に通知が飛ぶようにしたい。 朝に出した要望はそれだけだった。 登録の入口はメールとGoogleの2つあるが、どちらも better-auth の同じフックを踏むので、置き場所は1箇所で足りる。 送り先は、手元まで通知が来るLINEにした。

その日のうちに、自分の管理画面に自分が入れない理由を追いかけていた。

主な成果:

• 通知の実装から本番デプロイまで通した。退会機能も、同じメールアドレスで再入会できるところまで確かめた
• 管理者を admin_email テーブルへ移し、環境変数1本にぶら下がる状態をやめた
• デプロイスクリプトの前段に整合性チェックを入れさせた。管理者の人数が出ないと先へ進まない
• 計画を2回、書いたコードを1回 Codex に読ませた。退会の判断根拠は、法令ではなく「同じメールアドレスで再入会できること」に落ち着いた
• テストは3,170件になった

詳細: 会員登録のLINE通知を実装したら、管理者権限が3ヶ月前から消えていた

3. 非公開フラグと、公開SQLダンプに残っていた本文

保有銘柄のデイリーニュースを非公開にしようとして、frontmatter に unpublished: true を足した。 設定ファイルにそう書いてあり、既存193本が同じ方式で動いている。 前提が正しければ、判断としては筋が通っていた。

念のため本番の配信物を直接叩いたら、本文がそのまま返ってきた。 消えていたのは導線だけだった。

主な成果:

• デイリーニュース4本を、本番除外の対象になっているローカル専用ツリーへ物理的に移させた
• 本番ビルドのときだけ非公開記事のパスを列挙し、コレクションの source.exclude へ流し込む形にさせた。列挙されたのは169件
• 検証スクリプトに、ダンプを復号して本文の残存を検査する処理を足させた。対策前の dist に当てると197件を検出して落ちる
• Codex のレビューで、実測の読み違いが8件のうちの1件として返ってきた。設計に使う前に潰せた

詳細: 非公開フラグでは記事を隠せていなかった：Nuxt Contentの公開SQLダンプに本文が残る

4. PVが測れていないサイトにGA4を入れる

そういえばこのブログ、PVという概念がない。 月にどれくらい読まれているのか、自分で答えられない。 タグを貼る対象を確定させるつもりで現状を洗わせたら、そこで手が止まった。 保有ドメインは6件、稼働しているホストは26件あった。 うち3ドメインは、自分の口から名前が出てこなかった。

途中で「5年間データが入っていない」という報告が上がってきた。 根拠を聞くと「過去48時間に受信データなし」の表示だけだった。 過去12か月で見せたら、アクティブユーザーは3.7万いた。 計測が止まったのは2026年6月7日で、原因はサイト移行のときにタグを引き継がなかったことだった。

主な成果:

• 26ホストのHTMLを1件ずつ取得して計測タグを検出させた。穴はいちばん見たい本体サイトとこのブログの2つだった
• ドメイン、ローカルリポジトリ、Cloudflareの配信先、GA4、Search Consoleの5列で対応表を作らせた。リポジトリ特定の最短経路はDNSのCNAMEだった
• 本体サイトは、本番ビルドのときだけタグが入る形で実装させた。生成物241ページすべてに出ることを確認してからデプロイした
• 送信は通っているのにGAが記録しない件は、切り分け途中のまま翌日へ持ち越した

詳細: PVが測れていないサイトにGA4を入れ、ドメイン別の計測対応表を作った

5. 台湾の後工程テスト4社の月次まとめを自動化する

外部のブログで、台湾のテスト会社の月次売上をまとめた記事を見かけた。 毎朝の /make-diary チェーンには台湾の月次売上を取り込むステップがすでにあるので、そこから続けて記事まで作れるはずだった。 突き合わせさせたら、手元の数字は外部記事とそのまま一致した。

材料が揃っていたぶん、この日つまずいたのは、どれも見せ方の話だった。 売上高を並べるだけでは「今月も過去最高」で終わる。 前月差と、その差がさらに増えたかどうかを主役にした。

主な成果:

• ASE、Powertech、KYEC、Ardentec の4社を1本にまとめ、1社につき水準、前月差、勢いの3段チャートにした
• 生成スクリプト405行とテスト123行を先に書かせた。テストは見た目ではなく数字の意味を守る位置に置いた
• 4社を1枚に並べた俯瞰図は削除した。同じ内容が各社のモニタリングページに31ヶ月ぶんあった
• /tw-test-monthly-report として切り出した。4社の最新月がそろわない日と、その月の記事が既にある日は、最初のステップで止まる

詳細: 台湾の後工程テスト4社の月次売上まとめを、毎朝のコマンドチェーンから自動生成する

6. 疑問が湧いた順に5本

朝の6時すぎ、GitHub のリポジトリを1本貼って「これ、内部APIを触ってるんですかね」と聞いた。 そこから日が暮れるまで、疑問が浮かぶたびに投げては記事か教材に変えていった。 数えると5つ。 技術記事が3本、教材ページが1本、それと子どもに送る文章が1つだった。

段取りよく進んだ日だと思っていた。 ただ最後の1本で、比較してほしかったのはそこじゃない、と言い直すことになる。

主な成果:

• After Effects の拡張が3層でできていることを実装から確かめさせて記事にした。内部APIを叩いているという当初の見立ては外れていた
• 公開鍵暗号とデジタル署名の教材ページを作らせた。図解6点、動かせるシミュレータ5つ、テスト30件
• 前日公開の3本を Codex にレビューさせ、「循環取引」という断定を撤回した。主語が入れ替わっていた2箇所も是正させた
• 子ども向けの文章は、整えさせた版を読んでから自分で書き直した。数字の食い違いだけは自分以外の目のほうが早かった

詳細: 疑問が湧いた順に5本書いた1日：After Effects の拡張構造から VRAM の壁まで

7. 家族旅行の予定と、支援先サイトの検索順位

家族旅行アーカイブでは、登録してある旅行の予定とカレンダーの内容が食い違っていないかを全件突き合わせさせた。 必要な予約情報はカレンダー側にも書き込ませて、どちらを開いても同じことが分かる状態にした。

支援先サイトのアクセス解析では、検索順位を確認するフローを頭から終わりまで一度回した。

今日の試行錯誤

今日の学び

• 「隠す」には導線を消すものと、出力そのものを作らないものがある。設定ファイルに「非公開フラグ」と書いてあっても、どちらなのかは実装を読むまで決まらない
• ステータスコードは届いた証拠にならない。通知は200を返してから別のボットへ行き、GAは204を返してから黙って捨てていた。どちらも受け取り側を見るまで分からなかった
• 権限のように「無いと詰むもの」を環境変数1本にぶら下げない。DBに持たせて、消えたらデプロイが止まる形にした
• 図の崩れは目で気づけるが、データの範囲は目では気づけない。「N ヶ月ぶり」「過去最高」と書く前に数える、を手順書の厳守事項に入れさせた
• 実装を回すのは速い。速いぶん、頼んでいない変更が成果報告に紛れて出てくる。今日それを見つけられたのは、テストが全部通ったという報告のあとで自分の目で画面を開いたからだった

明日やること

• 送信は通っているのにGAが記録しない件を切り分ける（プロパティの状態、測定IDの現行値、移行前の測定ID、新ストリーム作成の順）
• このブログ用の GA4 プロパティを作ってタグを置く
• 非公開記事の取り込み前除外を本番へ反映する
• 図解カタログのカテゴリB以降を展開する
• フレームの持ち方のB案を、worktree から master へ入れるか決める

関連記事

• 図解60型カタログのフレームを統一する。スライドの領域を命名して意味グリッドで揃えた1日
• 会員登録のLINE通知を実装したら、管理者権限が3ヶ月前から消えていた
• 非公開フラグでは記事を隠せていなかった：Nuxt Contentの公開SQLダンプに本文が残る
• PVが測れていないサイトにGA4を入れ、ドメイン別の計測対応表を作った
• 台湾の後工程テスト4社の月次売上まとめを、毎朝のコマンドチェーンから自動生成する
• 疑問が湧いた順に5本書いた1日：After Effects の拡張構造から VRAM の壁まで