Periksa tujuh hal sebelum merilis aplikasi yang diterjemahkan Codex, Claude Code, atau Cursor dalam satu prompt: apakah teks panjang masih muat, apakah bentuk plural sesuai dengan tiap bahasa, apakah variabel masih utuh, apakah istilah tetap konsisten, apakah nadanya terdengar wajar bagi penutur asli, apakah setiap kunci ada di setiap locale, dan apakah fitur berikutnya akan ikut diterjemahkan. globalize.now adalah infrastruktur lokalisasi berbasis AI, dan sebagian besar masalah yang kami temukan setelah terjemahan sekali jalan bersifat mekanis. Ini kabar baik, karena masalah mekanis bisa diperiksa.

Terjemahan pertama jarang jadi masalah. Agen modern menghasilkan terjemahan yang enak dibaca dengan cepat. Yang tidak ada dalam satu prompt adalah langkah yang memverifikasi hasilnya, dan pemeriksaan-pemeriksaan ini adalah langkah itu.

Apakah teks masih muat setelah diterjemahkan?

Sering kali tidak, dan tombol yang paling dulu bermasalah. Panduan W3C tentang ukuran teks dalam terjemahan menyebutkan bahwa semakin pendek pesan sumber, semakin besar kemungkinan ekspansinya, sehingga label tombol dua kata bertambah panjang secara proporsional lebih besar daripada satu paragraf. Panduan itu juga menyebutkan bahwa kata majemuk di bahasa seperti Jerman bisa tidak terputus ke baris baru, dan beberapa aksara membutuhkan ruang horizontal atau vertikal lebih besar daripada huruf Latin.

Agen yang menerjemahkan teks di file JSON tidak pernah melihat layar, jadi ia tidak tahu bahwa “Save changes” kini memenuhi tombol dari ujung ke ujung. Jalankan aplikasi di bahasa terpanjang yang kamu rilis, telusuri alur utamanya, lalu cari teks yang terpotong, teks tombol yang turun ke baris berikutnya, dan header tabel yang tidak utuh. Kalau kamu mendukung bahasa right-to-left, lakukan pemeriksaan yang sama di salah satunya; panduan bahasa Arab dan RTL untuk aplikasi Lovable membahas arah teks, yang tidak tertangkap oleh pemeriksaan overflow saja.

Perbaikan yang tahan lama ada di layout, bukan di terjemahan yang dipersingkat: biarkan container tumbuh, hindari lebar tetap pada teks, dan berhenti menyingkat kata demi muat. Serahkan bagian ini ke agenmu, karena ini urusan kode.

Apakah bentuk plural sesuai dengan bahasa tujuan?

Periksa ini sejak awal, karena kegagalannya diam-diam. Unicode CLDR mendefinisikan enam kategori plural: zero, one, two, few, many, dan other. Bahasa Inggris hanya memakai one dan other. Bahasa Rusia memakai one, few, many, dan other. Bahasa Wales memakai keenamnya, dan dokumentasi i18next menunjukkan bahasa Arab juga memakai keenam kunci plural.

Agen yang menyalin pasangan kunci bahasa Inggris ke file bahasa Rusia atau Arab menghasilkan katalog yang bisa di-parse dan dirender, tetapi menampilkan bentuk yang salah untuk setiap angka yang butuh kategori yang tidak ada di file. Tidak ada error. Di i18next, ingat bahwa variabelnya harus bernama count persis, dan dokumentasi menyatakan tidak ada fallback ke kunci biasa jika variabel itu hilang. Agen yang sama yang menulis count === 1 ? 'item' : 'items' di sebuah komponen sudah membawa bug yang sama bahkan sebelum terjemahan dimulai; apa itu ICU MessageFormat dan mengapa sering membuat aplikasi buatan AI bermasalah membahas sisi sintaksnya.

Pemeriksaannya mekanis: untuk setiap locale, bandingkan kunci plural dengan kategori yang dibutuhkan bahasa tersebut.

Apakah variabel interpolasi masih utuh?

Tidak selalu, dan sebuah skrip bisa memastikannya. Variabel interpolasi seperti {{name}} atau {count} harus muncul di setiap terjemahan persis seperti aslinya. Agen yang menerjemahkan file panjang kadang menulis ulang nama variabel, menghapus satu variabel karena kalimatnya terasa lebih enak tanpa itu, atau menerjemahkan isi sebuah tag. Hasilnya berupa tampilan kosong, kurung kurawal mentah, atau aplikasi crash.

Bandingkan kumpulan variabel di setiap teks terjemahan dengan teks sumbernya. Skrip Node pendek ini melakukannya, dan sekaligus melaporkan kunci yang ada di bahasa Inggris tetapi tidak ada di locale lain:

import fs from "node:fs";

const [src, ...targets] = process.argv.slice(2);
const read = (f) => JSON.parse(fs.readFileSync(f, "utf8"));
const vars = (s) =>
  [...String(s).matchAll(/\{\{?\s*[\w.]+\s*\}?\}/g)].map((m) => m[0]).sort().join(",");

const base = read(src);
let problems = 0;
for (const file of targets) {
  const loc = read(file);
  for (const [key, text] of Object.entries(base)) {
    if (!(key in loc)) { console.log(file, "missing", key); problems++; continue; }
    if (typeof text === "string" && vars(text) !== vars(loc[key])) {
      console.log(file, "variable mismatch", key); problems++;
    }
  }
}
process.exit(problems ? 1 : 0);

Jalankan sebagai node check-locales.mjs locales/en.json locales/de.json locales/ru.json di CI. Skrip ini mengasumsikan file kunci satu tingkat; sesuaikan loop-nya kalau katalogmu bersarang.

Apakah terminologinya konsisten?

Konsisten dalam satu respons, tetapi menyimpang dari satu respons ke respons berikutnya. Kalau terjemahan aplikasi besar dipecah ke beberapa file, sesi, atau batch, tidak ada yang memastikan “workspace”, “project”, dan nama produkmu diterjemahkan sama setiap kali. Akhirnya ada tombol yang menulis satu istilah dan halaman bantuan yang menulis istilah lain.

Tuliskan istilah sekali saja: glosarium berisi nama produk, nama fitur, dan kata yang tidak boleh diterjemahkan, lalu pastikan langkah terjemahan membacanya. globalize.now membuat glosarium bersama saat codebase dikonversi, sehingga istilah sudah ada sebagai data sebelum terjemahan apa pun berjalan. Tanpa tool, minimal sediakan file glosarium singkat yang dirujuk dari instruksi agenmu; artikel tentang aturan AGENTS.md menunjukkan di mana instruksi itu ditaruh.

Apakah terdengar wajar bagi penutur asli?

Inilah satu-satunya pemeriksaan yang tidak bisa dilakukan skrip. Register, tingkat formalitas, dan huruf kapital adalah hal-hal yang membuat terjemahan sekali jalan terasa buatan mesin: tingkat sapaan formal yang keliru, tombol imperatif yang terdengar seperti perintah, atau judul kapital semua dalam bahasa yang memaknainya sebagai berteriak.

Jangan tinjau setiap teks. Pilih satu bahasa untuk tiap rumpun bahasa yang kamu rilis, lalu minta penutur asli membaca layar first-run, alur checkout atau pendaftaran, dan pesan error. Di layar-layar inilah nada bahasa bisa membuatmu kehilangan pengguna. Catat koreksi mereka di glosarium agar proses berikutnya mulai dari sana.

Apakah setiap kunci ada, dan apakah setiap teks sudah masuk ke katalog?

Ada dua celah berbeda yang tampak sama di layar. Sebuah kunci bisa ada di bahasa Inggris tetapi hilang di satu locale, dan itu tertangkap oleh skrip di atas. Atau sebuah teks bisa saja di-hardcode di komponen dan tidak pernah masuk katalog, sehingga tidak ada terjemahan yang bisa mencakupnya. Agen lebih sering meninggalkan jenis kedua di atribut, toast, dan pesan error daripada di teks yang terlihat; mengapa agen terus menambahkan teks hardcode membahas polanya dan aturan lint yang menangkapnya.

Ganti aplikasi ke locale non-Inggris lalu telusuri semua layarnya. Teks bahasa Inggris yang tersisa berarti kunci yang hilang atau teks yang tidak pernah masuk ke sistem, dan perbaikannya berbeda.

Apakah fitur berikutnya akan ikut diterjemahkan?

Hanya jika terjemahan menjadi bagian dari cara kode dirilis, dan inilah pemeriksaan yang tidak bisa dilewati oleh proses satu prompt. Prompt itu menerjemahkan aplikasi sebagaimana kondisinya sore itu. Fitur berikutnya yang dibuat agenmu datang dalam bahasa Inggris, di file yang sama, dan locale tertinggal satu fitur demi satu fitur. Mengapa file terjemahan tidak sinkron menjelaskan bagaimana ini menumpuk.

Di sinilah pendekatan sekali jalan dan pipeline berpisah jalan. Lokalisasi yang bergeser ke hulu, masuk ke dev loop menguraikan argumennya; versi praktisnya: konversi dilakukan sekali, dan perubahan berikutnya diterjemahkan di tempat perubahan itu dibuat. Dengan globalize.now, kamu menghubungkan repositori di aplikasi, codebase dikonversi sekali, lalu job push menerjemahkan unit katalog baru, dengan hasil yang dikirim sebagai perubahan untuk kamu tinjau dan merge. Library runtime dan format katalog tetap milikmu. Tim yang sudah punya penerjemah manusia tetap mempertahankan langkah tinjauan itu; bedanya, langkah itu tidak lagi menjadi satu-satunya penghalang antara kode yang hanya berbahasa Inggris dan rilis.

Kalau kamu lebih suka mengerjakannya dengan skripmu sendiri, minimalnya adalah skrip di atas yang berjalan di CI plus aturan bahwa teks baru harus lewat katalog. Cara melokalisasi aplikasi buatan AI menelusuri seluruh alurnya, dan panduan Claude Code membahas agen tersebut secara khusus.

Mulai dari mana?

Jalankan skrip itu pada file bahasamu hari ini; hanya butuh semenit dan langsung menunjukkan apakah strukturnya sehat. Lalu buka aplikasi di bahasa terpanjangmu dan telusuri alur first-run. Kalau kamu merilis aplikasi buatan AI dan ingin konversi, terjemahan, serta pembaruan berikutnya ditangani tanpa perawatan manual, halaman vibe coder adalah gambaran umumnya, referensi developer membahas setup agen, dan harga ada di halaman tersendiri.

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