AI asistanları Next.js'i iyi bilir ama Türkiye'ye özgü kuralları bilmez: KVKK'da aydınlatma ile açık rızanın farkını, iyzico'nun bildirim akışını, paranın neden kuruş cinsinden tutulması gerektiğini, sunucunun UTC saatiyle neden yanlış tarih gösterdiğini. trkit bu bilgiyi asistanınıza üç yolla verir.
1. Proje kuralları (AGENTS.md)
create-trkit-app her projeye bir AGENTS.md dosyası koyar. Codex, Cursor, GitHub Copilot, Windsurf, Zed ve diğer birçok araç bu dosyayı otomatik okur. Claude Code CLAUDE.md dosyasını okur; trkit'in CLAUDE.md dosyası @AGENTS.md satırıyla aynı kuralları içe aktarır.
Kurallar kısaca:
- Arayüz metinleri Türkçe; harf dönüşümünde
tr-TRyereli - Para kuruş cinsinden tamsayı, gösterim
tl() - Tarihler
tarih()/tarihSaat()ile, Europe/Istanbul saat diliminde - zod
@/lib/zod'dan; hazır şemalar@trkit-app-pack/validate'ten - Yasal metinler elle yazılmaz,
trkit.config.ts'den üretilir - Ödeme sonucu yalnızca callback'te
verifyCallback()ile belirlenir; sırlarserver-only
AGENTS.md'yi kendi projenize göre genişletin: veritabanı, kimlik doğrulama, kod stili gibi kararlarınızı ekleyin.
2. MCP sunucusu (@trkit-app-pack/mcp)
MCP (Model Context Protocol), asistanınıza araç kazandırır. trkit MCP sunucusuyla asistanınız:
- Eklenebilecek bileşenleri listeler ve dosyalarını getirir
- Şirket bilgilerinden yasal metin üretir
- TCKN, VKN, IBAN, telefon, plaka doğrular
- İl/ilçe arar
- Ödeme, KVKK, çerez, SMS konularındaki güvenlik rehberlerini okur
İki şekilde çalışır:
| Komut / adres | Kimler için | |
|---|---|---|
| Yerel (stdio) | npx -y @trkit-app-pack/mcp | Claude Code, Cursor, VS Code, Codex, Windsurf |
| Uzak (HTTP) | https://<sunucunuz>/mcp | ChatGPT, claude.ai ve uzak MCP destekleyen istemciler |
Uzak sunucu bir Node.js sunucusu gerektirir; nasıl yayınlanacağı MCP sayfasında anlatılıyor. Araçların ayrıntısı: MCP araçları.
3. AI için dokümantasyon
| Adres | İçerik |
|---|---|
/llms.txt | Sayfa dizini (llmstxt.org biçiminde) |
/llms-full.txt | Tüm dokümantasyon tek Markdown dosyasında |
/docs/<sayfa>.md | Her sayfanın ham Markdown hâli (örnek: /docs/kurulum.md) |
Her dokümantasyon sayfasının üstündeki Markdown olarak kopyala, ChatGPT'de aç ve Claude'da aç düğmeleriyle sayfayı asistanınıza tek tıkla verebilirsiniz.
Aracınızı seçin
Örnek istekler
Bu istekleri trkit projesinde asistanınıza doğrudan verebilirsiniz:
Bu siteye iyzico ile ödeme ekle. Sepet sayfasından ödeme formuna geçilsin,
callback'te siparişi güncelle. Önce trkit_guide ile odeme rehberini oku.Kayıt formuna TCKN, cep telefonu ve il/ilçe alanları ekle. Doğrulama
sunucuda da yapılsın, telefon veritabanına E.164 biçiminde yazılsın.Google Analytics ekle ama yalnızca kullanıcı analitik çerezlere onay verirse yüklensin.
KVKK aydınlatma metnine yurt dışı aktarımı ekle.Sipariş özet sayfasında toplamı TL olarak göster, altına tutarı yazıyla yaz
("Yalnız ... Türk lirası"), sipariş tarihini İstanbul saatiyle göster.AI'ın ürettiği yasal metin değişikliklerini ve ödeme kodunu her zaman kendiniz gözden geçirin.