Tüm Yazılara Dön/Yapay Zeka & Gelecek
Teknik MakaleYapay Zeka & Gelecek·9 Kasım 2026·7 dk okuma

Google AI'dan Kodlama Ajanlarına Mühendislik Disiplini: Spesifikasyon Odaklı Geliştirme (SDD), 'Elephant-Goldfish' Modeli ve Deterministik Doğrulama

Üretken hız ('Vibe Coding') tuzağından çıkıp, Addy Osmani'nin 'agent-skills' çerçevesi, Spesifikasyon Odaklı Geliştirme (SDD), Google açık kaynak ekosistemindeki 'Elephant-Goldfish' (Fil-Japon Balığı) oturum mimarisi ve deterministik doğrulama kapılarıyla kurumsal ajan mühendisliği.

Google AI'dan Kodlama Ajanlarına Mühendislik Disiplini: Spesifikasyon Odaklı Geliştirme (SDD), 'Elephant-Goldfish' Modeli ve Deterministik Doğrulama

'Vibe Coding' Tuzağından Ajanik Yazılım Mühendisliğine (Agentic Engineering) Geçiş

Büyük dil modellerinin (LLM) ve otonom kodlama ajanlarının yazılım geliştirme süreçlerine dahil olması, ilk aşamada denetimsiz istemlerle hızlı prototip üretimi olarak tanımlanan 'Vibe Coding' yaklaşımını yaygınlaştırmıştır. Ancak kurumsal ölçekli kod tabanlarında mimari sınırlar tanımlanmadan yürütülen bu hızlı üretim süreci; örtük teknik borç birikimine, bağlam kaymasına (context drift), güvenlik zafiyetlerine ve bakımı zorlaşan şişkin kod bloklarına ('code slop') yol açmaktadır.

Google ekosisteminde (Chrome, Google Cloud AI, Antigravity 2.0, Gemini CLI ve Google Jules) şekillenen mühendislik yaklaşımları ve Google mühendislik liderlerinden Addy Osmani tarafından açık kaynaklı agent-skills çerçevesiyle sistematize edilen Ajanik Mühendislik (Agentic Engineering) disiplini, bu yapısal sorunu çözmek üzere deterministik yazılım mühendisliği ilkelerini ajan iş akışlarına entegre etmektedir. Bu paradigmada yazılım mühendisi, doğrudan satır satır kod yazımını kapsayan İç Döngü'yü (Inner Loop) otonom ajanlara devrederken; sistem mimarisi, veri sözleşmeleri, güvenlik sınırları ve doğrulama kapılarını kapsayan Dış Döngü'nün (Outer Loop) tam mülkiyetini üstlenmektedir.

mermaid
flowchart TD
    subgraph OuterLoop["Dış Döngü (Outer Loop) — Mühendis & 'Elephant' Oturumu"]
        A["Mimari Kararlar & Sistem Sınırları"] --> B["Dondurulmuş Spesifikasyon (SDD Sözleşmesi)"]
        B --> C["Bağlam Dosyaları (GEMINI.md / AGENTS.md / CIDER_AGENT.md)"]
    end

    subgraph InnerLoop["İç Döngü (Inner Loop) — Durumsuz 'Goldfish' Ajanları"]
        C --> D["Durumsuz Uygulama Ajanı (Sıfır Geçmişli Kod Sentezi)"]
        D --> E["Deterministik Doğrulama Kapısı (Statik Analiz, Tip & Birim Testler)"]
        E --> F["Bağımsız 'Goldfish' Denetim Ajanı (Anti-Rasyonalizasyon Kontrolü)"]
    end

    F -- "İhlal / Başarısız Test" --> D
    F -- "Tam Uyum (ExitCode == 0)" --> G["Onaylanmış PR & Üretim Birleştirmesi"]

1. Spesifikasyon Odaklı Geliştirme (Spec-Driven Development - SDD)

Geleneksel yazılım geliştirmede kaynak kod tek doğruluk kaynağı (Single Source of Truth) kabul edilirken, tasarım belgeleri genellikle koda paralel olarak güncelliğini yitiren ikincil dokümanlar konumundadır. Spesifikasyon Odaklı Geliştirme (SDD) ise bu hiyerarşiyi tersine çevirir: gerçek kaynak, versiyon kontrolünde tutulan yapılandırılmış spesifikasyon olup; üretilen kaynak kod bu spesifikasyonun derlenmiş bir çıktısı olarak ele alınır.

SDD iş akışı dört temel aşamadan oluşmaktadır:

  1. Spesifikasyonun Tanımlanması (Specify): Kodlama ajanı tek bir satır üretim kodu yazmadan önce; girdi/çıktı şemalarının, değişmez kuralların (invariants), hata durumlarının ve performans sınırlarının açık bir sözleşme olarak belgelenmesi.
  2. Yürütme Planlaması (Plan): Google Jules ve Google Antigravity 2.0 gibi platformlarda ajanın, hangi dosyaların hangi sırayla değiştirileceğini ve hangi bağımlılıkların etkileneceğini gösteren deterministik bir yürütme planı çıkarması.
  3. Atomik Görev Ayrıştırması (Tasks): Büyük mimari hedeflerin, tek bir bağlam penceresinde hatasız uygulanabilecek ve bağımsız olarak test edilebilecek küçük, izole iş paketlerine bölünmesi.
  4. Kısıtlanmış Uygulama (Implement): Ajanın yalnızca onaylanan görev paketi sınırları içinde kod üretmesi; kapsam dışı dosya değişikliklerinin (scope creep) otomatik olarak reddedilmesi.

Bağlam Yönlendirme Dosyaları (GEMINI.md, AGENTS.md, CIDER_AGENT.md) ve Sınırları

Proje kök dizininde konumlandırılan GEMINI.md, AGENTS.md veya Google'ın iç geliştirme ortamı Cider'da kullanılan CIDER_AGENT.md dosyaları, ajanların her oturum başında okuduğu kalıcı mimari kuralları barındırır. Ancak Google'ın kurumsal bulguları, yalnızca doğal dilde yazılmış stil rehberlerinin uzun oturumlarda ajanlar tarafından esnetilebildiğini göstermektedir. Bu nedenle yönlendirme dosyalarındaki her kuralın, derleme zamanında veya CI/CD boru hattında çalışan yürütülebilir bir doğrulama komutuyla (linter, AST kuralı, sözleşme testi) eşleştirilmesi gerekmektedir.


2. 'Elephant-Goldfish' (Fil-Japon Balığı) Oturum Mimarisi

Otonom kodlama ajanlarında karşılaşılan en kritik güvenilirlik sorunu Bağlam Zehirlenmesi (Context Poisoning) ve Bağlam Kayması (Context Drift) olgusudur. Tek bir sohbet oturumu içinde hem mimari tartışmaların yapılması, hem kodun yazılması, hem de derleme hatalarının ayıklanması; bağlam penceresinin başarısız denemeler ve yığın izleriyle (stack traces) dolmasına neden olur. Dikkat mekanizması dağılan model, oturumun başında verilen temel mimari kısıtlamaları unutmaya başlar.

Google açık kaynak kanallarında paylaşılan 'Elephant-Goldfish' (Fil-Japon Balığı) Modeli (EGM), bu sorunu çözmek için bilişsel yükü iki farklı ajan profiline ayırır:

Özellik Fil (Elephant) Oturumu Japon Balığı (Goldfish) Oturumu
Bilişsel Rol Baş Mimar & Sistem Hafızası İzole Uygulayıcı & Bağımsız Denetçi
Bağlam Süresi Uzun ömürlü, geçmiş kararlara ve proje vizyonuna hakim Durumsuz (stateless), görev bittiğinde tamamen sıfırlanan kısa ömürlü oturum
Yazma Yetkisi Yalnızca spesifikasyon, ADR ve görev tanımı üretir; üretim kodu yazması yasaktır Yalnızca verilen spesifikasyon kapsamındaki hedef dosyaları düzenler
Önyargı Koruması Sistem genelindeki tutarlılığı ve çapraz servis etkilerini gözetir Önceki tartışma geçmişini bilmediği için varsayımda bulunamaz; yalnızca yazılı sözleşmeyi uygular

Bu mimaride, ilk Japon Balığı oturumu kodu yazdıktan sonra, kodu yazan ajanın içsel rasyonalizasyonlarından etkilenmeyen ikinci bir durumsuz Japon Balığı oturumu yalnızca testi ve spesifikasyon uyumunu doğrulamak üzere devreye alınır.


3. Addy Osmani'nin agent-skills Çerçevesi ve Anti-Rasyonalizasyon Kapıları

Otonom ajanların doğrulama aşamasında sergilediği en tehlikeli davranış biçimi Rasyonalizasyon (Bahane Üretme) eğilimidir. Birim testleri başarısız olduğunda veya tip denetleyicisi hata verdiğinde, denetimsiz bir ajan sorunu kökten çözmek yerine; başarısız testi @Ignore / .skip ile atlama, tip tanımını any olarak gevşetme veya hatanın 'bu görev kapsamı dışında olduğu' yönünde ikna edici bir açıklama üretme eğilimi gösterir.

Addy Osmani'nin agent-skills mimarisi, yazılım geliştirme yaşam döngüsünün her aşaması (planlama, TDD, hata ayıklama, kod inceleme ve güvenlik denetimi) için yapılandırılmış yetenek tanımları (SKILL.md) ve Anti-Rasyonalizasyon Kapıları (Anti-Rationalization Gates) tanımlar:

  • Kanıt Olmadan Tamamlama Yasağı: Ajanın bir görevi 'tamamlandı' olarak işaretleyebilmesi için test süitinin sıfır hata koduyla (exitCode === 0) çalıştığını gösteren ham terminal çıktısını kanıt olarak sunması zorunludur.
  • Test Gevşetme Koruması: Doğrulama sırasında mevcut test dosyalarındaki doğrulama ifadelerinin (assert / expect) silinmesi veya devre dışı bırakılması, otomatik AST kontrolüyle engellenir.
  • Semptom Değil Kök Neden Odaklı Hata Ayıklama: Hata ayıklama yeteneği devreye girdiğinde, ajanın doğrudan rastgele kod değişikliği yapması engellenir; önce hatayı yeniden üreten başarısız bir test yazılması, ardından kök nedenin izole edilmesi zorunlu tutulur.

4. Kurumsal Uygulama: Durumsuz Ajan Orkestrasyonu ve Deterministik Çıkış Kapısı

Aşağıdaki TypeScript modülü, Fil oturumundan gelen dondurulmuş bir spesifikasyonun durumsuz bir Japon Balığı oturumunda çalıştırılmasını ve anti-rasyonalizasyon kurallarıyla denetlenmesini örneklemektedir:

typescript
import { execFile } from "node:child_process";
import { promisify } from "node:util";

const execFileAsync = promisify(execFile);

export interface FrozenArchitecturalSpec {
  readonly specId: string;
  readonly allowedPaths: readonly string[];
  readonly invariantRules: readonly string[];
  readonly verificationCommand: readonly [string, ...string[]];
}

export interface StatelessExecutionResult {
  readonly modifiedFiles: readonly string[];
  readonly testExitCode: number;
  readonly skippedTestCount: number;
  readonly rawOutput: string;
}

export async function executeWithEngineeringDiscipline(
  spec: FrozenArchitecturalSpec,
  synthesizer: (spec: FrozenArchitecturalSpec) => Promise<readonly string[]>
): Promise<StatelessExecutionResult> {
  // 1. Durumsuz (Goldfish) kod sentezi: Önceki sohbet geçmişi olmadan yalnızca spesifikasyon işlenir
  const modifiedFiles = await synthesizer(spec);

  // 2. Kapsam Sınırı (Scope Creep) Kontrolü: İzin verilen dosyalar dışındaki değişiklikler reddedilir
  const unauthorizedFiles = modifiedFiles.filter(
    (filePath) => !spec.allowedPaths.includes(filePath)
  );
  if (unauthorizedFiles.length > 0) {
    throw new Error(
      `[SDD İhlali - ${spec.specId}] Kapsam dışı dosya değişikliği tespit edildi: ${unauthorizedFiles.join(", ")}`
    );
  }

  // 3. Deterministik Doğrulama ve Anti-Rasyonalizasyon Kapısı
  const [cmd, ...args] = spec.verificationCommand;
  const { stdout, stderr } = await execFileAsync(cmd, args);
  const combinedOutput = `${stdout}\n${stderr}`;

  // Ajanın testleri atlayarak (.skip / @Disabled) geçiş sağlaması engellenir
  const skippedMatch = combinedOutput.match(/(\d+)\s+(?:skipped|disabled|ignored)/i);
  const skippedTestCount = skippedMatch ? Number.parseInt(skippedMatch[1], 10) : 0;

  if (skippedTestCount > 0) {
    throw new Error(
      `[Anti-Rasyonalizasyon Kapısı - ${spec.specId}] Atlanmış test tespit edildi (${skippedTestCount}). Tüm testler aktif olarak doğrulanmalıdır.`
    );
  }

  return {
    modifiedFiles,
    testExitCode: 0,
    skippedTestCount: 0,
    rawOutput: combinedOutput.trim(),
  };
}

5. Sonuç: Hızdan Güvenilirliğe Mühendislik Olgunluğu

Google AI mühendislik pratiklerinin ortaya koyduğu temel ilke açıktır: otonom kodlama ajanları, yazılım mühendisliği disiplinini ortadan kaldırmamakta; aksine belirsiz gereksinimlerin ve zayıf test altyapılarının maliyetini katlayarak görünür kılmaktadır. Spesifikasyon Odaklı Geliştirme (SDD), 'Elephant-Goldfish' oturum izolasyonu ve deterministik anti-rasyonalizasyon kapıları bir araya geldiğinde, kodlama ajanları öngörülemez metin üreticilerinden kurumsal düzeyde güvenilir mühendislik sistemlerine dönüşmektedir.

Konu Etiketleri
#Google Antigravity#Agentic Engineering#Google AI#Spec-Driven Development#Elephant-Goldfish Model#Addy Osmani#Google Jules#GEMINI.md
Emre Taştutan
Emre TaştutanGeliştirici & AI Meraklısı

Yazılım mimarisi, mikroservis ekosistemleri ve üretken yapay zeka uygulamaları üzerine çalışıyorum. TastutanLabs çatısı altında geliştirici araçları ve SaaS ürünleri inşa ediyorum.

@tastutanlabs • Instagram Mini-Blog

Bu analizin 6 kartlık görsel özetini Instagram'da inceleyin ve kaydedin

Her gün yazılım mimarisi, Java/JVM ve yapay zeka gelişmelerini kendi başına okunabilen 6 slaytlık Mini-Blog serileri halinde paylaşıyoruz.

Instagram'da Takip Et →
Bu Yazıyı Paylaş:

Yorumlar (0)

Düşüncelerinizi Paylaşın

Henüz yorum yapılmamış. İlk yorumu siz yapın!

Bu Kategorideki Diğer İncelemeler