リポジトリにすでにnext-intl、react-i18next、i18next、Linguiが組み込まれている(ディスク上にロケールフォルダがあり、package.jsonに依存パッケージが記載され、ミドルウェアや設定ファイルがある)なら、ゼロから始める前提のツールをもう一つ導入する必要はありません。globalize.nowは、AI搭載のローカライズ基盤です。L1(国際化済み)モードでは、既存の構成を壊しかねないセットアップのスキャフォールドをスキップし、同期モードで動作します。ソース言語を読み取り、プッシュ時に他のロケールとのdiffを取り、不足分を補ったプルリクエストを作成します。この記事では、このモードが何に触れ、何には触れないのか、そして検出が外れたときにどうすればよいかを説明します。

なぜ、ほとんどのi18nに関するアドバイスは「ゼロからのスタート」を前提としているのでしょうか?

i18nツールのマーケティング資料は、いまだに「グリーンフィールド」――ライブラリ未導入、ロケールファイルなし、抽出作業も未着手――というケースを前提に語られがちです。しかし、ほとんどの本番コードベースはそのような状態ではありません。

ここ数週間で、無関係な3つの初回セッションに、同じパターンが見られました。チームは一度i18nに挑戦し、中途半端に動く状態まで進めたところで止まってしまいました。作り直すくらいなら、今の散らかった状態と付き合うほうがましだと感じたからです。

もし思い当たるなら、この記事はまさにあなたのために書かれています。

「半分だけ国際化されたコードベース」とは、実際どのようなものでしょうか?

次のようなパターンが繰り返し見られます(詳細は匿名化しています)。

  • Next.js + next-intlのアプリで、ほとんどのコンポーネントはt()を使っているものの、古いルートには最初の移行が終わらなかったせいで英語のハードコードされた文字列がまだ残っている、というケース。
  • ロケールファイルは存在するものの、中身は英語の値だけというReact + i18nextのプロジェクト。翻訳は、いつも「来四半期」の課題でした。
  • messages/のツリーで、en.jsonの中身は充実しているのにes.jsonはほぼ空、というケース。
  • レイアウトに言語切替スイッチャーが組み込まれているものの、ルーティングが半分しか移行されていないせいで、時々404エラーになってしまうというケース。

これらのプロジェクトはどれも、globalize.nowによる「やり直し」を必要としているわけではありません。必要なのは、作業を完了させることです。

L0 versus L1 setup pathA decision tree showing that when globalize.now detects existing i18n on first run, it skips four destructive setup steps and goes straight to translating missing keys.your repoDETECTIONfirst-run scan of package.json + repoNO i18n FOUNDL0 pathi18n DETECTEDL1 pathinstall libraryextract stringsgenerate locale filesinject switchertranslateinstall libraryextract stringsgenerate locale filesinject switchertranslateSKIPPEDPR on every push
検出結果によってセットアップフローが分岐します。L0では全5ステップが実行され、L1では4ステップがスキップされて、直接同期処理に進みます。

globalize.nowは初回実行時、どのようなシグナルをスキャンするのでしょうか?

検出処理は1段階ではなく、2段階で行われます。

まず、globalize.nowをリポジトリに接続します。アプリ上で接続すれば、検出と一度きりの変換を自動で実行します。このパスをローカルでエージェントに任せたい場合は、スキルをインストールしてください。数個のプレイブックファイルが.claude/skills/に追加されますが、リポジトリのそれ以外の部分は一切変更されません。

npx skills add globalize-now/globalize-skills

次に、エージェントにプロンプトを送ります。Claude Code、Cursor、Codexのいずれでも構いません。エージェントはインストール済みのスキルを読み込み、それを使ってリポジトリをスキャンします。

Set up localization for my project

実際に検出処理が行われるのは、この2番目のステップです。エージェントは以下を確認します。

  • package.jsonの依存関係: next-intl、react-i18next、i18next、@lingui/core、@lingui/react、@lingui/macro、または任意のi18next-*プラグイン。
  • ロケールフォルダ: リポジトリのルートにあるmessages/、locales/フォルダ、あるいはロケールごとのサブフォルダを持つsrc/i18n/。
  • 既存のロケールファイル: en.json、en.po、en.yml、en.yaml、あるいはお使いのライブラリがすでに想定しているデフォルトロケールのファイル。
  • フレームワーク固有の設定: i18n.config.ts、next-intlのミドルウェア、lingui.config.js、あるいはそれらに相当するもの。

これらのシグナルのうち2つ以上が検出されると、プロジェクトはL1(国際化済み)とみなされ、ゼロからのスキャフォールドを実行する代わりに、セットアップのフローが分岐します。詳しくは、既存のi18nに関するヘルプセンターの記事をご覧ください。

L1モードでは、何を変更しないのでしょうか?

ここが皆さんが気にする部分です。L1モードでは、globalize.nowは次のことを行いません。

  • コンポーネントをスキャンしてハードコードされたリテラルを探す、広範な文字列抽出処理の実行。
  • 新しい翻訳キーの生成や、すでに採用済みのキー構造の並べ替え。
  • まだ設定していない言語のロケールファイルのスキャフォールド生成。
  • 言語切替スイッチャーの挿入。すでにお持ちであればそのまま残し、なければ新たに追加することもありません。
  • ルーティング、ミドルウェア、フレームワーク設定の書き換え。

既存のi18nセットアップはそのままあなたのものです。このモードでは、私たちがそれをリファクタリングすることはありません。

検出処理の後、L1同期モードは何を行うのでしょうか?

L1は同期優先で動作します。検出処理が確定した後は――

  1. 既存のロケールファイルを読み込み、現在のキー構造と、どの言語がソースオブトゥルース(正となる言語)かを把握します。
  2. globalize.nowのCLIまたはWebアプリを通じて、GitHubリポジトリを接続します。
  3. mainブランチへのプッシュのたびに、ソース言語のファイルと他のロケールファイルとの差分を取ります。不足している翻訳は、あなたが設定した用語集とスタイルガイドに準拠したAI出力によって補完されます。
  4. 更新されたロケールファイルを含むプルリクエストが作成されます。レビューとマージはあなたが行います。私たちが代わりにマージすることはありません。

これがひとつのループです。面倒を見る必要のある翻訳ダッシュボードもなければ、手動でのエクスポートも、ファイル形式のあれこれの調整も必要ありません。

CursorでビルドしたNext.jsアプリに、15分でi18nを導入するには?で紹介しているL0の手順と見比べてみてください。同じプロダクトですが、入口が異なります。

UIの一部だけが翻訳呼び出しを使っている場合はどうすればよいですか?

それは移行途中のよくある形です。新しい画面はt()を使い、古い画面にはまだリテラルが残っている、という状態です。同期モード以外では、スキルによる処理フローはすでにキー化された文字列をロックされたものとして扱います。まだ組み込まれていないリテラルにのみ着目し、既存のキーはそのまま維持します。移行の途中でも毎週リリースを続けているチームこそ、私たちのログにおける典型的な「混在型L1」ユーザーです。

複雑なツリーに対してエージェントがフルで変換を行った事例については、AIエージェントが実際のモノレポを国際化するとどうなるか?をご覧ください。

セットアップフローがとにかくすべてをスキャフォールドしてしまった場合、どうすればよいですか?

誤った判定フローに進まないよう検出ロジックの改善を進めていますが、もしnpx skills add globalize-now/globalize-skillsがすでに、ロケールフォルダを書き換え、頼んでいない言語切り替えUIを追加し、ルーティングの構成まで変えてしまうような100ファイル超のdiffを生成していた場合は、コミットしないでください。画面右下のフィードバックウィジェットから、package.jsonの依存パッケージ一覧と、ロケールフォルダの構成について簡単にお知らせください。こちらでリポジトリを手動でL1に振り分けることができます。セルフサービスで使える--existing-i18nのCLIフラグも近日中にリリース予定です。

お使いのマシン上での復旧は、git restore .に加えて、必要ならgit clean -fdで行えます。何もプッシュされておらず、本番環境に影響する問題も起きていません。エージェントが変更を加えたのは、ローカルブランチだけです。詳しい解説は、globalize_skillsが変更を加えすぎた:何が起きたのか?をご覧ください。

なぜ「i18nに挑戦したものの、途中で止まってしまった」が今や定番のストーリーになっているのでしょうか?

これはスローガンではなく、パターンです。6週間で3つの独立した初回セッションがあり、どれも「ええ、試したんですが、今はぐちゃぐちゃで」という話でした。数万人のユーザーを抱えるChrome拡張機能は、韓国からのトラフィック急増をきっかけにnext-intlへの移行に着手しましたが、中途半端なまま止まっていました。Lovableで作られたアプリは、多言語対応を追加しようとしてビルドが壊れ、元に戻されました。バイブコーディングで作られたReact + Viteのリポジトリは、i18nextを組み込み、キーの約3分の1を埋めたところで止まりました。

ライブラリ選定を待つだけの、完全にきれいなL0のコードベースというものも確かに存在しますが、それはボトルネックではありません。本当のボトルネックは、すでに一度この作業に挑戦していて、その後始末を誰も引き受けたがらないコードベースのほうです。

L1モードは、まさにそのようなコードベースのために存在します。

料金はいくらですか?

Starterは月額€20で、毎月€20分のクレジットが含まれます。クレジットは翻訳、QAレビュー、変換で消費され、期間末に使い切れなかった分は失効します。月額€249で€100分のクレジットが含まれるTeamプランもあります。新規の組織には、14日で失効する€5分のトライアルクレジットが一度だけ付与されます。L0でゼロから始める場合も、L1で3年分のロケールの負債を抱えている場合も、料金は同じです。課金はプロバイダーのコストに基づく従量制で、最初のコミットがどれだけ散らかっていたかは関係ありません。

次に読むべき記事やヘルプセンターのドキュメントはどれですか?

アクセス元のユーザーがすでに求めている言語を、すぐにリリースしましょう。globalize.nowでリポジトリを接続するか、Gitプッシュ連動の自動化が既存のチームワークフローにどう収まるかをご覧ください。

globalize.nowは、ハードコードされたアプリ内テキストを翻訳可能なロケールファイルに変換し、リリースのたびに自動で最新の状態を保ちます。

globalize.nowを無料で試す