Karena setup i18n-mu hanya ada di kepala dan konfigurasimu, bukan di kode yang dilihat agen. Cursor membuat ulang komponen dari konteks di depannya, dan teks JSX biasa adalah cara tercepat yang berjalan. Tidak ada yang menolak di repo, jadi literal itu ikut dirilis. globalize.now adalah infrastruktur lokalisasi berbasis AI yang menutup lingkaran ini: globalize.now mengekstrak teks baru, membuat kunci, dan menyinkronkan terjemahan di setiap Git push.

Inilah mode kegagalan yang jarang diperingatkan. Menyiapkan i18n bisa selesai dalam satu sore. Yang sulit adalah menjaganya tetap rapi saat agen menulis ulang komponenmu dua kali sehari.

Mengapa Cursor terus menambahkan teks hardcode setelah i18n disiapkan?

Ada tiga hal yang benar sekaligus, dan ketiganya bersama-sama menjamin kebocoran itu.

Agen melihat file, bukan konvensi. Saat kamu meminta Cursor menambahkan panel pengaturan, agen membaca komponen yang sedang diedit dan mungkin beberapa file di sekitarnya. Direktori locale, skema namespace, dan aturan bahwa setiap teks untuk pengguna harus lewat fungsi terjemahan tidak ada di jendela konteks itu, kecuali kamu memasukkannya.

Teks tanpa terjemahan adalah pola default secara statistik. Sebagian besar kode React di data pelatihan model apa pun menulis teks secara inline. Saat agen memilih token berikutnya yang paling mungkin untuk label tombol, Save changes mengalahkan t('settings.save') hanya karena lebih sering muncul. Kamu meminta agen memilih pola yang lebih jarang setiap kali, tanpa umpan balik jika ia tidak memilihnya.

Tidak ada yang rusak. Ini yang paling menentukan. Teks hardcode lolos type-check. Build berhasil. Tampil dengan benar. Lolos tes. Tidak ada tanda merah di pipeline yang memberi tahu bahwa pengguna di Jerman akan melihat toast berbahasa Inggris. Cacat ini tidak terlihat sampai seseorang mengganti bahasa dan menggulir halaman.

Bandingkan dengan import yang hilang atau tipe prop yang salah, yang dikoreksi agen dalam hitungan detik. Teks yang belum diterjemahkan adalah satu jenis bug yang diterima diam-diam oleh toolchain-mu, sehingga jenis bug inilah yang menumpuk.

Teks mana yang paling sering bocor?

Teks yang ditambahkan paling akhir, dengan pengawasan paling sedikit.

Telusuri codebase berbantuan AI mana pun yang awalnya multibahasa, dan teks bahasa Inggris yang tersisa ada di tempat-tempat yang mudah ditebak:

  • Toast error dan sukses, terutama yang ditambahkan saat memperbaiki bug yang tidak terkait
  • Empty state dan teks loading, yang ditulis sekali dan tidak pernah direview
  • Pesan validasi form, yang sering dibuat inline di dalam skema
  • Atribut aksesibilitas: aria-label, alt, title
  • Dialog konfirmasi dan teks untuk aksi destruktif
  • Apa pun di dalam blok catch

Polanya konsisten. Alur utamamu diterjemahkan karena kamu memeriksanya. Bagian pinggir di-hardcode karena tidak ada yang membukanya dalam bahasa kedua.

Ada juga versi turunannya. Saat agen menambahkan literal di samping kode yang sudah diterjemahkan, ia kadang “membantu” dengan membuat kunci yang tidak cocok dengan skema namespace-mu, sehingga kamu punya errors.saveFailed di satu file dan settings_save_error di file lain. Akibatnya ada teks yang belum diterjemahkan sekaligus ruang kunci yang terfragmentasi. Jika kamu masih di tahap awal, panduan kami tentang melokalisasi aplikasi buatan AI membahas pembersihan awalnya.

Bisakah .cursor/rules atau AGENTS.md mencegahnya?

Keduanya membantu dan sebaiknya kamu tulis, tetapi sifatnya panduan, bukan penegakan.

Lapisan file instruksi baru-baru ini distandarkan. AGENTS.md bermula sebagai konvensi netral vendor pada 2025 dan kini dikelola oleh Agentic AI Foundation di bawah Linux Foundation. File ini dibaca langsung oleh Cursor, Codex, Copilot, Gemini CLI, Aider, Windsurf, dan Zed, artinya satu file di root repo menjangkau setiap agen yang dipakai timmu. Cursor juga mendukung aturan proyek dengan cakupan tertentu sebagai file .mdc di bawah .cursor/rules/, dengan frontmatter yang mengatur deskripsi, glob file, dan apakah aturan selalu berlaku. Setup praktis di 2026 adalah AGENTS.md di root untuk portabilitas, ditambah aturan Cursor dengan cakupan tertentu di tempat auto-attach benar-benar berguna.

Blok i18n yang bisa dipakai kira-kira seperti ini:

## Internationalization

- Never write user-facing text as a literal in JSX or in a string passed to a UI component.
- All user-facing text goes through the translation function from `next-intl`.
- Keys follow `feature.element.state` in lowerCamelCase, e.g. `settings.save.error`.
- Add the English value to `messages/en.json` only. Never hand-edit other locale files.
- This includes toasts, empty states, validation messages, `aria-label`, `alt` and `title`.

Ini akan menurunkan tingkat kebocoran secara terukur. Namun tidak akan membuatnya nol, karena file aturan bersaing mendapat perhatian dengan semua hal lain di jendela konteks, dan sesi agen yang panjang mudah melenceng. Anggap lapisan ini sebagai pengurang frekuensi, bukan jaminan.

Bagaimana membuat teks yang belum diterjemahkan menggagalkan build?

Tambahkan aturan lint yang menganggap literal di JSX sebagai error, lalu jalankan di continuous integration.

Pilihan standarnya adalah aturan no-literal-string dari eslint-plugin-i18next. Secara default, aturan ini memvalidasi teks biasa di markup JSX, bukan setiap literal di dalam file, dan itulah yang membuatnya layak dipakai di codebase sungguhan, bukan menghasilkan tumpukan false positive. Aturan ini mendukung pola pengecualian dengan regular expression, pengecualian callee untuk fungsi yang kamu tahu aman, dan mode markup-only.

Konfigurasi awal:

// eslint.config.js
import i18next from 'eslint-plugin-i18next';

export default [
  {
    files: ['**/*.{jsx,tsx}'],
    plugins: { i18next },
    rules: {
      'i18next/no-literal-string': [
        'error',
        {
          markupOnly: true,
          ignoreAttribute: ['data-testid', 'className'],
          ignore: ['^[0-9]+$', '^\\s*$'],
        },
      ],
    },
  },
];

Jalankan di pipeline, bukan hanya di editor:

npx eslint . --max-warnings=0

Sekarang cacat yang tak terlihat itu punya tanda merah. Agen mendapat putaran umpan balik yang sama untuk teks yang belum diterjemahkan seperti yang sudah ia dapat untuk error tipe, sehingga ia bisa memperbaiki kesalahannya sendiri dalam sesi yang sama, bukan menunggu pengguna di bahasa lain menemukannya. Untuk gambaran lebih luas tentang memasang i18n di proyek Cursor dari nol, lihat panduan 15 menit Cursor dan Next.js dan halaman integrasi Cursor.

Mengapa aturan lint yang gagal belum cukup?

Karena build merah hanya memberi tahu bahwa ada teks. Build itu tidak menerjemahkannya.

Setelah aturan terpicu, tetap ada yang harus memilih kunci yang cocok dengan namespace yang sudah ada, menambahkan nilai sumber bahasa Inggris, dan membuat terjemahan untuk bahasa lain. Di proyek solo yang rilis beberapa kali sehari, pekerjaan itu akhirnya ditunda. Ditunda cukup lama, perbaikan yang jujur berubah menjadi menambahkan file ke daftar pengecualian, dan kamu kembali ke titik awal dengan konfigurasi tambahan.

Celah inilah yang mengubah masalah yang sudah terselesaikan menjadi utang berulang. Lapisan satu dan dua mengubah seberapa sering masalah muncul dan seberapa cepat kamu tahu. Keduanya tidak mengerjakan pekerjaannya.

Seperti apa setup tiga lapisan itu?

Instruksi, penegakan, otomatisasi. Setiap lapisan menangkap apa yang terlewat oleh lapisan sebelumnya.

Lapisan satu, instruksi. Tulis blok i18n di AGENTS.md di root repo, lalu tambahkan .cursor/rules/i18n.mdc dengan glob untuk direktori komponenmu. Biaya: lima belas menit, sekali saja. Efek: lebih sedikit literal yang ditulis sejak awal.

Lapisan dua, penegakan. Aktifkan no-literal-string dan gagalkan continuous integration karenanya. Biaya: satu sore untuk menyesuaikan pola pengecualian di codebase yang sudah ada. Efek: tidak ada literal yang masuk ke branch utama tanpa terdeteksi, dan agen bisa mengoreksi dirinya sendiri.

Lapisan ketiga, otomatisasi. Biarkan ekstraksi, pembuatan kunci, dan terjemahan berjalan tanpa campur tanganmu. Ini lapisan yang ditempati globalize.now. globalize.now berada di atas runtime i18n-mu, bukan menggantikannya: next-intl atau i18next tetap merender teksnya. globalize.now mendeteksi teks hardcode baru, membuat kunci yang konsisten dengan namespace yang sudah ada di proyekmu, menerjemahkannya ke semua bahasa yang dikonfigurasi, lalu meng-commit file bahasa yang diperbarui setiap kali kamu push ke Git. Siapkan sekali (hubungkan repositori di globalize.now) dan tidak ada langkah manual yang bisa terlewat. Kamu juga bisa memasangnya ke agenmu dengan:

npx skills add globalize-now/globalize-skills

Paket mulai dari €20 per bulan; Starter mencakup kredit €20 setiap bulan, dan pemakaian di atas itu dibebankan ke saldo kreditmu dengan biaya provider ditambah markup. Tanpa biaya per seat, per bahasa, atau per proyek, dan saat mendaftar kamu mendapat kredit percobaan €5 yang kedaluwarsa setelah 14 hari, tanpa kartu. Detail lebih teknis untuk engineer ada di halaman developer, dan versi lebih singkat untuk yang merilis dengan tool AI ada di halaman vibe coder.

Inti dari tiga lapisan ini adalah tidak ada satu pun yang bergantung pada disiplinmu bertahan di seratus sesi agen. File aturan menurunkan frekuensi kesalahan, aturan lint membuat kegagalan tidak bisa diabaikan, dan sinkronisasi membuat perbaikannya gratis. Kombinasi inilah yang menjaga aplikasi multibahasa tetap multibahasa saat agen terus menulis ulang kodenya.

Setup i18n-mu bukan bagian yang rapuh. Yang rapuh adalah alur antara agen menulis sebuah teks dan teks itu sampai ke file bahasa. globalize.now menutup celah itu di setiap push.

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