AI ajanına Türkçe proje yazdırmanın 10 kuralı
Claude, Cursor, Codex veya benzeri ajanlar Türkçe arayüz üretirken dil kurallarını 'sonra düzeltilecek copy' olarak bırakırsanız tutarsızlık kod tabanına yayılır.
AI coding ajanı Türkçe proje geliştirebilir. Sorun Türkçe bilip bilmemesi değil; ürünün dil sisteminin prompt içinde yeterince kesin tanımlanıp tanımlanmadığıdır.
1. Ürün dilini tek cümlede sabitle
"Arayüz Türkçe olacak" yetmez. Örneğin: "Kullanıcıya sen diye hitap et; kısa, teknik ve doğal Türkçe kullan; İngilizce yalnızca teknik özel adlarda kalsın."
2. Büyük I/İ kuralını yaz
Locale-aware dönüşüm kullanılacağını açıkça belirt. CSS uppercase veya İngilizce locale ile dönüşüm Türkçede bozulabilir.
3. Sen/siz karışımını yasakla
Ajan bir component'i başka kaynaktan örneklediğinde ton değişebilir. Tek tercih belirle ve bütün UI için invariant kabul et.
4. İngilizce placeholder bırakmasını yasakla
Loading, empty state, tooltip ve validation metinleri sonradan unutulan alanlardır. "Kullanıcıya görünen hiçbir geçici İngilizce metin bırakma" kuralı koy.
5. Dinamik ekleri string birleştirmeyle üretme
Kullanıcı adı veya nesne adına Türkçe ek eklemek gerekiyorsa cümleyi yeniden tasarla veya dil yardımcı katmanı kullan.
6. En uzun metinle responsive test iste
Ajan çoğu zaman "Save" genişliğinde buton tasarlar. "Değişiklikleri kaydet" gibi gerçek Türkçe metinlerle mobil testi zorunlu kıl.
7. Tarih/saat/para formatını merkezi helper'a taşı
Component içinde elle format yazdırma. Locale katmanı oluştur.
8. Hata mesajına eylem ekle
"Bir hata oluştu" yerine kullanıcının ne yapacağını belirten metin üretmesini iste.
9. Copy sözlüğü oluştur
Aynı kavram için "görev", "iş", "task" üçlüsünü farklı ekranlarda kullanmasın. Ürün sözlüğü agent context'inin parçası olsun.
10. Son kontrolde yalnızca kod değil dil taraması yap
Repo genelinde kullanıcıya görünen string'leri ara; İngilizce kalıntı, büyük İ problemi, ton sapması ve farklı terimleri yakala.
Kopyalanabilir minimum kural seti
- UI dili Türkçe.
- Hitap biçimi tek ve tutarlı.
- Türkçe locale casing zorunlu.
- Kullanıcıya görünen İngilizce placeholder yasak.
- Tarih/saat/para merkezi locale katmanından.
- Mobil test en uzun Türkçe string ile.
- Ürün sözlüğü dışına çıkma.
Ajanın Türkçesini sonradan düzeltmek yerine Türkçe davranışı sistem kuralı yapın.
Türkçe Arayüz Problemi
İngilizce şablonların Türkçe üründe kırıldığı yerler: microcopy, ekler, locale davranışı, ton sistemi, KVKK ve yapay zekâ ajanlarıyla Türkçe geliştirme.