メインコンテンツへスキップ
見出し画像

「最近おきてたやつだね」の一言で、AIが解決できなかったバグが5秒で直った話。

    新しいアプリの画面デザインを反映していたら、ブラウザのプレビューが真っ白になりました。

    Claude にエラー解析を頼んでも、原因がはっきりしない。F12 で開発者ツールを開いてエラー文を見せてください、と言われた段階で、私の方が「あ、これ前にあったやつだ」と気づきました。

    私が「最近おきてたやつだね」と一言だけ言ったら、5秒で原因が特定されて直りました。


    5月7日の夜、画面が真っ白

    今、新しいアプリを開発中です(リリース前なので詳細は伏せます)。

    明るい色合いに揃えたくて、画面を順番にデザイン反映していました。Claude と Codex(OpenAI のコーディング AI)を並走させて、Claude は複雑な画面6本、Codex は単機能の画面5本を分担。1日でアプリ全体のデザインを刷新する計画です。

    順調に Screen 1〜3 を仕上げて、ブラウザでプレビューを確認しようとしました。

    `npx expo start --web` でサーバーが立ち上がる。バンドラーは911モジュール9.7秒でビルド完了。HTTP も 200 OK。

    なのに、ブラウザの画面は真っ白でした。


    AI は原因を特定できなかった

    まず Claude が動きました。

    サーバー側のログを確認。エラーなし。HTML を curl で取得すると `<div id="root"></div>` は空のまま。これは React がマウントできていない、つまりブラウザ側の JavaScript で実行時エラーが起きているサインです。

    「F12 で開発者ツールを開いて、Console タブの赤字エラーを見せてください」

    これが Claude の判断でした。間違ってはいません。ブラウザの実行時エラーはサーバー側のログには出ないので、Console を見るのは正しい手順です。

    でも、ここで私の方が違和感を持ちました。


    「最近おきてたやつだね」

    ブラウザのコンソールには、こう書いてありました。

    Uncaught SyntaxError: Cannot use 'import.meta' outside a module

    このエラー、見覚えがあります。

    5月1日。「pitacopi」という別のアプリを開発していたとき、同じエラーで半日潰しました。Web プレビューが真っ白で、4回試行錯誤して、最終的に Babel の設定を1行足して直したのです。

    私は Claude に短く伝えました。

    Uncaught SyntaxError: Cannot use 'import.meta' outside a module → これは、最近おきてたやつだね。過去の作業履歴・相談履歴見たほうがいいかも。

    たったこれだけ。


    5秒で答えが出た

    Claude は `作業管理/作業履歴/` 配下を grep で検索しました。

    ヒット:`2026-05-01_作業履歴.md` の 357行目。

    完全に同じエラー。完全に同じ症状。

    そして、解決策まで全部書いてありました。zustand(状態管理ライブラリ)が内部で `import.meta.env.MODE` を参照していて、Expo SDK 55 系の Babel ではこれを変換できない。`babel-preset-expo` のオプションに `unstable_transformImportMeta: true` を1行足せば直る、と。

    5月1日の私が、5月7日の私のために残した完全な解答書でした。

    Claude は babel.config.js に1行追加して、Metro バンドラーをキャッシュクリアで再起動。9.7秒で再ビルド完了。ブラウザを Ctrl+Shift+R で強制リロード。

    動いたよ。

    AI の記憶は memory と grep の2系統

    なぜ Claude は最初の段階で気づけなかったのか。

    Claude には「memory」という長期記憶の仕組みがあります。私が「これは大事だから覚えておいて」と指示したり、毎回繰り返される失敗パターンを保存したりする場所です。

    5月1日の `import.meta` 解決の話は、memory には登録していませんでした。「pitacopi 固有の話」だと思って、共通ノウハウに格上げしなかったのです。だから Claude は明示的には覚えていなかった。

    もう1つの記憶が「grep」です。プロジェクト内の全ファイルを横断検索する仕組み。作業履歴は毎日 Markdown ファイルに記録しているので、grep で過去のエラー文と一致する行を探すことはできます。

    ただ、grep には「何のキーワードで探すか」が必要です。今回でいえば `Cannot use 'import.meta'` の文言で検索するという発想が、最初の段階では Claude から出てこなかった。

    私が「最近おきてたやつ」と教えた瞬間に、検索条件が固まって、5秒で答えが出ました。


    元SE時代を思い出した

    会社員でシステムエンジニアをしていた頃、「インシデント DB」というものがありました。過去の障害対応の記録を全部蓄積していて、似たような症状が出たときにキーワードで検索する。経験10年のベテランが「あ、これあのときの」と思い出せる範囲を、組織全体で共有する仕組みです。

    検索しないと意味がないので、誰かが「これ前もあったよね?」と気づくところから検索が始まります。

    AIとの協業も、同じ構造でした。私の作業履歴は、私と AI が共有するインシデント DB。書き続けるだけでは足りなくて、「これ、前にもあった」と気づく目が必要だった。

    その目は、まだ私の側にあります。


    仕組みに変えた

    事故ったまま終わらせるのはもったいないので、仕組みを更新しました。

    Claude の memory に「`import.meta` で Web preview が真っ白になったら、`babel-preset-expo` の `unstable_transformImportMeta: true` を追加」というルールを追加しました。これで次回、Claude は最初の段階でこの原因を疑う設計になります。

    ついでに、`feedback_grep_past_lessons_first.md` という memory(前から登録してあった)の有効性が改めて確認できました。これは「私が『前にあった』と参照したら、推測せず即 grep で該当ファイルを探す」というルールです。今回はまさに、このルールが救ってくれました。

    書き残すことが、過去の自分から未来の自分への手紙になる。

    その手紙を AI と共有できるようになったのが、今の個人開発のいいところです。


    5月1日の私、ありがとう。あなたの試行錯誤4回が、5月7日の私を半日救いました。

    そして次にこのエラーで困っている誰かにも、この記事が残せたらと思います。


    #個人開発 #ClaudeCode #Expo #zustand #importmeta #AI開発 #元SE #個人開発日記 #ハーベストラボ #バグ修正 #作業履歴

     
     
    元SEの知見を活かし、AI副業に挑む二児の母(農家手伝い)。開始3日で動画11本投稿、アプリ開発着手など爆速アウトプット中。月2万円のツール投資を収益化する軌跡や、上流工程の経験を活かしたプロンプト術を発信します。AIで日常を効率化し、月収1万円を目指すリアルな奮闘記です。

    あなたへのおすすめ