Agent 28 arayüz metni adayını çıkardı, birden fazla dosyadaki 41 çeviri girdisini yeniden yazdı, middleware ve yönlendirmeyi yapılandırdı ve 5 hedef dil için dil dosyaları üretti. Kurulum, dönüşüm ve çeviri uçtan uca yaklaşık 90 dakika sürdü. globalize.now yapay zekâ destekli bir yerelleştirme altyapısıdır ve onu gerçekte ne olacağını görmek için bir production monorepo'sunda çalıştırdık. Özenle hazırlanmış demo yok. Güvenlik ağı yok. Gerçek karmaşıklığı olan gerçek bir kod tabanı var.
Kod tabanı, önde gelen çeviri yönetim platformlarından birinde on yılı aşkın süre mimar olarak çalışmış bir yerelleştirme sektörü veteranına aitti.
Monorepo'da neler vardı?
Bu, bir öğretici proje değildi. Monorepo'da bir Next.js web uygulaması, bir Android uygulaması, MCP server'lar ve üçüncü taraf bir servisle oluşturulan dokümantasyon vardı. Geliştirici her gün Claude Code kullanıyor, baştan sona AI araçlarıyla geliştiriyor ve tüm stack'i üç ayda kurmuştu.
Hedef Next.js frontend'iydi. Android uygulamasına, MCP server'lara, Mintlify ile oluşturulan dokümantasyon sitesine dokunulmaması gerekiyordu. Soru, bir AI agent'ın bunu açıkça söylenmeden anlayıp anlayamayacağıydı.
Anladı. Agent tüm depoyu taradı ve Next.js uygulamasına odaklandı. Pratikte elle kapsam belirlemeye gerek kalmadı, ancak geliştirici içi rahat etsin diye “yalnızca /apps/web dönüştür” diyebilmeyi isterdi. Haklı bir nokta ve eklenmeye değer. Ama dönüşümü engellemedi.
Yapılandırma nasıl işledi?
Geliştirici süreci anlamak için yönlendirmeli modu seçti. Yapılandırma beş karardan oluştu: paket yöneticisi (eski bir PNPM lockfile'ı da bulunmasına rağmen NPM), katalog formatı (yorum desteği nedeniyle önerilen PO/GetText), kurulum modu (yönlendirmeli), kaynak dil (İngilizce) ve hedef diller (İspanyolca, İtalyanca, Macarca, Çekçe, Slovakça).
Dikkate değer bir gözlem: katalog formatı sorusu, derin yerelleştirme uzmanlığına sahip biri için bile tereddüt yarattı. Tepkisi netti. Bu seçimin kullanıcıya sorulacak kadar önemli olduğunu düşünmedi. Otomatikleştir.
Yönlendirme stratejisi path tabanlıydı. Geliştiricinin ek alan adı olmadığı için domain tabanlı yönlendirme kullanılmadı. Uygulama OAuth tabanlı kimlik doğrulama kullandığından giriş akışları bilinçli olarak İngilizce kaldı. Agent bunu doğru yönetti.
Dönüşüm adımı gerçekte ne yapıyor?
Önemli kısım burası. Agent, Next.js uygulamasında 28 arayüz metni adayı belirledi ve 41 çeviri girdisini işledi. Dosyaları yeniden düzenledi, middleware'i güncelledi, bileşen import'larını değiştirdi ve 5 hedef dilin hepsi için PO dil dosyaları üretti.
Yalnızca dönüşüm adımı yaklaşık 30 dakika sürdü. Öncesindeki kurulum ve yapılandırmayı, ardından geliştiricinin çeviri bağlantısını kendi başına tamamlamasını ekleyince uçtan uca süre 90 dakikaya yaklaştı. Anlık değil. Karşılaştırma için: birkaç sayfalık basit bir uygulama tüm akışı 15 dakikadan kısa sürede bitirir. Onlarca çevrilebilir yüzeyi olan karmaşık bir uygulama daha uzun sürer. Süre, deponun boyutuna değil metin sayısına göre ölçeklenir.
Geliştirici dönüşüm adımının çalışmasını izledi ve şunu söyledi: metin çıkarma ve kod yeniden yazma işin ağır kısmı. Geliştiricilerin en çok çekindiği iş bu. Önceki şirketinde, önde gelen bir TMS'te, depodaki çeviri dosyaları buzdağının yalnızca görünen kısmıydı. Hazırlık ve uluslararasılaştırma işi asıl dertti. AI agent tam da bu kısmı halletti.
Bu, i18n'i elle yapmış her geliştiricinin söylediğiyle örtüşüyor. Kimse çevirilerden şikâyet etmez. Şikâyet konusu; metinleri t() çağrılarına sarmak için 40 dosyaya dokunmak, anlamlı anahtarlar üretmek, import'ları yeniden düzenlemek ve middleware'i yapılandırmaktır. globalize.now'ın otomatikleştirdiği iş de bu.
Gerçekten uçtan uca çalıştı mı?
Evet. Canlı oturum bittikten sonra geliştirici kalan adımları kendi başına tamamladı. globalize.now Git branch'ini yayınladı, uygulamayı web platformuna bağladı, izlemeyi globalize.now branch'ine ayarladı ve dosyaların yüklendiğini ve doğru çevrildiğini doğruladı.
Çekçe çeviri kalitesi hakkındaki değerlendirmesi: kusursuza yakın. Bu söz, kariyeri boyunca yerelleştirme çıktılarını profesyonel olarak değerlendirmiş birinden geliyor. Genel geçer bir onay değil. Bu, kolay olmayan bir dil çiftinde production'a uygun kaliteyi doğrulayan bir alan uzmanının sözü.
Akışı kendi başına tamamladıktan sonra web uygulamasında iki sorun işaretledi. Birincisi, deponun yeniden taranması, çeviri işi arka planda aslında çalışıyor olmasına rağmen “i18n dosyası bulunamadı” sonucunu gösterdi. Yanıltıcı bir arayüz durumuydu, gerçek bir hata değil. İkincisi, çeviri işi açık onay alınmadan başladı. Kredi harcayan her işlem onay istemeli. İkisi de geçerli UX sorunları ve ele alınıyor.
Neler ters gitti?
Bazı şeyler bozuldu. Bu gerçek bir testti, bu yüzden dürüst olacağız.
Kurulum komutu (npx skills add globalize-now/globalize-skills) Windows PowerShell'de başarısız oldu. Araç ilk kez Windows'ta deneniyordu. Google e-posta ekini engelleyince Skill'ler zip dosyası olarak Swiss Transfer ile gönderilmek zorunda kaldı. Asıl akış başlamadan önce toplam kurulum sürtünmesi: yaklaşık 15 dakika.
Dönüşümün ortasında ES modules ile CommonJS arasında bir çakışma çıktı. Proje CommonJS kullanıyor, agent'ın çıktısı ise bir yerde ES modules varsaydı. Engelleyici değildi, ama kurulum sırasında tespit edilip önceden ele alınması gereken bir durum.
Oturumun sonunda, globalize.now web uygulamasında GitHub deposunu bağlarken boş bir sayfa döndü. Geliştirici Opera kullanıyordu. Giriş ekranı yok, hata yok, içerik yok. Oturum sorun çözülmeden bitti.
Üç bug. Üçü de gerçek. Hepsi ya düzeltildi ya da üzerinde çalışılıyor.
Gerçek darboğaz neden metin çıkarma?
i18n içeriklerinin çoğu çeviri kalitesine, framework yapılandırmasına veya TMS özellik karşılaştırmalarına odaklanır. Bu, geliştiricilerin asıl zaman kaybettiği yeri kaçırır.
Mevcut bir kod tabanına uluslararasılaştırma eklemek şu işlerden oluşur: her bileşeni koda gömülü metinler için taramak, hangi metinlerin çevrilebilir olduğuna karar vermek, anlamlı çeviri anahtarları üretmek, her metni uygun t() veya <Trans> çağrısına sarmak, dosya ağacındaki import'ları güncellemek, ilk dil dosyalarını oluşturmak ve yönlendirme middleware'ini yapılandırmak. Monorepo'da buna bir de kod tabanının hangi bölümlerinin i18n'e ihtiyaç duyduğunu çözme karmaşıklığı eklenir.
Bu iş sıkıcı, hataya açık ve tam olarak AI agent'ların iyi olduğu türden. Olayı izleyen geliştirici bunu net söyledi: geliştirici gözüyle ağır iş bu. Büyük bir rahatlama. AI araçlarıyla geliştiren vibe coder'lar artık uluslararası olmanın en zor kısmını tamamen atlayabilir.
Monorepo kapsamı hakkında ne öğrendik?
Agent monorepo kapsamını örtük olarak yönetti. Next.js web uygulamasına odaklandı; Android kodunu, MCP server'ları ve Mintlify dokümanlarını kendisine söylenmeden yok saydı. Çoğu durumda doğru davranış bu.
Ancak örtük kapsam, açık kapsamla aynı şey değil. Geliştirici, yapılandırma adımı olarak “yalnızca Next.js uygulamamı dönüştür” diyebilmeyi istedi. Müşteriye dönük bir uygulama ile bir yönetim paneli gibi birden fazla web frontend'i olan bir monorepo'da, hangisinin önce uluslararasılaştırılacağı üzerinde kesin denetim istenir.
Bu, kapatmakta olduğumuz bir ürün eksiği. Şimdilik agent pratikte doğru sonucu veriyor. Açık kapsam belirleme, özellikle dönüşüm onlarca dosyaya dokunduğunda, bir yapılandırma adımı olmalı.
Bu yöntem elle i18n kurulumuyla nasıl karşılaştırılır?
Bu karmaşıklıktaki bir kod tabanında elle i18n kurulumu günler sürer. Tek bir adım zor olduğu için değil, onlarca adım olduğu ve her birinin dikkat istediği için. Bir metni kaçırırsan yarı çevrilmiş bir sayfayı yayına alırsın. Bir anahtar adını yanlış verirsen aylarca peşini bırakmayan yinelenen girdiler oluşur. Middleware'i güncellemeyi unutursan dil yönlendirmesi sessizce bozulur.
AI agent eşdeğer işi uçtan uca yaklaşık 90 dakikada tamamladı. Meslek hayatında binlerce i18n uygulaması görmüş olan geliştirici bunu zarif buldu.
AI araçlarıyla geliştiren geliştiriciler için bu, dil eklemenin ne zaman yapılacağına dair hesabı değiştiriyor. i18n kurulumu bir hafta sürüyorsa, ürün-pazar uyumunu kanıtlayana kadar ertelersin. 90 dakika sürüyorsa, ilk günden çok dilli yayına çıkabilirsin.
globalize.now bunu halleder. Deponu bağla, dönüşüm uygulamada bir kez çalışır; sonrasında editöründe npx skills add globalize-now/globalize-skills skill'leri devralır. Nasıl çalıştığını globalize.now adresinde gö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