Lovable membaca aturan i18n dari tiga tempat: knowledge workspace dan proyek, yang selalu ada di konteks; skill, yang dimuat hanya ketika prompt cocok dengan deskripsinya; dan file instruksi di repositori yang terhubung, di mana AGENTS.md di root dibaca berapa pun lamanya percakapan berjalan. Taruh aturan di tempat yang salah, dan aplikasi yang minggu lalu sudah kamu terjemahkan akan merilis fitur berikutnya dalam bahasa Inggris. globalize.now adalah infrastruktur lokalisasi berbasis AI, jadi kami melihat dampak kesalahan ini di banyak repositori Lovable; solusinya sebagian besar soal tahu permukaan mana yang dibaca kapan.

Mengapa aplikasi Lovable yang sudah diterjemahkan kembali ke bahasa Inggris?

Karena instruksi yang membuatnya multibahasa tidak ada di depan agen saat menulis komponen berikutnya. Lovable hanya mengerjakan prompt yang tampil di layar. Kalau prompt itu berbunyi “tambahkan bagian testimoni” dan tidak ada apa pun di konteks yang menyatakan “setiap teks yang terlihat pengguna harus melewati <Trans>”, judulnya akan masuk sebagai literal, persis seperti di proyek baru.

Ini bukan masalah yang sama dengan katalog yang tertinggal dari kode, yaitu kegagalan sinkronisasi yang dibahas di mengapa terjemahan aplikasi Lovable-mu rusak setiap kali kamu rilis. Sinkronisasi memindahkan teks yang sudah dibungkus ke file bahasa. Ia tidak bisa memindahkan teks yang tidak pernah dibungkus. Pertanyaan di hulunya adalah apa yang dibaca Lovable saat menulis kode, dan dokumentasi Lovable sangat spesifik soal ini.

Apa sebenarnya yang dibaca Lovable sebelum mengedit?

Menurut dokumentasi knowledge-nya, knowledge proyek, knowledge workspace, dan file instruksi di repositori Git seperti AGENTS.md atau CLAUDE.md semuanya memandu agen, di samping kode proyek. Skill terpisah dan dimuat sesuai kebutuhan.

Ketiganya berbeda dalam tiga hal yang penting untuk i18n.

Kapan dibaca. Knowledge disertakan di setiap pesan. Skill hanya disertakan ketika permintaan cocok dengan deskripsinya. AGENTS.md di root, dalam kata-kata Lovable, selalu dibaca berapa pun panjang sesinya.

Seberapa tahan dalam chat panjang. Dokumentasi Lovable mencantumkan catatan eksplisit bahwa dalam percakapan yang sangat panjang dengan banyak konteks, instruksi knowledge mungkin tidak selalu diikuti secara konsisten. Halaman yang sama menyatakan hal sebaliknya untuk AGENTS.md di root. Asimetri itulah alasan tulisan ini ada.

Siapa yang bisa mengeditnya. Knowledge workspace hanya untuk owner dan admin. Knowledge proyek bisa diedit siapa pun yang punya hak edit di proyek. File di repositori diedit oleh siapa saja yang bisa push, termasuk agen Lovable sendiri.

Setiap level knowledge menampung hingga 10.000 karakter. Itu cukup untuk sebuah penunjuk, tetapi jauh dari cukup untuk seluruh aturan setelah kamu juga memasukkan catatan arsitektur, skema database, dan gaya bahasa brand.

Jadi, di mana aturan i18n sebaiknya ditaruh?

Di repositori, dengan penunjuk singkat di knowledge. Alasannya mengikuti perbandingan di atas.

AGENTS.md di root repo memuat aturan lengkap. File ini dibaca di setiap pesan berapa pun panjang sesinya, tersimpan di Git sehingga bertahan di chat baru, kolaborator baru, dan saat pindah ke agen lain, serta tidak punya batas karakter yang bersaing dengan konteks proyek lainnya. Saat skill lovable-i18n menjalankan setup, fase ketiganya menulis persis file ini: blok aturan Lingui di antara penanda <!-- lovable-i18n:rules:start --> dan <!-- lovable-i18n:rules:end -->, dibuat jika file belum ada, ditambahkan jika sudah ada, dan diganti di antara penanda saat dijalankan ulang sehingga tidak ada yang terduplikasi.

Knowledge proyek memuat penunjuk dua baris. Misalnya:

Localization
- This app is localized with Lingui. Every user-visible string is wrapped
  (<Trans>, t``, msg``) and new strings are appended to src/locales/*/messages.po.
- The full rules are in AGENTS.md at the repo root. Follow them on every edit.

Penunjuk ini ada untuk kasus yang diperingatkan dokumentasi. Jika percakapan panjang melemahkan blok knowledge, agen masih punya file repo; kalau karena suatu alasan file repo tidak ada di konteks, penunjuk itu menyebutkan batasannya. Dua sumber, satu aturan.

Knowledge workspace hanya jika semua proyek memakai library yang sama. Knowledge workspace berlaku untuk semua proyek di workspace dan hanya ada satu. Kalau separuh proyekmu memakai Lingui dan separuhnya library lain, aturan Lingui di level workspace salah untuk separuhnya, dan Lovable memang dianjurkan memprioritaskan knowledge proyek saat terjadi konflik. Simpan knowledge workspace untuk aturan yang berlaku di mana saja: tombol dengan sentence case, tanpa console.log, komentar kode dalam bahasa Inggris.

Skill bukan rumah untuk aturan. Ini mengejutkan orang yang baru mengimpornya. Skill dimuat ketika prompt cocok dengan deskripsinya, jadi lovable-i18n ada di konteks saat kamu meminta setup i18n dan tidak ada saat kamu meminta halaman checkout. Ini memang disengaja; skill yang dimuat di setiap pesan hanya akan menjadi knowledge. Tugas skill adalah menulis aturan yang tahan lama ke repo satu kali, lalu menyingkir.

Apa isi aturan di AGENTS.md?

Aturan itu menjawab pertanyaan yang sering salah dijawab agen kalau hanya disuruh “pakai i18n”. Blok yang ditulis skill terdiri dari enam bagian.

Macro mana yang dipakai. Sebuah daftar keputusan: teks yang berubah menurut angka memakai <Plural> atau plural ICU; teks JSX memakai <Trans>; nilai atribut dan teks di event handler seperti toast memakai t yang dikembalikan useLingui(); konstanta di level modul memakai msg dan diselesaikan di dalam komponen. Aturan ini juga menyebut path import tiap macro, karena import t yang salah akan mengikat instance global yang tidak pernah dimuat aplikasi.

Interpolasi. Hanya variabel polos yang menamai slot-nya sendiri di pesan hasil ekstraksi. Ekspresi lain diekstrak sebagai {0}, yang tidak bisa dikerjakan penerjemah, jadi aturan mewajibkan ph() untuk memberinya nama.

Plural. other selalu wajib, kategori mengikuti CLDR, dan ternary antara dua string dilarang karena menanamkan aturan plural bahasa Inggris ke dalam komponen. Kalau kamu ingin latar belakangnya, apa itu ICU MessageFormat membahas sintaks yang menjadi hasil kompilasi bentuk plural.

Angka dan tanggal. i18n.number() dan i18n.date(), jangan pernah toFixed() atau simbol mata uang yang digabungkan ke nilai. Contoh knowledge workspace dari Lovable sendiri memuat bagian lokalisasi yang menetapkan format tanggal dan format angka Eropa. Itu insting yang bagus, tetapi itu aturan format, bukan aturan pembungkusan. Aplikasi bisa mengikutinya dengan sempurna dan tetap merilis setiap judul dalam bahasa Inggris.

Komentar untuk penerjemah. Teks pendek dengan beberapa kemungkinan makna, label aksi yang berdiri sendiri, dan istilah domain diberi comment= yang menjelaskan di mana teks itu muncul. context= dikhususkan untuk teks yang sama yang butuh terjemahan berbeda di tempat berbeda.

Perawatan katalog. Setiap teks baru dibungkus dan ditambahkan ke setiap src/locales/*/messages.po dengan msgstr kosong, sehingga Lingui memakai teks sumber sampai terjemahan tiba. Agen tidak pernah menjalankan lingui extract, karena Lovable tidak punya terminal; GitHub Action yang melakukannya setelah sinkronisasi. Agen juga tidak pernah mengedit baris komentar #. dan #: pada entri yang sudah ada, karena ekstraksi membuatnya ulang.

Bagian terakhir itulah yang membuat aturan ini khas Lovable. File aturan untuk Cursor atau Claude Code bisa ditutup dengan “jalankan linter”. File aturan Lovable tidak bisa, jadi harus menyebutkan apa yang dikerjakan manual dan apa yang diserahkan ke CI.

Apa yang menegakkan aturan saat Lovable tidak bisa menjalankan apa pun?

Alur kerja GitHub, dan hanya alur kerja GitHub. Lovable tidak punya terminal, jadi tidak ada langkah lint antara agen menulis literal dan perubahan tersinkronisasi ke repositorimu. Inilah perbedaan struktural dengan agen IDE, di mana aturan lint di CI membuat build gagal karena teks hardcode.

Jika kamu memilihnya saat setup, skill menambahkan workflow GitHub Actions yang berjalan pada setiap push ke default branch (tempat hasil sinkronisasi Lovable masuk), mengekstrak teks yang sudah dibungkus ke katalog, lalu meng-commit sinkronisasi katalog itu kembali ke repositori. Jika aplikasi GitHub tidak punya izin workflows, skill meminta kamu menambahkan file secara manual di GitHub. Itu menutup siklus untuk semua yang dibungkus agen, tetapi tidak berpengaruh pada teks yang tidak dibungkus agen, karena ekstraksi hanya melihat macro.

Jadi gambaran jujurnya: aturan di AGENTS.md mengurangi seberapa sering literal tak terbungkus muncul, penunjuk di knowledge menopangnya di chat panjang, dan diff di GitHub adalah tempat kamu menangkap sisanya. Kalau ingin mesin yang menangkap sisanya, tambahkan aturan no-literal-string dari eslint-plugin-i18next sebagai satu langkah di workflow yang sama. Aturan itu berjalan di repositori, satu-satunya tempat proyek Lovable bisa menjalankan apa pun.

Bagaimana nasib teks yang berhasil dibungkus?

Teks itu perlu diterjemahkan, dan itulah bagian yang layak diotomatisasi, bukan di-prompt ulang. Konversi dilakukan sekali dan terjadi di aplikasi: hubungkan repositori, dan globalize.now mengonversi codebase satu kali, lalu mengirim katalog sebagai pull request yang kamu tinjau. Setelah itu, job push menerjemahkan unit katalog baru begitu masuk, sehingga <Trans> yang ditulis Lovable hari Selasa sudah punya terjemahannya di pull request pada hari Rabu. Tanpa langkah dashboard, tanpa ekspor, tanpa antrean persetujuan; argumen lebih panjang untuk pendekatan ini ada di melokalisasi aplikasi Lovable tanpa dashboard, dan langkah setup lengkapnya, termasuk koneksi GitHub dan konektor globalize, ada di halaman integrasi Lovable.

Satu catatan sejarah, karena ini menjelaskan mengapa masalah ini terasa baru bagi sebagian builder Lovable. Lovalingo menerjemahkan aplikasi Lovable saat runtime di browser, sehingga komponen bahasa Inggris yang baru dibuat langsung diterjemahkan ulang saat dimuat dan masalah ini tidak pernah muncul. Layanan itu berhenti beroperasi pada 31 Agustus 2026, dan aplikasi yang pindah ke katalog yang di-commit lewat panduan migrasi kini menghadapi pertanyaan di hulu itu untuk pertama kalinya. Model katalog adalah pilihan yang tepat, karena markup terjemahannya milikmu dan bisa diindeks, tetapi model ini meminta agen menulis kode yang bisa diterjemahkan, dan itu berarti memberi tahu agen di mana aturannya berada.

Taruh aturan di tempat Lovable membacanya

Jalankan skill sekali agar AGENTS.md memuat blok lengkap, tempel penunjuk dua baris ke knowledge proyek, dan biarkan workflow GitHub mengerjakan ekstraksi yang tidak bisa dilakukan editor. Kalau kamu membangun di Lovable dan ingin terjemahan semua yang masuk ke katalog ditangani, bukan dirawat manual, halaman vibe coder adalah gambaran umumnya dan harga ada di halamannya sendiri.

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