> ## Documentation Index
> Fetch the complete documentation index at: https://developer.leaderos.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Yapay Zeka ile Tema Geliştirme

> Claude Code, Cursor ve benzeri araçlarla LeaderOS temanızı yapay zekaya geliştirtin.

Headless API baştan **yapay zeka ile çalışacak şekilde** tasarlanmıştır. Bir yapay zeka asistanına doğru bağlamı verirseniz, tüm temayı konuşarak geliştirebilir veya özelleştirebilirsiniz.

## Yapay zekaya verilen 4 bağlam kaynağı

| Kaynak | Ne sağlar | Nerede |
| - | - | - |
| `AGENTS.md` / `CLAUDE.md` | Proje kuralları, mimari, desenler, yasaklar | Şablonun kökünde |
| MCP sunucusu | Canlı endpoint arama, şema okuma, örnek çağrı | `.mcp.json` ([MCP](https://developer.leaderos.net/headless/tr/mcp.md)) |
| `llms-full.txt` | Tüm API'nin düz metin referansı | `https://siteniz.com/headless/llms-full.txt` |
| OpenAPI | Makine tarafından okunabilir tanım | `https://siteniz.com/headless/openapi.json` |

## Yöntem 1: Hazır şablon + Claude Code / Cursor (önerilen)

**1. Şablonu oluşturun**

```bash theme={null}
npm create leaderos-theme@latest my-theme
cd my-theme && npm install
```

Şablon `AGENTS.md`, `CLAUDE.md` ve `.mcp.json` ile gelir; ek kurulum gerekmez.

**2. Asistanı proje klasöründe başlatın**

```bash theme={null}
claude        # Claude Code
```

veya klasörü Cursor / Windsurf ile açın. Asistan `AGENTS.md`'yi otomatik okur ve `.mcp.json` ile MCP sunucusunu bağlar (ilk seferde onay isteyebilir).

**3. Geliştirme sunucusunu çalıştırın**

`npm run dev` ile sonucu canlı izleyin.

**4. İsteğinizi yazın**

Aşağıdaki örnek istemlerden birini kullanın.

### Örnek istemler

> [accordion] Tasarımı değiştirme
>
> > "Tüm siteyi koyu mor/neon bir oyun temasına çevir. Ana sayfadaki hero bölümünü yeniden tasarla, ürün kartlarını büyük görsel odaklı yap. Veri ve işlevler aynı kalsın."

> [accordion] Yeni sayfa
>
> > "Skor tablolarını gösteren yeni bir `/siralama` sayfası ekle. Önce site yapılandırmasına bakıp leaderboards modülünün açık olduğunu doğrula, değilse 404 ver."

> [accordion] Mağazayı özelleştirme
>
> > "Mağaza ana sayfasında kategorileri sol kenar çubuğuna al, ürün kartlarında indirim oranını rozet olarak göster."

> [accordion] Hata ayıklama
>
> > "Giriş yaptıktan sonra hesap sayfası EMAIL\_NOT\_VERIFIED veriyor. Neden? Doğru yönlendirmeyi yap."

## Yöntem 2: Mevcut/boş bir projede

Şablonu kullanmıyorsanız asistana şunları verin:

1. MCP sunucusunu ekleyin: `claude mcp add leaderos -e LEADEROS_URL=... -e LEADEROS_PUBLIC_KEY=... -- npx -y @leaderos/headless-mcp`
2. İlk mesajda API referansını gösterin:

> "Şu referansı oku: [https://siteniz.com/headless/llms-full.txt](https://siteniz.com/headless/llms-full.txt). Bu API ile bir Next.js mağaza sitesi yapacağız. @leaderos/headless-sdk kullan."

## Yöntem 3: Sohbet tabanlı araçlar (ChatGPT, Claude.ai, Gemini)

MCP kullanamıyorsanız `llms-full.txt` içeriğini sohbete yapıştırın veya dosyayı yükleyin ve hangi sayfayı istediğinizi anlatın. Küçük bileşenler ve tek sayfalar için yeterlidir; tüm projeyi yönetmek için Yöntem 1 çok daha verimlidir.

## `AGENTS.md` ne söyler?

Şablondaki `AGENTS.md` yapay zekanın uyması gereken kuralları içerir; örneğin:

* Hata kodlarına (`error.code`) göre dallan, mesaja göre değil.
* Giriş gerektiren her sayfada `requireAuth()` kullan.
* Modül kapalıysa özelliği gösterme (`isModuleActive` / `useModule`).
* Token'ı asla istemci durumunda veya `localStorage`'da tutma.
* Parasal değerlerde `*Formatted` alanlarını göster.
* `<PoweredBy />` bileşenini **asla kaldırma veya gizleme**.

Kendi kurallarınızı (renk paleti, bileşen kütüphanesi, kod stili) bu dosyanın sonuna ekleyerek asistanı yönlendirebilirsiniz.

> [!WARNING]
>
> Şablon, yapay zekaya "Powered by LeaderOS" bağlantısını kaldırmamasını açıkça söyler. Kullanıcı istese bile kaldırmaz; yalnızca `config.branding.canRemove` değeri `true` ise mümkündür. Bu bir lisans şartıdır.

## İyi sonuç için ipuçları

> [!TIP]
>
> * Küçük, net adımlarla ilerleyin: "ürün kartı → mağaza sayfası → sepet" gibi.
> * Asistana önce **neyi değiştirmeyeceğini** söyleyin ("API çağrılarına ve guard'lara dokunma").
> * Her adımdan sonra `npm run typecheck` ve `npm run build` çalıştırmasını isteyin.
> * Gerçek veriyi görmesi için MCP'yi açık tutun; bu uydurma alan adlarını büyük ölçüde önler.
> * Ödeme gibi kritik akışları değiştirdikten sonra mutlaka **test sitesinde** elle deneyin.

## Güvenlik uyarıları

* MCP'de `LEADEROS_ALLOW_WRITE=1` yalnızca test sitesinde kullanılmalıdır.
* Yapay zekaya **yönetim paneli şifrelerinizi veya veritabanı bilgilerinizi** vermeyin; Headless API için yalnızca public key yeterlidir.
* Üretilen kodu canlıya almadan gözden geçirin; özellikle form gönderimleri ve ödeme akışlarını.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.