Ana içeriğe atla
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ğı

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

1

Şablonu oluşturun

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

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

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

“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.”
“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.”
“Mağaza ana sayfasında kategorileri sol kenar çubuğuna al, ürün kartlarında indirim oranını rozet olarak göster.”
“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. 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.
Ş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ı

  • 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ı.