開発mdx-playground

宅建教科書 Phase 3 を1日で詰め切った。朝のセッションでパスルートの二重 (/takken/takken/) を踏んで一回ひっくり返し、昼から夕方にかけて /takken/* 全 49 ページに前後カテゴリ pager と矢印キーナビを追加、用語集は 4 カラムカードを全部捨ててテーブルに作り直した。最後に Codex に通したら、用語集の中に「事前承諾」が 2 つ並んでいたり、「試験での問われ方」という見出し文字列がそのまま用語として混入していたりして、用語集として体をなしていないことが画面で露呈した。

朝：/takken/takken/ のパスルート二重問題

朝イチで Hub をクリックして気付いた。/takken/takken/takken-gyo-menkyo/ で 404。

frontmatter の path: "/takken-gyo-menkyo" が Hub からのリンク先 /takken/takken/takken-gyo-menkyo/ と一致していない。原因は frontmatter path の指定がただの /takken-gyo-menkyo になっていて、field 中間セグメントを想定していなかったこと。

ここで一度 field 別の中間 Hub /takken/{field}/ を追加する案を試したものの、要らないと判断してパンくずから field セグメント自体を除外することにした。「学習推奨順序」「公開状況」「H2/H3 カウント」も Hub から削った。情報を盛り込みすぎると、結局どこから読み始めればいいのか分からなくなる。

昼：49 カテゴリを矢印キーで巡る

午後にユーザーから「コンテンツを矢印キーで移動できるようにしてほしい」という指示が来た。

最初は [...slug].vue に setPageLayout で takken レイアウトを当てるだけで済ませようとしたが、SSR 経路で setPageLayout 単独だと効かないことに気付き、middleware パターンに切り替えた。実装方針:

  • apps/web/app/layouts/takken.vue に ← / → の keydown リスナと、ページ末尾の 2 カード型 pager を追加
  • 単一閲覧順を「Hub → intro → glossary → 49 カテゴリ（章立て順）」で固定
  • input / textarea / IME 変換中（e.isComposing）はキー入力を無視

ブラウザで ← を押すと前カテゴリへ、→ で次カテゴリへ。用途地域 13 種を順番にめくっていく動きが、本のページをめくる感覚に近い。コミット 81ad6785 feat(takken): 前後カテゴリ pager と矢印キーナビを全 /takken/* に追加 で確定。

夕方：用語集を 4 カラムカードから捨てる

/takken/glossary を開いてユーザーが拾った違和感が鋭かった。

「連帯」とか「連帯責任」をクリックすると、ただ記事のページにリンクさせてるだけじゃないですか。あと、これ 4 カラムにしてる意味があんまりないんで、テーブルデータにした方がいいんじゃないですか。説明文のところ、薄いグレーの文字列じゃなくて、普通に黒でいいんですよ。

4 カラムのカードコンポーネントは「ぱっと見でリッチ」だが、用語集としては検索性も比較性もない。テーブルにすれば 1 行 1 用語で目が縦に走る。指示を受けて 3 点を一気に直した:

  1. 各用語に短い解説スニペットを追加（generator 拡張 + データ再生成）
  2. 4 カラムカード → テーブル形式
  3. 説明文の薄グレーをやめて黒文字に

書き直したあと「結局これは用語集として機能しているのか」を自問してから画面に戻った。

Codex で剥がれた「用語ではない用語」

戻ったら、ユーザーがもう一段深い違和感を持っていた。

「事前承諾」も 2 つあるし、用語集として機能していない。試験での問われ方とかって、むちゃくちゃ同じのが入ってる。

画面を上から眺めたら、確かに「試験での問われ方」「このカテゴリで覚える 3 つの結論」といった callout タイトルの文字列 が用語として並んでいる。本文中の **...** 強調語を抽出する generator が、callout 内の見出しまで巻き込んでいたせい。「事前承諾」が 2 つ並ぶのも、用語ベースで集約しておらず、出典カテゴリごとに別行になっていた結果。

ここで Codex (gpt-5.5) にデータを見せてレビューしてもらったら、ノイズの正体が 5 系統に整理できた:

  • HARD_EXCLUDE: callout タイトル（「試験での問われ方」等）
  • PREDICATE_FRAGMENT: 「できない」「に該当」「のみ」「みなされる」などの述語フラグメント
  • TEMPORAL_MARKER: 「期間中」「広告時」「事前承諾」「処分後」などの時系列マーカー
  • CONCLUSION_LABEL: 「許可必要」「適用不可」「対象外」などの結論ラベル
  • META_FRAGMENT: 「それ以外」「同じ」「対象」「横ばい」「原則」などのメタ表現

加えて「あらかじめ〜」「いずれか〜」「すべての〜」などの連体修飾語始まり、「ゲート①」「ステップ②」の番号付きラベルも除外対象に追加。

数字の推移は以下のとおり:

段階用語数 (unique)主な除去対象
初期生成1,254フィルタなし
過去問引用除外1,040「令和2年問40」等
用語ベース集約 + 汎用語除外1,021同一カテゴリ重複、「ない」「ある」等
Codex 推奨フィルタ895「なく」「に該当」「のみ」「同じ」「事前承諾」等
連体修飾語 + 番号付きラベル889 (現状)「あらかじめ〜」「ゲート①」等

同じ用語が複数カテゴリに出る場合は 1 行に集約、出典は小チップで → アイコン付きで本文導線を確保した。用語はベタ表記でリンクなし、出典チップにだけ導線を集める形に倒した。コミットは 4384bac4 refactor(takken): 用語索引を「テーブル + 用語ベース集約 + Codex ノイズ除去」に刷新。

引き継ぎメモを書いたら、Codex がそれにも噛みついた

ユーザーから「今日じゃなくて明日やりたいので、内容をレビューして Codex のレビューを受けてください」と言われ、memo/2026-06-15/takken-session-handover-evening.md を書いた。書き終わって Codex に流したら、3 件の致命的指摘 + 1 件の補足が返ってきた:

  • 「メモ自体が未コミット」: 次セッションで読めない可能性がある（最重要）
  • 「stash に退避」がエージェント任せだと危険: 未コミット差分は memory-makers 作業の途中の可能性が高い
  • 助詞含有正規表現でフィルタを足す案は危険: 「悪意による不法行為に基づく損害賠償債権」「雨水の浸入を防止する部分」のような 真の用語 を 258 語も巻き込む

特に 3 つ目は刺さった。助詞を含む文字列を一括で除外したら検索効率は上がりそうだが、宅建用語は本質的に「○○に関する△△」という構造を持つものが多い。正規表現でなく、Codex に keep/drop の二択を投げて返ってきた drop リストを 完全一致の EXACT_BLACKLIST で除外する 2 段階アプローチに変更した。

指摘を反映してメモを書き直し、Codex に再レビュー → 残課題なしを確認 → メモのみ単独コミット（54fbcce5 docs(takken): 引き継ぎメモを Codex レビュー反映で安全化）。memory-makers 系の未コミット差分は触らずに温存。

並行して走っている移行計画

夕方のセッションでは、宅建コンテンツを「eurekapu-nuxt4」側に R2 + Vue コンポーネント化で移送する計画も並行で議論した。

ユーザーの判断は「他のコンテンツと見え方を揃えたいので Vue コンポーネント化したい」。SVG・OG PNG・用途地域パネル PNG を info-accounting.com の R2 バケットに逃がして、mdx-playground 側からは画像を削除する方向。実行は eurekapu-nuxt4 側で新規セッションを立てて行う想定。

ただし移行する glossary は「現状 889 語版」ではなく、Codex のノイズ除去フィルタを通したクリーン版にする必要がある。先に移行を始めると、ノイズ除去のたびに eurekapu-nuxt4 側の takken-glossary.ts を再反映する手間が二重で発生する。

学んだこと

  • リッチな見た目（4 カラムカード）は、検索性・比較性のないコンテンツでは情報量を逆に下げる。1 行 1 用語のテーブルが正解 だった
  • generator が **...** 強調語を機械的に拾うと、本文の callout タイトルまで「用語」になる。画面で人が見て初めて違和感が拾える
  • Codex は「正規表現一発で 258 語巻き込む」のような構造的なリスクを拾うのが得意。引き継ぎメモのレビューに使うと、自分では気付かない停止条件のずれを指摘してくる
  • 「今日じゃなくて明日やりたい」と決めた瞬間、引き継ぎメモが次セッションの自分への手紙になる。未コミットのまま /clear したら手紙が届かない という Codex 指摘は当たり前のようでいて忘れがちだった