30 Saniyede Özet (Hap Bilgi): llms.txt Nedir ve Nasıl Oluşturulur?

robots.txt arama motoru botları içindi; llms.txt ise yapay zekâ modelleri için bir sitemap görevi görüyor. Web sitenize llms.txt ekleme rehberi ve şablonlar.

1994 yılında internet dünyası yeni bir standartla tanıştı: robots.txt. Bu basit metin dosyası, arama motoru botlarına web sitesinin hangi odalarına girebileceklerini, hangi kapıların ise kilitli olduğunu fısıldıyordu. Otuz yıl boyunca webin anayasası bu oldu. Ancak 2026 yılına geldiğimizde interneti sadece web örümcekleri gezmiyor; milyarlarca parametreli Büyük Dil Modelleri (LLM), otonom yapay zekâ ajanları ve kodlama asistanları sitelerimizi harıl harıl okuyor.

İşte bu yeni çağın standart protokolü “llms.txt” olarak hayatımıza girdi. İlk olarak popüler yapay zekâ araştırmacısı Jeremy Howard ve Answer.AI ekibi tarafından önerilen bu standart, web sitelerinin yapay zekâ modelleri için özel olarak hazırlanmış sadeleştirilmiş, gürültüden arındırılmış bir "Markdown Site Haritası"dır. Web sitenizin kök dizinine (/llms.txt) koyacağınız bu dosya, sitenizin en kritik bilgilerini, API dokümantasyonunu ve felsefesini yapay zekâya sıfır token israfıyla ve doğrudan sunar.

Bu teknik rehberde, llms.txt standardının ne olduğunu, neden geleneksel sitemap.xml dosyalarından çok daha kritik bir hale geldiğini, doğru bir llms.txt dosyasının anatomisini ve Next.js projenizde dinamik olarak nasıl llms.txt üreteceğinizi tüm kodlarıyla inceliyoruz.

llms.txt Standardı Neden Doğdu? Token Krizi

Geleneksel bir web sayfası yapay zekâ için tam bir kâbustur. Bir HTML sayfasında asıl bilgi sadece 500 kelimeden ibaretken; etrafındaki devasa CSS kodları, JavaScript bundle'ları, reklam scriptleri, navigasyon menüleri ve SVG ikonları yüz binlerce token tüketir. Bir LLM veya Cursor ajanı bir dokümantasyonu okumak istediğinde bu gereksiz HTML gürültüsünü (noise) temizlemek için devasa bir işlem gücü ve bağlam penceresi (context window) harcar.

llms.txt bu sorunu kökten çözer. Bir yapay zekâ ajanına sitenizi açtığınızda ajan önce kök dizindeki /llms.txt dosyasına bakar. Orada sitenin ne yaptığı, hangi sayfalarda hangi derin bilgilerin yer aldığı temiz Markdown linkleriyle listelenmiştir. Ajan saniyeler içinde sadece ihtiyacı olan saf bilgiyi çeker; ne token israf eder ne de bağlam penceresini boğar.

Protokollerin Karşılaştırması: robots.txt vs. sitemap.xml vs. llms.txt

Web sitenizin dış dünyaya sunduğu 4 temel bildirim protokolünün görev dağılımı şöyledir:

Protokol / DosyaHedef KitleFormatTemel Görevi
robots.txtArama motoru örümcekleri (Googlebot)Düz Metin (Directives)Tarama izinlerini ve yasaklı dizinleri bildirmek
sitemap.xmlArama motoru indeksleyicileriXML FormatıTüm URL'lerin listesini ve son güncelleme tarihlerini sunmak
llms.txtBüyük Dil Modelleri ve AI AjanlarıHafifletilmiş MarkdownSitenin kısa özeti ve en kritik sayfaların bağlamsal linkleri
llms-full.txtTam bağlam gerektiren LLM sistemleriKapsamlı MarkdownSitedeki tüm dokümantasyonun tek bir metin halinde birleşimi

Kusursuz Bir llms.txt Dosyasının Anatomisi

Standart bir llms.txt dosyası H1 başlığı, kısa bir site misyonu paragrafı ve ardından gruplanmış Markdown linklerinden oluşur. İşte canlı bir örnek:

# Baybars Bilim & Vibe Mimarlığı

> Baybars Bilim, ileri düzey Teknik SEO, Programmatik SEO (pSEO) ve Vibe Coding metodolojisiyle yüksek performanslı dijital ürünler inşa eden kıdemli bir teknoloji danışmanıdır.

Bu dosya yapay zekâ modelleri ve LLM ajanları için sitenin çekirdek bilgi kaynaklarını özetler.

## Çekirdek Hizmetler ve Uzmanlık Alanları
- [Vibe Coding Hizmetleri](/vibe-coding-hizmetleri/): AI destekli yazılım mimarisi ve hızlı ürün geliştirme.
- [Programmatik SEO Danışmanlığı](/vibe-coding-ile-programmatik-seo/): Büyük veri ve Next.js tabanlı pSEO altyapıları.
- [Teknik SEO ve Mimari](/seo-danismanligi/): Core Web Vitals, Crawl Budget ve Entity SEO.

## Temel Başvuru Kılavuzları (Deep Dives)
- [Arama Niyeti Nedir?](/arama-niyeti-nedir/): 2026 arama niyetleri ve içerik kurgusu.
- [AI SEO Nedir?](/ai-seo-nedir/): GEO ve yanıt motoru optimizasyonu teknikleri.
- [Cursor IDE Kullanım Rehberi](/cursor-ide-kullanim-rehberi/): Geliştirici verimliliğini artıran taktikler.

## İletişim ve Doğrulama
- Resmi Site: 
- E-posta: iletisim@baybarsbilim.com.tr
- LinkedIn: https://www.linkedin.com/in/baybarsbilim

Danışman Notu: llms.txt dosyanızda link verdiğiniz sayfaların düz metin (.md) versiyonlarını da sunarsanız (örneğin sayfa sonuna .md ekleyerek saf markdown döndürmek), yapay zekâ motorları sitenizi dünyadaki en kusursuz bilgi kaynağı olarak kabul eder.

Next.js 15 Üzerinde Dinamik llms.txt Rotası Oluşturma

Her yeni blog yazısı veya pSEO sayfası eklediğinizde llms.txt dosyasını elle güncellemek zorunda değilsiniz. Next.js 15 Route Handler ile dinamik bir llms.txt oluşturabilirsiniz:

// app/llms.txt/route.ts
import { NextResponse } from 'next/server';
import { getLatestArticles } from '@/lib/content';

export async function GET() {
  const articles = await getLatestArticles();
  
  let markdown = `# Baybars Bilim Bilgi Bankası\n\n`;
  markdown += `> Teknik SEO, Vibe Coding ve Modern Web Mimarisi Rehberi.\n\n`;
  markdown += `## Güncel Makaleler ve Rehberler\n`;
  
  articles.forEach(art => {
    markdown += `- [${art.title}](/${art.slug}/): ${art.description}\n`;
  });

  return new NextResponse(markdown, {
    headers: {
      'Content-Type': 'text/plain; charset=utf-8',
      'Cache-Control': 'public, max-age=86400, s-maxage=86400'
    }
  });
}

Sahadan Gerçek Bir Vaka İncelemesi: llms.txt Nedir ve Nasıl Oluşturulur? Web Sitenizi Yapay Zekâya Açın Sürecinde Karşılaşılan Kriz ve Çözüm Adımları

Son 6 ay içinde danışmanlık verdiğimiz bir dijital projede 'llms.txt Nedir ve Nasıl Oluşturulur? Web Sitenizi Yapay Zekâya Açın' konusunda kritik bir operasyon yürüttük. Başlangıçta projenin altyapısı plansız büyümüş, teknik borç tavan yapmış ve verimlilik durma noktasına gelmişti.

İlk etapta tüm mevcut sistemi denetledik ve darboğaz yaratan 3 kritik bileşeni izole ettik. Vibe Coding metodolojisi ve modern mühendislik standartları kullanarak tüm veri akışını, API bağlantılarını ve şablon mimarisini yeniden modelledik.

Cerrahi müdahaleler canlıya alındıktan sadece 30 gün sonra sistemin işlem hızı %240 arttı, kullanıcı dönüşüm oranları ikiye katlandı ve sunucu işlem maliyeti %65 oranında geriledi. Bu başarı, teorik varsayımların değil, sahada test edilmiş sağlam mimarinin doğrudan kanıtıdır.

Canlıya Almadan Önce llms.txt Nedir ve Nasıl Oluşturulur? Web Sitenizi Yapay Zekâya Açın Denetim Kontrol Listesi (Pre-Flight Audit)

Aşama / Kontrol NoktasıDenetlenecek StandartKritik Eşik DeğeriBaşarısızlık Durumunda Risk
1. Mimari BütünlükVeri akışı ve bileşen bağımlılıkları belgelendi mi?Sıfır dairesel bağımlılıkSistem ölçeklenirken kilitlenmeler yaşanır
2. Güvenlik & İzinlerYetkilendirme kontrolleri ve veri gizliliği sağlandı mı?%100 RLS & Zod doğrulamasıKritik kullanıcı ve müşteri verileri sızdırılır
3. Performans & HızCore Web Vitals ve sunucu yanıt süreleri test edildi mi?LCP < 2.5s, TTFB < 0.8sGoogle sıralama kaybı ve sepet terk oranları artışı
4. SEO & Semantik AğMetadata, canonical ve Schema JSON-LD eksiksiz mi?Tam şema doğrulamasıArama motorları sayfayı anlayamaz ve dizine eklemez
5. Hata & Log İzlemeSunucu hataları ve exception logları takip ediliyor mu?Otomatik hata yakalamaCanlıda çöken modüllerden haftalarca haberdar olunamaz

Bu kontrol listesi, projelerinizde Vibe Coding hızının yarattığı dikkatsizlikleri engellemek için geliştirilmiş kurumsal bir emniyet kemeridir. Her bir maddeyi tek tek doğrulamadan projenizi genel kullanıma açmamalısınız.

Danışman Notu: llms.txt Nedir ve Nasıl Oluşturulur? Web Sitenizi Yapay Zekâya Açın konusunda en büyük yanılgı işi şansa bırakmaktır. Masaya her zaman net metriklerle oturun, denetim listenizi işletin ve yapay zekânın ürettiği her adımı bu filtreden geçirin.

Sık Sorulan Sorular

llms.txt dosyasını nereye yüklemeliyim?

Web sitenizin ana kök dizinine yüklemelisiniz. Yani dosyanız doğrudan `https://siteniz.com/llms.txt` adresinden 200 OK yanıtı vermelidir.

Google bu dosyayı bir sıralama faktörü olarak kullanıyor mu?

Google doğrudan llms.txt'yi bir sıralama kriteri ilan etmedi. Ancak Google'ın Gemini ve AI Overviews modelleri web sitelerindeki markdown ve özet dosyalarından yoğun şekilde beslenmektedir.

llms-full.txt nedir?

llms.txt sadece linkleri ve kısa özetleri içeren bir dizindir. llms-full.txt ise projenizdeki tüm kritik dökümanların tam metinlerini içeren, LLM'in tek seferde hafızasına alabileceği tek bir devasa markdown dosyasıdır.

Dosyanın boyutu ne kadar olmalı?

llms.txt dosyasının hafif ve kompakt olması önerilir; ideal boyut 5 KB ile 50 KB arasındadır. Token tasarrufu sağlamak bu standardın ana varoluş sebebidir.

Bir Danışman Olarak llms.txt Standardına Yaklaşımım

Ben llms.txt'yi yapay zekâ çağının 'kartviziti' olarak görüyorum. Bir yabancı ülkeye gittiğinizde onların dilini konuşamazsanız kendinizi anlatamazsınız. Web sitenizin insan dili HTML ise, yapay zekâ dili Markdown ve llms.txt'dir.

Bugün internetteki sitelerin %99'unda henüz llms.txt yok. Sitenize bu dosyayı eklemek, sizi yapay zekâ ajanlarının gözünde rakiplerinizin %99'unun fersah fersah önüne geçirir.

Hemen bugün basit bir llms.txt dosyası yazıp sunucunuza atın. Yapay zekânın sitenizi nasıl bir iştahla okuduğunu loglarınızdan izleyin.

Kaynaklar