Tambahkan library i18n runtime, konversi teks yang sudah ditulis Copilot, lalu cegah teks baru masuk. Langkah yang paling sering keliru adalah yang terakhir, karena file instruksi repositori tidak menjangkau semua surface tempat Copilot menulis kode. Chat dan coding agent membacanya. Inline autocomplete tidak. globalize.now adalah infrastruktur lokalisasi berbasis AI yang mengonversi codebase sekali jalan dan menghasilkan kunci serta file bahasa yang dibaca library i18n-mu.

Mengapa Copilot tetap menulis teks hardcode setelah aku menambahkan file instruksi?

Karena file instruksi tidak terhubung ke jalur tercepat. Dokumentasi VS Code menyatakan dengan jelas bahwa custom instructions tidak diperhitungkan untuk saran inline yang muncul saat kamu mengetik. Itulah mode yang dipakai kebanyakan orang sepanjang hari.

Jadi aturan yang kamu tulis memang berlaku, yaitu saat kamu bertanya ke Copilot di chat atau menyerahkan tugas ke coding agent. Aturan itu tidak berlaku saat kamu mengetik tag JSX lalu menekan Tab pada completion berwarna abu-abu. Keduanya menghasilkan kode yang di-commit. Hanya satu yang sudah membaca aturanmu.

Surface Copilot mana yang membaca instruksimu?

Ada tiga surface yang menulis kode ke repositorimu, dan perilakunya tidak sama.

SurfaceMembaca instruksi?Tempat hasilnya masuk
Inline completionTidakLangsung ke file yang sedang kamu edit
Chat dan agent modeYaPerubahan yang kamu tinjau di editor
Coding agentYaDraft pull request yang kamu tinjau

Coding agent adalah yang paling ramah untuk masalah ini. Kamu menugaskan sebuah issue, agen bekerja di latar belakang dan membuka draft pull request, sehingga hasilnya sampai di tempat yang sudah dilihat reviewer. Inline completion masuk tanpa gerbang apa pun.

Bagaimana cara menyiapkan i18n di proyek Copilot?

Pilih dulu library runtime yang dibutuhkan framework-mu: next-intl untuk Next.js App Router, react-i18next untuk aplikasi React lainnya, atau Lingui jika kamu ingin ekstraksi saat kompilasi dan katalog PO. Kami membandingkan ketiganya di next-intl vs react-i18next vs Lingui.

Copilot tidak terikat pada satu framework seperti Lovable atau Bolt. Artinya pilihan stack terbuka dan library-nya kamu yang menentukan. Yang tidak bisa ditawar adalah urutannya: pasang library, konversi teks yang sudah ada, baru pikirkan pencegahan. Aturan pencegahan di codebase yang 90 persen isinya masih teks bahasa Inggris hardcode tidak punya apa pun untuk diukur.

Apa saja yang perlu ada di .github/copilot-instructions.md?

File instruksi repositori di path tersebut terdeteksi otomatis dan diterapkan pada permintaan chat di workspace. Panduan resmi GitHub menyarankan agar setiap instruksi singkat dan berdiri sendiri, disertai alasannya, dan tidak memuat hal yang sudah ditegakkan linter. Bagian i18n yang mengikuti saran itu ringkas saja:

## User-facing text

- User-facing text belongs in the message catalog, never in a component literal.
- Use the translation function from our i18n library for every visible string.
- Reason: a literal cannot be translated and does not show up as a missing key,
  so it ships silently in one language.
- Add new English values to the source catalog only. Never hand-edit other locales.
- Not user-facing: test names, log lines, error codes, internal constants.

Baris terakhir lebih penting daripada kelihatannya. Aturan yang terlalu luas akan diabaikan, dan aturan yang menyuruh agen membungkus pesan log akan membuat agen menganggap seluruh bagian ini hanya gangguan. Kalau kamu belum punya file instruksi sama sekali, VS Code bisa membuat draf dari codebase-mu lewat perintah init di chat. Itu titik awal yang lebih baik daripada file kosong.

Bisakah file instruksi khusus path bekerja lebih baik?

Bisa, dan inilah satu fitur Copilot yang tidak dimiliki file aturan editor lain. File berakhiran .instructions.md yang disimpan di .github/instructions membawa glob applyTo di frontmatter-nya, dan hanya dimuat ketika agen menyentuh file yang cocok.

---
name: 'UI strings'
description: 'String handling rules for components'
applyTo: '**/*.{jsx,tsx}'
---
Every visible string in this file must come from the catalog.
Key format is feature.element.state, lowerCamelCase.
If you add a key here, add its English value to the source catalog in the same change.

Membatasi aturan ke file komponen membuatnya tetap kredibel. Aturan aktif di tempat teks untuk pengguna berada, dan diam di API route serta skrip migrasi. Kalau repositorimu sudah punya AGENTS.md atau CLAUDE.md di root, Copilot membaca keduanya sebagai instruksi yang selalu aktif. Jadi tim yang memakai beberapa agen tidak perlu satu file per tool.

Apa yang menangkap teks yang lolos dari instruksi?

Lint rule di CI, karena itulah satu-satunya lapisan di stack ini yang bisa menggagalkan build. Instruksi mengubah peluang; check yang gagal mengubah hasil. Kami membahas lapisan penegakan ini secara rinci di mengapa agen AI terus menambahkan teks hardcode, dan pengaturannya berlaku sama persis di repositori Copilot.

Tambahan khusus Copilot ada di pull request. Instruksi repositori berlaku untuk code review Copilot sekaligus chat, jadi file yang sama yang membentuk hasil generate juga membentuk komentar review pada draf PR dari coding agent. Hasilnya satu gerbang yang tidak bisa dilewati autocomplete inline, dan inilah solusi terdekat untuk celah yang disebut di awal tulisan ini.

Semua ini tidak melunasi utang yang sudah ada di repositori, dan tidak mengisi satu pun file bahasa. Menemukan teks literal saat review hanya memberi tahu bahwa ada string yang belum ada. Seseorang tetap harus membuat kuncinya, menerjemahkannya, dan menjaga bahasa lain agar tidak keluar dari sinkronisasi.

Di mana posisi globalize.now?

Di lapisan yang menghasilkan katalog, yaitu bagian yang tidak ditangani oleh library i18n maupun file instruksimu. Kamu menghubungkan repositori di aplikasi, lalu repositori itu dikonversi satu kali: teks hardcode diganti dengan kunci dan file bahasa dibuat. Setelah konversi satu kali itu, job push menerjemahkan unit katalog baru yang muncul dari commit-mu.

Outputnya JSON atau PO, jadi katalog langsung sesuai dengan format yang sudah dibaca library runtime-mu. Pendekatan yang sama berlaku untuk editor agentik lain: Claude Code dan Cursor mengalami kendala yang sama dari arah berbeda, dan ada panduan langkah demi langkah untuk codebase Next.js di menambahkan i18n ke aplikasi Next.js buatan AI. Dokumentasi developer membahas konversi ini lebih rinci, dan paketnya ada di halaman harga.

Ringkasnya

Tulis file instruksi, batasi aturan khusus path ke file komponen, dan pasang lint rule di CI. Dengan begitu, kesenjangan antara instruksi yang diberikan ke Copilot dan kode yang dihasilkannya menjadi build merah, bukan teks bahasa Inggris yang terlanjur rilis. Lalu konversi backlog satu kali, supaya aturan itu punya sesuatu yang konsisten untuk dilindungi.

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