GEMINI.md nedir, nasıl yazılır

Ahmet Karaca · 30 Ekim 2026

GEMINI.md ne işe yarar?

Gemini CLI'ın her zaman bilmesi gereken talimatları tutar: projenin komutları, kod kuralları ve çalışma tercihlerin. Dosya, terminalde çalışan ajan Gemini CLI'a aittir. Tarayıcıdaki Gemini uygulamasını etkilemez; onun kendi ayarları vardır.

Zorunlu bir yapısı yoktur. Düz başlıklar ve kısa listeler yeterlidir; bir satır ancak ajanın davranışını değiştiriyorsa dosyada kalmaya değer.

Gemini CLI GEMINI.md'yi nerede arar?

Gemini CLI bulduğu bütün dosyaların içeriğini birleştirir ve sonucu her istemle birlikte gönderir. Yüklü bağlam dosyası sayısı CLI'ın alt çubuğunda görünür.

Yüklenenler nasıl görülür ve yenilenir?

• /memory show, birleştirilmiş metnin tamamını gösterir; modele verilen de tam olarak budur.
• /memory reload, bütün konumları yeniden tarar; oturum sırasında bir dosya düzenlendiğinde işe yarar.

Bir talimat dikkate alınmıyor gibi görünüyorsa önce /memory show denenmelidir: dosyanın yüklenip yüklenmediğini bu komut gösterir.

Proje GEMINI.md'sine ne yazılır?

Ajanın tahmin edemeyeceği komutlar, aksi hâlde bozacağı kurallar ve dokunmaması gereken dosyalar. Her depoda geçerli olabilecek kadar genel olan şeyler ise kişisel dosyaya aittir.

# Proje: billing-api

## Komutlar
- Test: npm test
- Her commit'ten önce lint: npm run lint

## Kurallar
- Bütün tutarlar en küçük birimde, tam sayı olarak tutulur.
- src/generated/ altındaki üretilmiş dosyalara dokunma.

Kişisel dosyaya ne yazılır?

~/.gemini/GEMINI.md, projenin değil senin nasıl çalıştığını anlatmanın yeridir. Her depoda seninle gelir ve kimseyle paylaşılmaz.

# Nasıl çalışıyorum

- Dosya silmeden ya da yıkıcı bir komut çalıştırmadan önce sor.
- Üçten fazla dosyayı değiştirmeden önce kısa bir plan öner.
- Commit mesajını deponun zaten kullandığı dilde yaz.

Gemini CLI bu dosyaya kendisi de yazabilir. Bir şeyi hatırlaması istendiğinde ajan bir Markdown hafıza dosyasını düzenler: depoyla paylaşılan talimatlar deponun GEMINI.md dosyasına, projeye özel notlar proje başına tutulan hafıza klasörüne, projeler arası kişisel tercihler ~/.gemini/GEMINI.md dosyasına gider. Bunlar sıradan dosyalardır; elle okunup düzeltilebilir.

Büyük bir GEMINI.md nasıl bölünür?

Bir dosya, göreli ya da mutlak yol kullanarak @dosya.md söz dizimiyle başka dosyaları içe aktarabilir. Böylece ana dosya kısa kalır ve birkaç proje aynı stil rehberini paylaşabilir.

# Project

@./docs/style-guide.md
@../shared/commit-rules.md

Gemini CLI GEMINI.md yerine AGENTS.md kullanabilir mi?

Evet, tek bir ayarla. Dosya adı settings.json içindeki context.fileName ile değiştirilebilir; bu ayar tek bir ad ya da bir liste kabul eder. Talimatlarını zaten AGENTS.md dosyasında tutan bir depo böylece Gemini CLI'a da aynı dosyadan hizmet verebilir.

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

Kaynaklar, kontrol tarihi: 30 Ekim 2026

• Gemini CLI docs: GEMINI.md files
• Gemini CLI docs: Memory files
• Gemini CLI docs: Manage context and memory
• Gemini CLI docs: Configuration