Çünkü i18n kurulumun kodda değil, kafanda ve yapılandırmanda yaşıyor. Agent'ın baktığı kodda yok. Cursor bir bileşeni önündeki bağlama göre yeniden üretir ve çalışan en hızlı şey düz JSX metnidir. Depoda buna itiraz eden bir şey olmadığı için literal yayına çıkar. globalize.now, döngüyü kapatan yapay zeka destekli yerelleştirme altyapısıdır: yeni metinleri çıkarır, anahtarları üretir ve çevirileri her Git push'ta senkronize eder.
Kimsenin sana söylemediği hata modu bu. i18n kurulumu bir öğleden sonralık iştir. Asıl sorun, bir agent bileşenlerini günde iki kez yeniden yazarken bu kurulumu ayakta tutmak.
i18n kurulduktan sonra Cursor neden koda gömülü metin eklemeye devam ediyor?
Üç şey aynı anda doğru ve birlikte sızıntıyı garantiliyor.
Agent bir dosya görür, bir kural görmez. Cursor'dan bir ayarlar paneli eklemesini istediğinde, düzenlediği bileşeni ve belki birkaç komşu dosyayı okur. Dil dizinin, namespace şeman ve kullanıcıya görünen her metnin bir çeviri fonksiyonundan geçmesi kuralı, sen oraya koymadıkça o pencerede yoktur.
Çevrilmemiş metin istatistiksel varsayılandır. Herhangi bir modelin eğitim verisindeki React kodunun ezici çoğunluğu metinleri satır içi yazar. Agent bir buton etiketi için en olası sonraki token'ı seçerken Save changes, salt sıklık gücüyle t('settings.save') ifadesini yener. Ondan her seferinde daha az yaygın kalıbı seçmesini istiyorsun, üstelik seçmezse hiçbir geri bildirim almıyor.
Hiçbir şey bozulmaz. Belirleyici olan bu. Koda gömülü bir metin tip kontrolünden geçer. Build olur. Render edilir. Testlerini geçer. Pipeline'ında, Almanya'daki bir kullanıcının İngilizce bir toast göreceğini söyleyen tek bir kırmızı işaret yok. Kusur, biri dili değiştirip sayfayı kaydırana kadar görünmez kalır.
Bunu eksik bir import ya da hatalı bir prop tipiyle kıyasla: agent bunlarda saniyeler içinde düzeltilir. Çevrilmemiş metin, araç zincirinin sessizce kabul ettiği tek hata sınıfı. Bu yüzden biriken tek hata sınıfı da o.
En çok hangi metinler sızar?
En son eklenenler ve en az incelemeden geçenler.
Çok dilli başlayan, yapay zekâ destekli herhangi bir kod tabanına baktığında geriye kalan İngilizce metinlerin tahmin edilebilir yerlerde durduğunu görürsün:
- Hata ve başarı toast'ları, özellikle ilgisiz bir hatayı düzeltirken eklenenler
- Bir kez yazılıp hiç gözden geçirilmeyen boş durum ve yükleniyor metinleri
- Çoğu zaman bir şemanın içinde satır içi üretilen form doğrulama mesajları
- Erişilebilirlik öznitelikleri:
aria-label,alt,title - Onay diyalogları ve geri alınamaz işlem metinleri
- Bir
catchbloğunun içindeki her şey
Örüntü tutarlı. Ana akışların çevrilir, çünkü onlara bakıyorsun. Kenarlar koda gömülü kalır, çünkü kimse onları ikinci bir dilde açmıyor.
Bunun ikinci dereceden bir versiyonu da var. Bir agent, çevrilmiş mevcut kodun yanına bir literal eklerken bazen "yardımseverce" namespace şemana uymayan bir anahtar uydurur. Sonuçta bir dosyada errors.saveFailed, başka bir dosyada settings_save_error olur. Artık hem çevrilmemiş metinlerin hem de parçalanmış bir anahtar alanının var. Bu yolculuğun daha başındaysan, yapay zekayla üretilmiş bir uygulamayı yerelleştirme rehberimiz ilk temizliği anlatıyor.
Bunu .cursor/rules ya da AGENTS.md durdurabilir mi?
Yardımcı olurlar ve birini yazmalısın, ama bunlar zorlama değil, yönlendirmedir.
Talimat dosyası katmanı yakın zamanda standartlaştı. AGENTS.md 2025'te üreticiden bağımsız bir gelenek olarak başladı ve şimdi Linux Foundation çatısı altındaki Agentic AI Foundation tarafından yönetiliyor. Cursor, Codex, Copilot, Gemini CLI, Aider, Windsurf ve Zed bunu doğrudan okuyor. Yani deponun kökündeki tek bir dosya, ekibinin kullandığı her agent'a ulaşır. Cursor ayrıca kapsamı daraltılmış proje kurallarını .cursor/rules/ altında .mdc dosyaları olarak destekler. Frontmatter ise açıklamayı, dosya glob'larını ve kuralın her zaman geçerli olup olmadığını kontrol eder. 2026'da pratik kurulum şu: taşınabilirlik için kökte bir AGENTS.md, otomatik eklemenin işe yaradığı yerlerde kapsamlı Cursor kuralları.
İşe yarar bir i18n bloğu şöyle görünür:
## 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`.
Bu, sızıntı oranını ölçülebilir ölçüde düşürür. Sıfıra indirmez, çünkü kural dosyaları bağlam penceresindeki diğer her şeyle dikkat için yarışır ve uzun agent oturumları sapar. Bu katmanı garanti olarak değil, sıklığı azaltan bir önlem olarak gör.
Çevrilmemiş bir metni build'i başarısız kılacak hale nasıl getirirsin?
JSX'teki bir literal'i hata sayan bir lint kuralı ekle, sonra bunu sürekli entegrasyonda çalıştır.
Standart seçim, eslint-plugin-i18next paketindeki no-literal-string kuralıdır. Varsayılan olarak dosyadaki her literal'i değil, JSX işaretlemesindeki düz metni doğrular. Gerçek bir kod tabanında yanlış pozitiflerden oluşan bir duvar yerine kullanılabilir olmasının sebebi bu. Düzenli ifadeyle yok sayma desenlerini, güvenli olduğunu bildiğin fonksiyonlar için callee hariç tutmalarını ve yalnızca işaretleme modunu destekler.
Başlangıç yapılandırması:
// 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*$'],
},
],
},
},
];
Yalnızca editörde değil, pipeline'ında da çalıştır:
npx eslint . --max-warnings=0
Artık görünmez kusurun kırmızı bir işareti var. Agent, çevrilmemiş bir metin için de tip hatasında aldığı geri bildirim döngüsünün aynısını alır. Yani başka bir dildeki bir kullanıcının bulmasına bırakmak yerine hatayı aynı oturumda kendisi düzeltebilir. i18n'i sıfırdan bir Cursor projesine bağlamanın daha geniş resmini görmek istersen 15 dakikalık Cursor ve Next.js rehberimize ve Cursor entegrasyon sayfasına bak.
Başarısız olan bir lint kuralı neden yetmez?
Çünkü kırmızı bir build sana bir metnin var olduğunu söyler. Çevirmez.
Kural tetiklendikten sonra yine birinin mevcut namespace'lerine uyan bir anahtar seçmesi, İngilizce kaynak değeri eklemesi ve diğer dilleri üretmesi gerekir. Günde birkaç kez yayın yapan tek kişilik bir projede bu iş ertelenir. Yeterince ertelenince dürüst çözüm dosyayı yok sayma listesine eklemek olur. O noktada fazladan bir yapılandırmayla başladığın yere dönmüş olursun.
Çözülmüş bir sorunu tekrarlayan borca çeviren boşluk bu. Birinci ve ikinci katman sorunun ne sıklıkla çıktığını ve ne kadar çabuk fark edildiğini değiştirir. İkisi de işi yapmaz.
Üç katmanlı kurulum nasıl görünür?
Talimat, zorlama, otomasyon. Her katman bir öncekinin kaçırdığını yakalar.
Birinci katman, talimat. i18n bloğunu deponun kökündeki AGENTS.md dosyasına yaz ve bileşen dizinlerin için glob'lu, kapsamı daraltılmış bir .cursor/rules/i18n.mdc ekle. Maliyet: bir kez, on beş dakika. Etki: baştan daha az literal yazılır.
İkinci katman, zorlama. no-literal-string kuralını aç ve sürekli entegrasyonu buna göre başarısız kıl. Maliyet: mevcut bir kod tabanında yok sayma desenlerini ayarlamak için bir öğleden sonra. Etki: hiçbir literal fark edilmeden main branch'ine ulaşmaz ve agent kendini düzeltebilir.
Üçüncü katman, otomasyon. Çıkarma, anahtarlama ve çeviri sen uğraşmadan gerçekleşir. globalize.now bu katmanda çalışır. i18n runtime'ının yerine geçmez, onun üstünde durur: metinleri yine next-intl ya da i18next render eder. globalize.now koda gömülü yeni metni algılar, projendeki mevcut namespace'lerle tutarlı anahtarlar üretir, yapılandırılmış tüm dillere çevirir ve güncellenen dil dosyalarını her Git push'ta commit eder. Bir kez kur (depoyu globalize.now'da bağla), atlanacak elle bir adım kalmaz. Agent'ına şu komutla da kurabilirsin:
npx skills add globalize-now/globalize-skills
Planlar ayda 20 €'dan başlar; Starter her ay 20 € kredi içerir, bunun üzerindeki kullanım sağlayıcı maliyeti artı bir marjla kredi bakiyenden düşülür. Koltuk, dil veya proje başına ücret yoktur; kayıtta kart gerektirmeyen, 14 gün sonra sona eren 5 € deneme kredisi verilir. Mühendisler için daha fazla ayrıntı geliştiriciler sayfasında, yapay zeka araçlarıyla ürün çıkaranlar için kısa anlatım ise vibe coder'lar sayfasında.
Üç katmanın amacı, hiçbirinin yüz agent oturumu boyunca disiplininin tutmasına bağlı olmaması. Kural dosyası oranı düşürür, lint kuralı hataları gürültülü yapar, senkronizasyon da düzeltmeyi bedava kılar. Bir agent uygulamayı sürekli yeniden yazarken çok dilli bir uygulamayı çok dilli tutan bu kombinasyon.
Kırılgan olan i18n kurulumun değil. Kırılgan olan, agent'ın bir metni yazması ile o metnin dil dosyasına ulaşması arasındaki döngü. globalize.now bu döngüyü her push'ta kapatır.
globalize.now koda gömülü uygulama metinlerini çeviriye hazır dil dosyalarına dönüştürür ve sen yayına aldıkça güncel tutar.
globalize.now'ı ücretsiz dene