# AI ile geliştirme

> trkit projeleri Claude Code, Cursor, Codex, ChatGPT ve diğer AI asistanlarıyla çalışmaya hazır gelir.

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-TR` yereli
- 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ırlar `server-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ğı](/docs/ai/mcp#uzak-sunucuyu-yayinlamak) MCP sayfasında anlatılıyor. Araçların ayrıntısı: [MCP araçları](/docs/ai/mcp).

## 3. AI için dokümantasyon

| Adres | İçerik |
|---|---|
| [`/llms.txt`](/llms.txt) | Sayfa dizini ([llmstxt.org](https://llmstxt.org) biçiminde) |
| [`/llms-full.txt`](/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](/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

- [Claude Code](/docs/ai/claude-code)
- [Cursor](/docs/ai/cursor)
- [ChatGPT](/docs/ai/chatgpt)
- [Codex](/docs/ai/codex)
- [VS Code, Windsurf ve diğerleri](/docs/ai/diger)

## Örnek istekler

Bu istekleri trkit projesinde asistanınıza doğrudan verebilirsiniz:

```text
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.
```

```text
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.
```

```text
Google Analytics ekle ama yalnızca kullanıcı analitik çerezlere onay verirse yüklensin.
KVKK aydınlatma metnine yurt dışı aktarımı ekle.
```

```text
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.