Google Gemini Antigravity (AGY) Mimarisi: .agents/skills/SKILL.md Hiyerarşisi ve Üretkenliği 10 Katına Çıkaran En Popüler 10 Mühendislik Skill’i

Google Gemini Antigravity (AGY) Mimarisi: Ajan-Öncelikli Geliştirme ve Özelleştirme Sistemi

Google DeepMind’ın Gelişmiş Ajanik Kodlama (Advanced Agentic Coding) ekibi tarafından tasarlanan Google Antigravity (AGY / Antigravity 2.0), yazılım geliştirme yaşam döngüsünü tekil bir sohbet penceresinden çıkarıp çoklu ajan orkestrasyonuna, arka plan görev motorlarına ve hiyerarşik bilgi paketlerine dayandıran ajan-öncelikli (AI-first) bir mühendislik platformudur. Hem bağımsız masaüstü uygulaması (Antigravity 2.0), hem Antigravity IDE, hem komut satırı arayüzü (agy CLI) hem de programatik Python SDK yüzeylerine sahip olan platform, genel amaçlı bir dil modelini projenin iç mimarisine hakim kıdemli bir sistem mühendisine dönüştürmek için Antigravity Özelleştirme Sistemi (Customization System) katmanını kullanır.

Resmi Antigravity dokümantasyonunda tanımlandığı üzere bu ekosistem beş temel yapı taşından oluşur:

• Rules (GEMINI.md, AGENTS.md, .agents/rules/*.md): Kodlama standartlarını, sıfır harici CDN ilkelerini ve mimari kısıtlamaları dosya dizininden depo köküne doğru yürüyerek (hierarchical walk-up) uygulayan kurallar.
• Skills (.agents/skills/<skill_name>/SKILL.md): Çok adımlı mühendislik prosedürlerini, yardımcı betikleri (scripts/) ve referans kılavuzlarını (references/) barındıran modüler çalışma kitapları (runbooks).
• Plugins (plugins/<name>/plugin.json): İlgili skill, kural, kanca ve MCP sunucularını tek bir isim uzayı altında paketleyen birimler.
• Hooks (hooks.json) ve MCP Servers (mcp_config.json): Ajan yaşam döngüsü olaylarında (örneğin araç çalıştırma öncesi) tetiklenen betikler ve harici veri/araç sağlayıcıları.

Aşamalı Bağlam Açıklaması (Progressive Disclosure) ve 5 Katmanlı Yükleme Önceliği

Büyük ölçekli kurumsal depolarda yüzlerce sayfalık operasyon kılavuzunun her istemde (prompt) modelin bağlam penceresine (context window) yüklenmesi hem yüksek token maliyetine hem de bağlam kirliliğine (context pollution) yol açar. Antigravity bu sorunu Progressive Disclosure (Aşamalı Açıklama) mimarisiyle çözer:

1. Sıfır Ön Yükleme: Varsayılan olarak hiçbir SKILL.md dosyasının gövdesi bağlam penceresine yüklenmez. Ajanın sistem istemine yalnızca her skill'in name ve description alanları enjekte edilir.
2. İhtiyaç Anında Aktivasyon: Kullanıcı bir görev verdiğinde veya /skill-adi slash komutunu tetiklediğinde, ajan description alanını değerlendirir ve yalnızca ilgili SKILL.md dosyasını view_file ile okur. Daha hacimli alt belgeler ise references/ klasöründe tutulur ve sadece ilgili alt adım gerektirdiğinde okunur.
3. 5 Katmanlı Keşif ve Öncelik Hiyerarşisi: Aynı isimli özelleştirmeler çakıştığında Antigravity yukarıdan aşağıya şu öncelik sırasını uygular: (1) Workspace Project (.agents/skills/) $\rightarrow$ (2) Declared Workspace JSON (skills.json / plugins.json) $\rightarrow$ (3) Global Discovery (~/.gemini/config/skills/) $\rightarrow$ (4) Built-in Customizations $\rightarrow$ (5) Global Declared JSON.

.agents/skills/<skill_name>/
├── SKILL.md          # Zorunlu: YAML frontmatter (name, description) ve ana prosedür
├── scripts/          # İsteğe bağlı: Otomasyon ve doğrulama betikleri (.mjs, .py, .sh)
├── examples/         # İsteğe bağlı: Referans kod ve yapılandırma örnekleri
├── resources/        # İsteğe bağlı: Şablonlar ve statik varlıklar
└── references/       # İsteğe bağlı: İhtiyaç anında okunan derin teknik belgeler

Üretkenliği 10 Katına Çıkaran En Popüler 10 Antigravity Skill’i

Kurumsal yazılım mühendisliği, siber güvenlik, kalite güvencesi ve dağıtım operasyonlarında en yüksek kaldıraç etkisi yaratan 10 Antigravity Skill mimarisi aşağıda teknik detayları ve şablonlarıyla incelenmektedir.

1. Otonom Alt Ajan Takımı Orkestrasyonu (multi-service-team)

Tek bir ajanın 7-8 farklı mikroservisi aynı bağlam penceresinde değiştirmeye çalışması bağlam bulaşmasına yol açar. Bu skill, Antigravity'nin yerleşik define_subagent, invoke_subagent ve send_message araçlarını kullanarak her mikroservis için özel bir uzman alt ajan tanımlar. Alt ajanlar arka planda eşzamanlı çalışır ve işleri bittiğinde ana orkestratör ajana rapor verir.

---
name: multi-service-team
description: >-
  Çoklu mikroservis mimarilerinde her servisi bağımsız uzman alt ajanlarla
  (define_subagent & invoke_subagent) koordine eder. Servisler arası entegrasyon,
  JWKS/RabbitMQ sözleşmeleri ve paralel geliştirme isteklerinde kullan.
---

# Çoklu Mikroservis Ajan Takımı Orkestrasyonu

1. Görevi analiz et ve etkilenen servisleri belirle.
2. Salt-okuma araştırma görevleri için `TypeName: "research"` alt ajanlarını paralel başlat.
3. Kod değişikliği gerektiren servisler için `define_subagent` (`enable_write_tools: true`) ile
   uzman ajan tanımla ve `invoke_subagent` (`Model: "inherit"`) ile görevlendir.
4. Alt ajanlar çalışırken döngüsel yoklama (polling) yapma; Reactive Wakeup mesajını bekle.

2. 4 Kanallı Gerçek Tarayıcı Doğrulamalı E2E QA Skill’i (e2e-test-team)

Birim testlerinin (unit tests) geçmesi, sistemin üretimde çalıştığı anlamına gelmez. Bu skill, ajanın gerçek tarayıcı araçlarını ve arka plan doğrulamalarını kullanarak sistemi farklı kullanıcı rolleriyle (Yönetici, Kiracı, Son Kullanıcı) uçtan uca test etmesini sağlar. Her "başarılı" iddiası dört bağımsız kanalla kanıtlanmak zorundadır:

• Kanal 1 — Ağ Kanıtı: İlgili API çağrısının HTTP 200/201 döndüğünün ve yanıt gövdesinin doğrulanması.
• Kanal 2 — Yenileme ve Kalıcılık (F5): Sayfa yenilendiğinde verinin kaybolmadığının (yalnızca yerel React/Vue state'inde kalmadığının) kanıtlanması.
• Kanal 3 — Karşı Rol / Çapraz Servis: Başka bir rolün veya kiracının bu veriyi yetkisiz göremediğinin (veya ilgili alt serviste olayın işlendiğinin) doğrulanması.
• Kanal 4 — Salt-Okuma Backend Kontrolü: PostgreSQL, Redis, RabbitMQ veya Mailpit üzerinde kaydın fiziksel olarak oluştuğunun doğrulanması.

3. Savunma Amaçlı Sızma Testi ve IDOR/SSRF Denetçisi (security-pentest-team)

Güvenlik odaklı commit'lerden sonra veya sürüm öncesinde çalıştırılan bu skill, yerel/izinli test ortamında savunma amaçlı sızma testi (defensive pentest) yürütür. Odaklandığı başlıca vektörler:

• IDOR / BOLA ve Yetki Matrisi: Kullanıcı A'nın JWT jetonuyla Kullanıcı B'nin kaynak kimliklerine (UUID / id) erişim denemeleri.
• SSRF ve SSTI Koruması: Webhook, PDF/görsel üretimi ve şablon motorlarında iç ağ (169.254.169.254, 127.0.0.1, localhost) erişim engellerinin testi.
• Token ve İmza Doğrulaması: RS256 JWKS, alg: none reddi, x5c sertifika zinciri doğrulaması ve ödeme/yetki servisi erişilemez olduğunda sistemin fail-closed (erişimi reddederek güvenli kapanma) davranışının doğrulanması.

4. Backend DTO ve Frontend TypeScript Sözleşme Kayması Yakalayıcı (contract-check)

Modern tam yığın (full-stack) projelerde "beyaz ekran" hatalarının birincil nedeni, backend'deki bir Java/Kotlin/Go DTO alan adının veya enum değerinin değişmesine rağmen Web veya Mobil TypeScript arayüzlerinin eski şemayı beklemesidir. Bu skill, commit öncesinde backend sınıfları ile istemci .ts / .tsx tiplerini çapraz tarayarak:

• API'nin göndermediği ancak UI'ın okuduğu alanları,
• camelCase / snake_case serileştirme uyumsuzluklarını,
• Eksik enum sabitlerini ve Web ile Mobil istemcilerin aynı DTO'yu farklı tanımladığı noktaları raporlar.

5. Sıfır Token Maliyetli Reactive Wakeup Otomasyonu (reactive-queue-watcher)

Antigravity'nin en güçlü mimari özelliklerinden biri Reactive Wakeup mekanizmasıdır. Uzun süreli bir dış kuyruk (örneğin Telegram /yaz komut kuyruğu, CI/CD derleme sonucu veya veri hattı) beklendiğinde ajan sleep döngüsüne girip token harcamaz. Bunun yerine hafif bir Node.js/Python dinleyici betiğini run_command (IsDaemon: false, WaitMsBeforeAsync: 2000) ile arka plana gönderir ve başka hiçbir araç çağırmadan turunu sonlandırır:

// scripts/queue-watcher.mjs — Boşta 0 Token Tüketen Reactive Wakeup Dinleyicisi
while (true) {
  const res = await fetch(`${API_URL}/api/jobs/claim`, { method: "POST", headers });
  const data = await res.json();
  if (data.job) {
    console.log("🚀 NEW JOB CLAIMED:", JSON.stringify(data, null, 2));
    process.exit(0); // Süreç 0 koduyla çıktığı anda Antigravity ajanı otomatik uyandırır!
  }
  await new Promise((r) => setTimeout(r, 15_000));
}

Arka plan görevi tamamlandığı (process.exit(0)) anda Antigravity çalışma zamanı ajanı yüksek öncelikli <SYSTEM_MESSAGE> ile otomatik olarak uyandırır. İş tamamlandığında ajan aynı dinleyiciyi yeniden başlatarak sonsuz ve sıfır token maliyetli bir otonom döngü kurar.

6. Veritabanı Veri Hijyeni ve Test Kalıntısı Denetçisi (data-hygiene-auditor)

Otomasyon testleri zamanla veritabanında [QA TEST] kayıtları, aynı ad-soyada sahip mükerrer profiller, ebeveyn kaydı silinmiş öksüz (orphan) satırlar ve mikroservisler arası kopuk yabancı anahtarlar (cross-service broken IDs) bırakır. Bu skill kesinlikle salt-okuma (read-only) modunda çalışır; hiçbir veriyi otomatik silmez, yalnızca kirli kayıtların tam SQL dökümünü ve temizlik planını üretir.

7. Canlı Sunucu (SSH / Docker) Dağıtım ve Sağlık Koordinatörü (prod-system-ops)

Üretim (prod) ve geliştirme-test (dev-test) sunucularının yönetimini standartlaştıran bu skill; hangi sunucuda hangi Docker konteynerlerinin çalıştığını, port eşlemelerini, .env.production gizli anahtar kurallarını ve sağlık kontrolü (curl -fsS https://.../health) adımlarını içerir. Ajan, sunucuya SSH üzerinden bağlandığında rastgele komutlar çalıştırmak yerine SKILL.md içindeki onaylı dağıtım ve log inceleme (docker logs --tail 100) prosedürlerini izler.

8. Etkileşimli Generative UI Widget ve Görselleştirme Skill’i (generative-ui)

Karmaşık bir sistem mimarisini, bellek yerleşimini veya finansal projeksiyonu düz metinle anlatmak yerine Antigravity'nin yerleşik generative_ui yeteneğini devreye sokar. Ajan; kaydırıcılar (sliders), canlı durum makineleri, SVG topoloji grafikleri ve etkileşimli hesaplayıcılar içeren bağımsız HTML widget'ları üreterek doğrudan kullanıcı arayüzünde sunar.

9. İzole Workspace (share / branch) Tabanlı Göç ve Refactor Skill’i (migrate-workflows)

Geniş kapsamlı bir kütüphane yükseltmesi veya eski iş akışlarının modern skill mimarisine göçü sırasında ana çalışma dizinini (main working tree) kirletmek tehlikelidir. Antigravity'nin invoke_subagent aracındaki Workspace parametresi üç mod sunar:

• "inherit": Ebeveyn ajanla aynı çalışma dizinini paylaşır.
• "branch": Alt ajan için tamamen izole, klonlanmış yeni bir çalışma alanı oluşturur.
• "share": Git worktree veya Mercurial hg share mantığıyla depo depolamasını kopyalamadan bağımsız dal (branch) açar. Göç ve büyük refactor skill'leri Workspace: "share" kullanarak değişiklikleri izole ortamda doğrular.

10. Çok Aşamalı Yayın Kapısı Doğrulayıcısı (release-gate)

Bir özelliğin veya hata düzeltmesinin "tamamlandı" sayılabilmesi için gereken zorunlu kontrol listesidir. release-gate skill'i; derleme/linter kontrolü, contract-check uyumu, birim/entegrasyon testleri, data-hygiene kontrolü ve bağımsız bir Reviewer alt ajanının onayını (STATUS: APPROVED) tek bir deterministik kapıda birleştirir.

En Popüler 10 Antigravity Skill’i — Mimari Karşılaştırma Matrisi

Aşağıdaki tablo, Antigravity ekosistemindeki bu 10 temel skill'in tetikleme koşullarını, kullandığı çekirdek araçları ve mühendislik çıktılarını özetlemektedir:

Mimari Değerlendirme

Google Gemini Antigravity (AGY), .agents/skills/SKILL.md standardı ve Progressive Disclosure prensibi sayesinde kurumsal mühendislik bilgisini sürüm kontrol sistemine (git) dahil edilebilir, paylaşılabilir ve deterministik olarak yürütülebilir kod varlıklarına dönüştürmektedir. Otonom Alt Ajan Takımları, 4 Kanallı E2E QA, Savunma Amaçlı Pentest ve Sıfır Token Maliyetli Reactive Wakeup skill'lerinin bir arada kullanılması; yazılım ekiplerinin yalnızca kod yazma hızını değil, aynı zamanda mimari tutarlılığını ve siber güvenlik direncini de üst seviyeye taşımaktadır.