---
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:

- Hangi ihtiyaç için hangi bileşenin kullanılacağı
- 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

```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
- Arayüz yazmadan veya değiştirmeden önce `ikas-ui.md` dosyasını oku ve uygula.
- Ekranları `@/components/ikas/*` ve `@/components/ui/*` ile kur.
- Eksik bir bileşen varsa kendin yazmadan önce `npx shadcn@latest add @ikas/<name>` ile kur
  (liste: 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>