Lovable i18n kurallarını üç yerden okur: her zaman bağlamda duran workspace ve proje knowledge'ı; yalnızca prompt açıklamalarıyla eşleştiğinde yüklenen Skill'ler; ve bağlı depodaki talimat dosyaları. Kökteki AGENTS.md konuşma ne kadar uzarsa uzasın okunur. Kuralları yanlış yere yazarsan geçen hafta çevirdiğin uygulama bir sonraki özelliğini İngilizce yayına çıkarır. globalize.now yapay zekâ destekli bir yerelleştirme altyapısı; bu hatanın sonucunu birçok Lovable deposunda görüyoruz. Çözüm çoğunlukla hangi yüzeyin ne zaman okunduğunu bilmekte.

Çevrilmiş bir Lovable uygulaması neden İngilizceye geri kayar?

Çünkü uygulamayı çok dilli yapan talimat, agent bir sonraki bileşeni yazarken önünde değildi. Lovable ekrandaki prompt'u çözer. Prompt “referanslar bölümü ekle” diyorsa ve bağlamda hiçbir yerde “kullanıcıya görünen her metin <Trans> üzerinden geçer” yazmıyorsa başlık, tıpkı sıfırdan bir projede olduğu gibi literal olarak eklenir.

Bu, kataloğun koddan geride kalması sorunuyla aynı şey değil; o senkronizasyon hatasını Lovable uygulamanın çevirileri neden her yayında bozulur yazısında anlattık. Senkronizasyon, sarmalanmış metinleri dil dosyalarına taşır. Hiç sarmalanmamış bir metni taşıyamaz. Asıl soru, Lovable'ın kodu yazdığı anda neyi okuduğu; Lovable'ın dokümantasyonu bu konuda alışılmadık derecede net.

Lovable düzenleme yapmadan önce gerçekte ne okur?

Knowledge dokümantasyonuna göre proje knowledge'ı, workspace knowledge'ı ve Git deposundaki AGENTS.md veya CLAUDE.md gibi talimat dosyalarının hepsi, proje koduyla birlikte agent'a yol gösterir. Skill'ler ayrıdır ve istek üzerine yüklenir.

i18n açısından önemli üç farkları var.

Ne zaman okundukları. Knowledge her mesaja dahil edilir. Skill yalnızca istek açıklamasıyla eşleştiğinde dahil edilir. Kökteki AGENTS.md ise Lovable'ın ifadesiyle oturum uzunluğundan bağımsız olarak her zaman okunur.

Uzun bir sohbette ne kadar dayanıklı oldukları. Lovable'ın dokümanlarında açık bir uyarı var: çok bağlamlı, çok uzun konuşmalarda knowledge talimatları her zaman tutarlı izlenmeyebilir. Aynı sayfa kökteki AGENTS.md için tam tersini söyler. Bu yazının var olma nedeni bu asimetri.

Kimin düzenleyebildiği. Workspace knowledge'ını yalnızca sahip ve yöneticiler düzenleyebilir. Proje knowledge'ını projede düzenleme yetkisi olan herkes düzenleyebilir. Depodaki dosyayı ise push yetkisi olan herkes düzenler; Lovable agent'ı da buna dahil.

Her knowledge seviyesi 10.000 karaktere kadar alır. Bir işaretçi için fazlasıyla yeterli; ama mimari notları, veritabanı şeması ve marka sesini de sığdırmak istediğinde tam kural seti için çok az.

Peki i18n kuralları nereye yazılmalı?

Depoya; knowledge'a da kısa bir işaretçi koy. Gerekçe yukarıdaki karşılaştırmadan çıkıyor.

Depo kökündeki AGENTS.md tam kuralları taşır. Oturum uzunluğundan bağımsız olarak her mesajda okunur; Git'te durduğu için yeni bir sohbetten, yeni bir ekip arkadaşından ve başka bir agent'a geçişten de sağ çıkar; projenin geri kalan bağlamıyla yarışan bir karakter sınırı da yoktur. lovable-i18n Skill'i kurulumunu çalıştırdığında üçüncü aşaması tam olarak bu dosyayı yazar: <!-- lovable-i18n:rules:start --> ve <!-- lovable-i18n:rules:end --> işaretleri arasında bir Lingui kuralları bloğu. Dosya yoksa oluşturulur, varsa sonuna eklenir, yeniden çalıştırıldığında işaretlerin arasındaki kısım değiştirilir; böylece hiçbir şey çoğalmaz.

Proje knowledge'ı iki satırlık bir işaretçi taşır. Şuna benzer bir şey:

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.

İşaretçi, dokümanların uyardığı durum için var. Uzun bir konuşma knowledge bloğunu sulandırdıysa agent'ın elinde yine depodaki dosya olur; depo dosyası herhangi bir nedenle bağlamda değilse işaretçi kısıtı adıyla söyler. İki yüzey, tek kural.

Workspace knowledge'ı yalnızca tüm projeler aynı kütüphaneyi kullanıyorsa. Workspace knowledge'ı workspace'teki tüm projelere uygulanır ve tek bir tane vardır. Projelerinin yarısı Lingui, yarısı başka bir şey kullanıyorsa workspace seviyesindeki bir Lingui kuralı yarısı için yanlış olur; zaten çakışmada Lovable'ın proje knowledge'ına öncelik vermesi teşvik edilir. Workspace knowledge'ını her yerde doğru olan kurallara ayır: cümle biçimli buton metinleri, console.log yok, İngilizce kod yorumları.

Skill, kuralların yeri değildir. Skill'i yeni içe aktaranları bu şaşırtır. Skill, prompt açıklamasıyla eşleştiğinde yüklenir; yani lovable-i18n i18n kurulumu istediğinde bağlamdadır, ödeme sayfası istediğinde yoktur. Bu bilinçli bir tasarım; her mesajda yüklenen bir Skill zaten knowledge olurdu. Skill'in işi, kalıcı kuralları depoya bir kez yazıp çekilmektir.

AGENTS.md'deki kurallar ne diyor?

Agent'a yalnızca “i18n kullan” denince yanlış yaptığı soruları yanıtlar. Skill'in yazdığı blok altı bölümden oluşur.

Hangi macro. Bir karar listesi: sayıya göre değişen metin <Plural> veya bir ICU plural kullanır; JSX metni <Trans> kullanır; öznitelik değerleri ve toast gibi olay işleyici metinleri useLingui() ile dönen t'yi kullanır; modül kapsamındaki sabitler msg kullanır ve bileşenin içinde çözümlenir. Kural, her birinin hangi import yolundan geldiğini de söyler; çünkü yanlış t import'u uygulamanın hiç yüklemediği global bir örneğe bağlanır.

Enterpolasyon. Çıkarılan mesajda yalnızca çıplak bir değişken kendi yuvasını adlandırır. Başka her ifade {0} olarak çıkar; çevirmen bununla çalışamaz. Bu yüzden kural, adlandırmak için ph() kullanmayı zorunlu kılar.

Çoğullar. other her zaman gerekir, kategoriler CLDR'dir ve iki metin arasında üçlü operatör kullanmak yasaktır; çünkü İngilizce çoğul kurallarını bileşene gömer. Arka planı merak edersen çoğul biçimlerinin derlendiği söz dizimi ICU MessageFormat nedir yazısında anlatılıyor.

Sayılar ve tarihler. i18n.number() ve i18n.date() kullan; toFixed() ya da bir değere eklenmiş para birimi simgesi kullanma. Lovable'ın kendi workspace knowledge örneğinde tarih biçimini ve Avrupa sayı biçimini belirleyen bir yerelleştirme bölümü var. Bu iyi bir refleks, ama bir sarmalama kuralı değil, biçimlendirme kuralı. Bir uygulama buna kusursuz uyup yine de her başlığı İngilizce yayına çıkarabilir.

Çevirmen yorumları. Birden fazla okunuşu olan kısa metinler, çıplak eylem etiketleri ve alan terimleri, metnin nerede göründüğünü anlatan bir comment= alır. context= yalnızca aynı metnin farklı yerlerde farklı çevrilmesi gerektiğinde kullanılır.

Katalog bakımı. Her yeni metin sarmalanır ve her src/locales/*/messages.po dosyasına boş bir msgstr ile eklenir; böylece çeviri gelene kadar Lingui kaynak metne döner. Agent lingui extract komutunu asla çalıştırmaz, çünkü Lovable'da terminal yok; bunu senkronizasyondan sonra bir GitHub Action yapar. Mevcut kayıtlardaki #. ve #: yorum satırlarını da asla düzenlemez, çünkü bunları çıkarma işlemi yeniden üretir.

Kuralları Lovable'a özgü yapan son bölüm bu. Cursor veya Claude Code kural dosyası “linter'ı çalıştır” diye bitebilir. Lovable kural dosyası bitiremez; bunun yerine elle neyin yapılacağını, neyin CI'a bırakılacağını söylemesi gerekir.

Lovable hiçbir şey çalıştıramıyorsa kuralı ne denetler?

GitHub workflow'u ve yalnızca GitHub workflow'u. Lovable'da terminal yok; yani agent bir literal yazdığı an ile değişikliğin deponla senkronize olduğu an arasında lint adımı yok. IDE agent'larından yapısal fark bu: orada koda gömülü bir metinde CI'daki lint kuralı build'i başarısız kılar.

Kurulumda kabul edersen Skill, varsayılan branch'e yapılan push'larda çalışan bir GitHub Actions workflow'u ekler; Lovable'ın senkronizasyonu da oraya düşer. Workflow sarmalanmış metinleri kataloglara çıkarır ve katalog senkronizasyonunu geri commit eder. GitHub uygulamasında workflows izni yoksa Skill dosyayı GitHub'da elle eklemeni ister. Bu, agent'ın sarmaladığı her şey için döngüyü kapatır. Agent'ın sarmalamadığı bir metin için hiçbir şey yapmaz, çünkü çıkarma işlemi yalnızca macro'ları görür.

Dürüst tablo şu: AGENTS.md içindeki kurallar sarmalanmamış literal'in görülme sıklığını azaltır, knowledge işaretçisi uzun sohbetlerde onları destekler, kalanını yakaladığın yer ise GitHub'daki diff. Kalanını bir makinenin yakalamasını istiyorsan eslint-plugin-i18next'in no-literal-string kuralını aynı workflow'a bir adım olarak ekle. Bir Lovable projesinin herhangi bir şey çalıştırabildiği tek yer olan depoda çalışır.

Sarmalanan metinlere ne olur?

Çevrilmeleri gerekir ve otomatikleştirmeye değer kısım yeniden prompt vermek değil, bu. Dönüştürme tek seferliktir ve uygulama içinde olur: depoyu bağla, globalize.now kod tabanını bir kez dönüştürsün ve kataloğu incelemen için bir PR olarak teslim etsin. Sonrasında push işleri, yeni katalog birimlerini geldikçe çevirir; yani Lovable'ın salı günü yazdığı bir <Trans> için çeviriler çarşamba günü bir PR'da hazırdır. Dashboard adımı yok, dışa aktarma yok, onay kuyruğu yok. Bu yaklaşımın daha uzun savunması dashboard olmadan bir Lovable uygulamasını yerelleştirme yazısında; GitHub bağlantısı ve globalize bağlayıcısı dahil kurulum yolu ise Lovable entegrasyon sayfasında.

Bu sorun bazı Lovable geliştiricilerine neden yeni geliyor, onu açıklayan tarihsel bir not. Lovalingo, Lovable uygulamalarını tarayıcıda çalışma zamanında çeviriyordu; yeni üretilen İngilizce bir bileşen yüklenirken yeniden çevriliyordu, dolayısıyla sorun hiç görünmüyordu. 31 Ağustos 2026'da kapandı ve geçiş kılavuzu üzerinden commit edilmiş kataloglara geçen uygulamalar bu soruyla ilk kez karşılaşıyor. Katalog modeli doğru takas: çevrilmiş markup senin ve indekslenebilir. Ama agent'tan çevrilebilir kod yazmasını bekler, bunun için de kuralların nerede olduğunu ona söylemen gerekir.

Kuralları Lovable'ın okuduğu yere koy

Skill'i bir kez çalıştır ki AGENTS.md tam bloğu taşısın, iki satırlık işaretçiyi proje knowledge'ına yapıştır ve editörün yapamadığı çıkarma işini GitHub workflow'una bırak. Lovable'da geliştiriyorsan ve kataloğa ulaşan her şeyin çevirisinin bakım yükü olmadan halledilmesini istiyorsan genel bakış için vibe coder sayfası, fiyatlandırma ise kendi sayfasında.

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