Kamu meminta Claude Code menambahkan loading state pada form masuk. Loading state-nya berfungsi. Namun tombolnya kini bertuliskan “Log in”, bukan “Sign in”, pesan error menjadi lebih ramah, dan satu heading tiba-tiba memakai sentence case. Tidak ada yang meminta semua itu, semua test lolos, dan kecuali ada yang membaca seluruh diff kata demi kata, perubahan itu ikut rilis.
Tulisan ini membahas kegagalan yang spesifik: copy yang sudah ada dan disetujui diubah diam-diam oleh agen coding AI, serta alur kerja yang mencegahnya. Teks yang dibuat agen secara hardcode dan tanpa kunci merupakan masalah lain, dibahas di mengapa tool coding AI terus menambahkan teks hardcode. Soal di mana copy produk sebaiknya disimpan secara umum menyangkut arsitektur, dibahas di copy produk code-native. Tulisan ini fokus pada insidennya: Senin pagi ketika redaksinya berubah dan tidak ada yang memutuskan perubahan itu. globalize.now sistem manajemen copy code-native dengan lokalisasi bawaan, dan insiden seperti ini salah satu alasan keberadaannya.
Mengapa agen AI coding mengubah teks UI?
Agen AI coding mengubah teks UI karena melihat teks biasa di dalam komponen. Setelah teks itu berada di balik kunci pada file bahasa sumber, mengubahnya menjadi suntingan eksplisit yang bisa di-review, bukan efek samping tugas lain.
Di dalam komponen, “Sign in” tidak punya status khusus. Ia hanyalah string literal di atribut JSX, tidak berbeda dari className atau test id. Agen dilatih dari jutaan diff yang menganggap memperbaiki kode di sekitarnya sebagai perilaku baik, dan bagi model, membuat label “lebih jelas” sama saja dengan mengganti nama variabel. Tidak ada type error yang menunggu, tidak ada test yang gagal, tidak ada anotasi pemilik pada kata-katanya. Mengubah redaksi tidak berbiaya apa pun bagi agen.
Perubahan itu lolos review karena alasan yang sama. Reviewer membaca logika. Perubahan redaksi terselip di tengah diff yang memang soal loading state, kode tetap bisa dikompilasi dan dirender, dan jika snapshot test gagal, respons rutinnya adalah memperbarui snapshot, yang mencatat redaksi baru seolah-olah sudah disetujui.
Apakah file aturan seperti AGENTS.md benar-benar menghentikannya?
File aturan agen mengurangi frekuensi perubahan, tetapi tidak membuat teks UI menjadi tidak bisa ditulis. Arsitekturlah yang membuat suntingan terlihat.
Tetap sediakan file aturan: ini lapisan termurah dan cukup sering berhasil sehingga layak dikerjakan tiga puluh detik. Blok ini berlaku di AGENTS.md, CLAUDE.md, dan aturan Cursor (.cursorrules atau .cursor/rules/):
## UI copy policy: do not modify user-facing text
- Never change user-visible strings (button labels, headings, empty states,
error messages, tooltips, placeholder text) unless the task explicitly
asks for a copy change.
- User-visible text lives in the source locale file (e.g. locales/en.json).
Reference it by key. Never inline a new user-facing string in a component.
- If a task needs new user-facing text, add a key to the source locale file,
reference it, and list the new key in your summary for copy review.
- Any diff to the source locale file is a copy change. Call it out
separately: it needs its own approval, apart from code review.
Sekarang bagian yang jujur. Aturan itu konteks, dan konteks saling bersaing. Pada tugas yang panjang, instruksi itu hanya satu baris di antara ribuan token kode, dan kadang kalah: oleh compaction, oleh sub-agen yang tidak pernah melihatnya, atau oleh pola kuat di file sekitarnya. Lebih buruk lagi, agen yang melanggar aturan tidak memberi tahu apa pun. Kamu tidak mendapat notifikasi bahwa redaksimu berubah; kamu hanya mendapat diff yang kebetulan memuat perubahan itu. Konvensi bukan pemeriksaan.
Jadi file aturan adalah lapisan pertama, dan lapisan yang tidak boleh kamu andalkan sendirian.
Bagaimana membuat suntingan teks terlihat, bukan diam-diam?
Pindahkan setiap teks yang terlihat pengguna dari komponen ke balik kunci di file bahasa sumber. Setelah itu, agen yang ingin mengubah redaksimu harus menyunting file yang seluruh tujuannya adalah redaksi.
Inilah langkah yang tidak bisa dikerjakan file aturan, dan mekanismenya sederhana. Ketika komponen merujuk t('auth.signIn') alih-alih menulis ulang “Sign in”, dua hal berubah sekaligus. Diff komponen tidak lagi memuat copy, sehingga agen yang mengerjakan loading state tidak punya apa pun untuk ditulis ulang di tempatnya bekerja. Dan setiap perubahan copy, oleh agen maupun manusia, masuk ke satu file, sehingga baris yang berubah menjadi peristiwa yang kamu pedulikan, bukan sekadar gangguan di sekitarnya. Memindai diff file bahasa hanya butuh hitungan detik. Mengembalikan reword yang salah cukup satu baris.
Supaya jelas apa yang kamu dapatkan: agen tetap bisa mengedit file bahasa. Intinya bukan membuat kata-kata tidak bisa disentuh, melainkan membuat perubahan pada kata-kata itu bukan lagi efek samping, tetapi tindakan yang terbaca dan bisa ditinjau. Itulah perbedaan antara mengetahuinya dari diff dan mengetahuinya dari pelanggan.
Argumen lengkap untuk menyimpan sumber kebenaran di codebase (bukan di tool desain yang menyinkronkannya ke sana) ada di tulisan utamanya, copy produk code-native. Tulisan ini hanya membutuhkan satu konsekuensinya: copy yang berkunci mengubah file aturanmu dari sekadar permintaan menjadi sesuatu yang bisa diperiksa.
Seperti apa gerbang review itu?
Perlakukan setiap diff pada file bahasa sumber sebagai perubahan teks, dan arahkan ke pemilik redaksi.
Secara konkret: letakkan direktori locales di CODEOWNERS agar orang yang memegang copy otomatis diminta meninjau setiap perubahan di sana. Tambahkan satu baris ke template PR: “apakah PR ini mengubah redaksi yang terlihat pengguna, dan apakah itu memang tugasnya?”. Pertahankan juga aturan di file aturan bahwa agen mencantumkan kunci yang berubah di ringkasannya; jika agen patuh, peninjauan langsung beres, dan jika tidak, hook CODEOWNERS tetap menangkapnya.
Di tim kecil, ini lebih ringan dari kedengarannya. Diff file bahasa pendek, terbaca dalam bahasa sehari-hari, dan “haruskah tombol ini sekarang bertuliskan Log in?” adalah keputusan yang bisa diambil seseorang dalam lima detik, asalkan pertanyaannya memang sampai kepada mereka, dan itulah seluruh tugas gerbang ini.
Bagaimana jika agen sudah terlanjur mengubah teksmu?
Kembalikan redaksi yang disetujui terlebih dulu, lalu beri kunci pada teks agar perubahan berikutnya muncul sebagai diff.
Mencari kerusakannya urusan git: bandingkan komponen yang terdampak dengan commit terakhir yang kamu percaya, lalu baca hanya string literal-nya. Kembalikan yang berubah. Jika kamu tidak bisa memastikan redaksi mana yang disetujui (tombol bertuliskan “Log in”, halaman marketing bertuliskan “Sign in”, dan tidak ada artefak yang mencatat mana yang benar), kamu sudah masuk ke masalah yang lebih dalam, yang ikut diperparah insiden ini. Copy drift berarti teks yang terlihat pengguna menyimpang dari sumber yang disetujui di berbagai tampilan dan dari waktu ke waktu, tanpa satu sumber kebenaran sebagai acuan. Istilah ini, penyebabnya, dan dampaknya di hilir dibahas tersendiri di apa itu copy drift.
Lalu beri kunci pada teks yang kamu pulihkan, mulai dari teks yang disentuh agen. Terbukti merekalah yang berada di garis tembak.
Di mana posisi lokalisasi?
Perubahan diam-diam hanyalah gangguan di satu bahasa, tetapi menjadi liabilitas di sepuluh bahasa: setiap terjemahan yang diturunkan dari redaksi lama kini usang, dan tidak ada yang memberi tahu untuk menerjemahkan ulang.
Di sinilah insiden agen ini memburuk. Kalau kamu merilis versi bahasa Inggris yang sudah diubah redaksinya, bahasa Jerman, Jepang, dan Spanyol masih menyampaikan hal yang lama: tampilan-tampilan itu kini saling bertentangan antarbahasa, bukan hanya antarlayar. Katalog yang tidak sinkron adalah kegagalan tersendiri dengan perbaikannya sendiri, dibahas di file terjemahan tidak sinkron.
Copy berkunci menutup lingkaran ini juga, karena perubahan pada teks sumber adalah peristiwa yang terlihat, dan semua terjemahannya mengikuti peristiwa itu, bukan literal yang diam-diam berpindah. Itulah desain di balik globalize.now: copy berada di codebase, bersumber tunggal di balik kunci, dan lokalisasi menjadi operasi yang sama, bukan tambahan: hubungkan repositori dan setiap bahasa diturunkan dari satu sumber itu. Tim yang merilis dengan tool coding AI paling awal menemui masalah ini, itulah sebabnya kami menulis untuk developer dan untuk mereka yang membangun dengan tool AI.
Saat agen berikutnya masuk ke komponenmu, pertanyaannya adalah apakah label yang berubah muncul sebagai keputusan atau sebagai kejutan. globalize.now menjadikan teks yang terlihat penggunamu bersumber tunggal di repositori yang kamu hubungkan, lalu menurunkan setiap bahasa dari satu teks itu.
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