Agen mengekstrak 28 kandidat teks UI, menulis ulang 41 entri terjemahan di berbagai file, mengonfigurasi middleware dan routing, serta membuat file bahasa untuk 5 bahasa target. Setup, konversi, dan terjemahan memakan waktu sekitar 90 menit dari awal sampai akhir. globalize.now adalah infrastruktur lokalisasi berbasis AI, dan kami menjalankannya di monorepo produksi untuk melihat apa yang benar-benar terjadi. Bukan demo yang dikurasi. Tanpa jaring pengaman. Hanya basis kode sungguhan dengan kompleksitas sungguhan.

Basis kode itu milik seorang veteran industri lokalisasi yang lebih dari sepuluh tahun menjadi arsitek di salah satu platform manajemen terjemahan terkemuka.

Apa isi monorepo itu?

Ini bukan proyek tutorial. Monorepo tersebut berisi aplikasi web Next.js, aplikasi Android, server MCP, dan dokumentasi yang dirender oleh layanan pihak ketiga. Developer-nya memakai Claude Code setiap hari, membangun dengan tooling AI dari ujung ke ujung, dan menyusun seluruh stack dalam tiga bulan.

Targetnya adalah frontend Next.js. Aplikasi Android, server MCP, dan situs dokumentasi yang dibangun dengan Mintlify tidak boleh disentuh sama sekali. Pertanyaannya: apakah agen AI bisa memahami hal itu tanpa diberi tahu secara eksplisit?

Ternyata bisa. Agen memindai seluruh repo dan fokus pada aplikasi Next.js. Dalam praktiknya tidak perlu pembatasan cakupan manual, meski developer-nya mengaku akan lebih tenang kalau bisa menyatakan “konversi hanya /apps/web”. Masukan yang wajar dan layak kami tambahkan, tetapi hal itu tidak menghambat konversi.

Bagaimana proses konfigurasinya?

Developer memilih mode terpandu untuk memahami prosesnya. Konfigurasi mencakup lima keputusan: package manager (NPM, meski ada lockfile PNPM lama), format katalog (PO/GetText, direkomendasikan karena mendukung komentar), mode setup (terpandu), bahasa sumber (bahasa Inggris), dan bahasa target (bahasa Spanyol, Italia, Hungaria, Ceko, Slovakia).

Satu hal yang patut dicatat: pertanyaan tentang format katalog membuat ragu, bahkan bagi orang yang sangat ahli di bidang lokalisasi. Reaksinya lugas. Menurutnya pilihan itu tidak cukup penting untuk ditanyakan ke pengguna. Otomatiskan saja.

Strategi routing berbasis path. Tidak memakai routing berbasis domain karena developer tidak punya domain tambahan. Aplikasi memakai autentikasi berbasis OAuth, sehingga alur login sengaja tetap berbahasa Inggris. Agen menanganinya dengan benar.

Apa sebenarnya yang dikerjakan langkah konversi?

Inilah bagian yang terpenting. Agen mengidentifikasi 28 kandidat teks UI di aplikasi Next.js dan memproses 41 entri terjemahan. Agen menata ulang file, memperbarui middleware, mengubah import komponen, dan membuat file bahasa PO untuk kelima bahasa target.

Langkah konversi saja memakan waktu sekitar 30 menit. Tambahkan setup dan konfigurasi sebelumnya, ditambah developer menyelesaikan koneksi terjemahan sendiri sesudahnya, maka keseluruhan proses mendekati 90 menit. Memang tidak instan. Sebagai pembanding, aplikasi sederhana dengan beberapa halaman menyelesaikan seluruh alur dalam waktu kurang dari 15 menit. Aplikasi kompleks dengan puluhan area yang perlu diterjemahkan butuh waktu lebih lama. Waktunya mengikuti jumlah teks, bukan ukuran repo.

Developer menyaksikan langkah konversi berjalan dan berkata: ekstraksi teks dan penulisan ulang kode adalah pekerjaan terberatnya. Inilah pekerjaan yang paling dihindari developer. Di perusahaan sebelumnya, sebuah TMS terkemuka, file terjemahan di repo hanyalah puncak gunung es. Persiapan dan pekerjaan internasionalisasi adalah bagian yang paling menyakitkan. Dan agen AI menangani persis bagian itu.

Ini sejalan dengan apa yang kami dengar dari setiap developer yang pernah mengerjakan i18n secara manual. Tidak ada yang mengeluhkan terjemahannya. Yang dikeluhkan adalah harus membuka 40 file untuk membungkus teks dengan pemanggilan t(), membuat kunci yang masuk akal, menata ulang import, dan mengonfigurasi middleware. Pekerjaan inilah yang diotomatiskan globalize.now.

Apakah benar-benar berjalan dari ujung ke ujung?

Ya. Setelah sesi langsung selesai, developer menuntaskan langkah-langkah sisanya sendiri. Ia mem-publish branch Git globalize.now, menghubungkan aplikasi ke platform web, mengatur pemantauan ke branch globalize.now, lalu memastikan file terunggah dan terjemahan benar.

Penilaiannya terhadap kualitas terjemahan bahasa Ceko: hampir sempurna. Ini datang dari orang yang seumur kariernya menilai hasil lokalisasi secara profesional. Itu bukan sekadar acungan jempol biasa. Itu konfirmasi dari pakar bidangnya bahwa kualitasnya layak produksi untuk pasangan bahasa yang tidak sederhana.

Ia menandai dua masalah di aplikasi web setelah menyelesaikan alur secara mandiri. Pertama, pemindaian ulang repo menampilkan “tidak ada file i18n yang terdeteksi” padahal job terjemahan sebenarnya sedang berjalan di latar belakang. Status UI yang menyesatkan, bukan kegagalan sungguhan. Kedua, job terjemahan dimulai tanpa persetujuan eksplisit. Setiap tindakan yang memakai kredit seharusnya meminta konfirmasi. Keduanya masalah UX yang valid dan sedang kami perbaiki.

Apa yang tidak berjalan lancar?

Ada yang rusak. Ini pengujian sungguhan, jadi kami akan jujur soal itu.

Perintah instalasi (npx skills add globalize-now/globalize-skills) gagal di Windows PowerShell. Ini pertama kalinya tool ini diuji di Windows. Skill harus dikirim sebagai file zip lewat Swiss Transfer setelah Google memblokir lampiran email. Total hambatan setup: sekitar 15 menit sebelum alur sebenarnya dimulai.

Konflik ES modules vs. CommonJS muncul di tengah konversi. Proyek ini memakai CommonJS, sedangkan output agen mengasumsikan ES modules di satu bagian. Bukan penghambat, tetapi seharusnya terdeteksi saat setup dan ditangani secara proaktif.

Di akhir sesi, saat menghubungkan repositori GitHub di aplikasi web globalize.now, yang muncul hanya halaman kosong. Developer memakai Opera. Tidak ada layar login, tidak ada error, tidak ada konten. Sesi berakhir sebelum masalah ini terselesaikan.

Tiga bug. Semuanya nyata. Semuanya sudah diperbaiki atau sedang dikerjakan.

Mengapa ekstraksi teks menjadi hambatan sebenarnya?

Sebagian besar konten i18n membahas kualitas terjemahan, konfigurasi framework, atau perbandingan fitur TMS. Itu melewatkan titik tempat developer benar-benar kehilangan waktu.

Menambahkan internasionalisasi ke basis kode yang sudah ada berarti memindai setiap komponen untuk mencari teks hardcode, menentukan teks mana yang perlu diterjemahkan, membuat kunci terjemahan yang bermakna, membungkus setiap teks dengan pemanggilan t() atau <Trans> yang sesuai, memperbarui import di seluruh struktur file, membuat file bahasa awal, dan mengonfigurasi middleware routing. Untuk monorepo, ada kerumitan tambahan: menentukan bagian mana dari basis kode yang memang perlu i18n.

Pekerjaan ini membosankan, rawan kesalahan, dan persis jenis pekerjaan yang dikuasai agen AI. Developer yang menyaksikannya langsung menyimpulkannya dengan jelas: dari sudut pandang developer, inilah pekerjaan terberatnya. Ini kelegaan besar. Vibe coder yang membangun dengan tool AI kini bisa melewati bagian terburuk dari proses go international.

Apa yang kami pelajari tentang pembatasan cakupan di monorepo?

Agen menangani pembatasan cakupan monorepo secara implisit. Agen fokus pada aplikasi web Next.js dan mengabaikan kode Android, server MCP, dan dokumentasi Mintlify tanpa diminta. Itu perilaku yang tepat untuk sebagian besar kasus.

Namun cakupan implisit tidak sama dengan cakupan eksplisit. Developer menginginkan kemampuan untuk menyatakan “konversi hanya aplikasi Next.js saya” sebagai langkah konfigurasi. Di monorepo dengan beberapa frontend web, misalnya aplikasi untuk pelanggan dan dashboard admin, kamu pasti ingin kontrol yang presisi atas frontend mana yang diinternasionalisasi lebih dulu.

Ini celah produk yang sedang kami tutup. Untuk saat ini, agen sudah melakukannya dengan benar dalam praktik. Pembatasan cakupan eksplisit seharusnya menjadi langkah konfigurasi, terutama ketika konversi menyentuh puluhan file.

Bagaimana perbandingannya dengan setup i18n manual?

Setup i18n manual pada basis kode sekompleks ini memakan waktu berhari-hari. Bukan karena satu langkahnya sulit, melainkan karena ada puluhan langkah dan masing-masing butuh perhatian. Satu teks terlewat, dan kamu merilis halaman yang baru setengah diterjemahkan. Salah menamai kunci, dan muncul entri duplikat yang menghantui selama berbulan-bulan. Lupa memperbarui middleware, dan routing bahasamu rusak tanpa suara.

Agen AI menyelesaikan pekerjaan setara dalam sekitar 90 menit dari awal sampai akhir. Developer-nya, yang secara profesional sudah melihat ribuan implementasi i18n, menyebutnya elegan.

Bagi developer yang membangun dengan tool AI, ini mengubah perhitungan kapan harus menambah bahasa. Kalau setup i18n butuh seminggu, kamu menundanya sampai product-market fit terbukti. Kalau hanya 90 menit, kamu bisa merilis multibahasa sejak hari pertama.

globalize.now menangani ini. Hubungkan repositori dan konversi berjalan sekali, di aplikasi; skill npx skills add globalize-now/globalize-skills menangani langkah berikutnya di editormu. Lihat cara kerjanya di globalize.now.

globalize.now mengubah teks hardcode di aplikasimu menjadi file locale yang siap diterjemahkan, lalu menjaganya tetap diperbarui setiap kali kamu rilis.

Coba globalize.now gratis