---
title: AI Agent ile Kullanım
description: Claude Code, Cursor veya Codex gibi AI agent'lara ikas App UI kurallarını ve bileşenlerini tanıtın.
---

ikas uygulamalarının çoğu artık kısmen Claude Code, Cursor veya Codex gibi AI agent'larla yazılıyor. Onlara, yeni bir ekip arkadaşına vereceğiniz yapı taşlarını ve kuralları verin.

<Steps>
<Step>
### Kural dosyasını kurun

`@ikas/ui-rules`, proje kök dizinine `ikas-ui.md` dosyasını ekler. Dosya şunları içerir:

- Uygulamanın panelin içinde açıldığı: panelin üst barı geri butonunu, uygulama logosunu, uygulama adını ve plan butonunu zaten çizer. Uygulama logo, uygulama adı, kendi üst barı veya sidebar çizmez; `PageHeader` başlığı ekranın ya da bölümün adıdır.
- Hangi ihtiyaç için hangi bileşenin kullanılacağı
- Gezinme hiyerarşisi: 1. seviye `PageNav` (sayfanın en üstündeki alt çizgili bar), 2. seviye kart başlığında veya araç çubuğunda `SegmentedControl` / `Tabs`. İki seviye asla iç içe aynı görünümde olmaz.
- Görsel kurallar: yalnızca token, kendi gradient'i yok, bölüm başına tek ana aksiyon
- Metin kuralları
- Her ekranın karşılaması gereken dört durum ve yükleniyor kuralları: eylem bekleniyorsa `Button loading`, veri bekleniyorsa iskelet (`Skeleton loading`, `SkeletonProvider`, `useDelayedLoading`); sayfanın ortasında spinner yok.

Dosya, AI agent'lar okuduğu için İngilizcedir; yine de agent'lara arayüz metinlerini uygulamanın dilinde yazmalarını söyler (Türkçe uygulamada Türkçe metin, `tr-TR` ile `Intl.NumberFormat`).

```bash
npx shadcn@latest add @ikas/ui-rules
```
</Step>

<Step>
### Agent talimatlarınızdan referans verin

ikas starter şablonu `AGENTS.md` ve `CLAUDE.md` dosyalarıyla birlikte gelir. Şunu ekleyin:

```md title="AGENTS.md"
## UI
- Read and follow `ikas-ui.md` before writing or changing any UI.
- Build screens from `@/components/ikas/*` and `@/components/ui/*`.
- If a component is missing, install it with `npx shadcn@latest add @ikas/<name>` before writing your own
  (list: https://builders.ikas.com/r/registry.json).
```
</Step>

<Step>
### shadcn MCP sunucusunun registry'yi görmesini sağlayın

Starter şablonundaki `.mcp.json`, shadcn MCP sunucusunu zaten içerir. `@ikas` namespace'i `components.json` içinde tanımlı olduğu için agent, ikas bileşenlerini shadcn bileşenleri gibi arayıp kurabilir:

```text
@ikas bileşenleriyle, mağazanın siparişlerini ödeme durumuyla listeleyen bir sipariş sayfası yap
```
</Step>
</Steps>

## Neden işe yarıyor

- AI agent'lar projede ne varsa onu taklit eder. Page, Record Table ve Empty State hazır olduğunda yeni şey icat etmek yerine bunları birleştirirler.
- "X kullan, asla Y kullanma" şeklinde yazılan kurallara, "güzel görünsün" isteğinden çok daha tutarlı uyulur.
- Anlamsal token'lar (`bg-success-subtle`), `bg-green-500` gibi ham renk seçme ihtiyacını ortadan kaldırır.

<Callout type="info" title="İlgili sayfalar">
AI destekli uygulama geliştirme akışı için [AI ile Uygulama Geliştirme](https://builders.ikas.com/tr/docs/app-development/admin-app/ai-app-development) sayfasına bakın.
</Callout>
