Yapay zekaya verilen 4 bağlam kaynağı
Yöntem 1: Hazır şablon + Claude Code / Cursor (önerilen)
1
Şablonu oluşturun
AGENTS.md, CLAUDE.md ve .mcp.json ile gelir; ek kurulum gerekmez.2
Asistanı proje klasöründe başlatın
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
Tasarımı değiştirme
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.”
Yeni sayfa
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.”
Mağazayı özelleştirme
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.”
Hata ayıklama
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:- MCP sunucusunu ekleyin:
claude mcp add leaderos -e LEADEROS_URL=... -e LEADEROS_PUBLIC_KEY=... -- npx -y @leaderos/headless-mcp - İ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ızllms-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
*Formattedalanlarını göster. <PoweredBy />bileşenini asla kaldırma veya gizleme.
İyi sonuç için ipuçları
Güvenlik uyarıları
- MCP’de
LEADEROS_ALLOW_WRITE=1yalnı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ı.
