Gemini CLI’ye alt ajan özelliği eklendi

• Gemini CLI, karmaşık ve tekrarlayan görevleri uzman alt ajanlara devredebilen çok ajanlı mimariyi resmi olarak desteklemeye başladı
• Her alt ajan, bağımsız bir context window, özel sistem talimatları ve kendine ayrılmış araç setiyle izole bir ortamda çalışıyor
• Markdown dosyaları ve YAML frontmatter ile özel alt ajanlar tanımlanabiliyor; bunlar global ya da proje düzeyinde ekiple paylaşılabiliyor
• Birden fazla alt ajan paralel olarak çalıştırılabildiği için araştırma, refactoring gibi çoklu işlerin toplam süresi ciddi biçimde kısalıyor
• Varsayılan gömülü ajanlar (generalist, cli_help, codebase_investigator) ile birlikte @agent sözdizimi üzerinden açık görev devri yapılabiliyor; böylece CLI tabanlı geliştirme iş akışının ölçeklenebilirliği artıyor

---

Alt ajan kavramı ve temel avantajlar

• Alt ajanlar, ana Gemini CLI oturumuyla birlikte çalışan uzman ajanlardır; karmaşık bir görev geldiğinde Gemini CLI stratejik orkestratör rolünü üstlenir ve alt görevleri en uygun alt ajana devreder
• Her alt ajan kendi tools, MCP sunucuları, sistem talimatları ve context window’una sahiptir ve tamamen izole biçimde çalışır
• Alt ajanın tüm yürütümü — onlarca araç çağrısı, dosya arama ve test çalıştırma dahil — tek bir yanıt içinde birleştirilerek ana ajana geri döner
  • Bu, ana context window’un dolmasını önler ve sonraki etkileşimlerde hız ile maliyet verimliliğini korur
• Öne çıkan üç temel avantaj:
  • Ana ajan genel hedefe, karar alma sürecine ve nihai yanıta odaklanabilir
  • Araştırma, kod inceleme, analiz ve test gibi işler için uzman alt ajanlar paralel çalıştırılarak iş hızı artırılabilir
  • Alt ajanlar özet ya da biçimlendirilmiş yanıtlar döndürdüğü için ana oturumda context rot ve context pollution önlenir

Özel alt ajan oluşturma

• Bir Markdown dosyasında (.md) YAML frontmatter kullanılarak özel alt ajan tanımlanır
• ~/.gemini/agents altına yerleştirildiğinde kişisel iş akışına yönelik global ajan olarak kaydolur; deponun .gemini/agents dizinine commit edildiğinde ise proje düzeyinde ekiple paylaşılabilir
• Gemini CLI extensions içindeki agents/ dizinine ajan tanım dosyaları eklenerek uzantının bir parçası olarak paketlemek de mümkündür
• Örnek olarak verilen frontend-specialist ajan yapılandırması:
  • Frontmatter içinde name, description, tools (read_file, grep_search, glob, list_directory, web_fetch, google_web_search), model: inherit vb. tanımlanır
  • Sistem talimatlarında Senior Frontend Specialist ve UI/UX Architect rolü atanır
  • Temel ilkeler olarak modüler mimari tasarımı, Core Web Vitals tabanlı performans optimizasyonu ve WCAG 2.1+ erişilebilirlik uyumu belirtilir
  • Kılavuzlarda tarayıcının yerel API’lerini öncelikli kullanma, Atomic bileşen tasarımı, duruma göre görsel geri bildirim (yükleniyor, skeleton, hata, boş durum, başarı), Progressive Enhancement ve bakım odaklı tasarım yer alır
  • Bu ajanın rolü analiz ve iyileştirme önerileriyle sınırlıdır; kodu doğrudan değiştirmez
• Dosya .gemini/agents/frontend-specialist.md konumuna yerleştirildiğinde Gemini CLI bunu anında yeni bir uzman olarak tanır

Paralel çalıştırma

• Gemini CLI, paralel alt ajan yürütümünü destekler; birden fazla alt ajan ya da aynı alt ajanın birden çok örneği aynı anda çalıştırılabilir
• Beş farklı konuyu araştırmak ya da birden fazla bağımsız bileşeni refactor etmek gerektiğinde birden çok ajan aynı anda devreye alınarak toplam süre önemli ölçüde azaltılabilir
• Açık istek örneği: "Run the frontend-specialist on each package in parallel."
• Dikkat edilmesi gerekenler:
  • Büyük ölçekli kod düzenleme işleri için paralel alt ajan kullanımı çatışmalara ve ajanların birbirinin kodunu ezmesine yol açabilir
  • Paralel çalıştırmada istekler aynı anda gönderildiği için kullanım limitlerine (usage limits) daha hızlı ulaşılabilir

Gömülü alt ajanlar ve kullanım şekli

• Gemini CLI ile birlikte gelen üç varsayılan alt ajan:
  • generalist: Tüm araçlara erişebilen genel amaçlı ajan; toplu refactoring veya çok sayıda çıktı üreten komutların çalıştırılması gibi turn yoğun görevler için uygundur (normal Gemini CLI ajanının alt ajan olarak kullanılan bir kopyası)
  • cli_help: Gemini CLI’nin kendisi konusunda uzman ajandır; Gemini CLI belgelerine doğrudan erişerek özellikle özelliklerle ilgili soruları yanıtlar
  • codebase_investigator: kod tabanı keşfi, mimari haritalama, hata kök neden analizi ve sistem genelindeki bağımlılıkların anlaşılması konusunda uzmanlaşmıştır
• Gemini CLI, alt ajanların description alanına göre otomatik yönlendirme yapar; ancak @agent sözdizimi ile belirli bir ajana görevi açıkça devretmek mümkündür
  • Örnek: @frontend-specialist ile uygulamayı inceleyip iyileştirme noktalarını işaretlemesini istemek
  • Örnek: @generalist ile proje genelindeki lisans başlıklarını güncellemek
  • Örnek: @codebase_investigator ile kimlik doğrulama akışını haritalamak
• @ simgesinden sonra alt ajan adı yazıldığında, görev o ajanın izole context window’u içinde işlenir
• Yapılandırılmış tüm alt ajanları görmek için Gemini CLI içinde /agents komutunu çalıştırın

[chlrhdmltkfkd]

gemini cli sadece düzgün çalışsa bari, sürekli çöküyor