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.

'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.
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:
- 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.
- 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ı.
- 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.
- 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:
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.
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.
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.
Yorumlar (0)
Düşüncelerinizi Paylaşın
Henüz yorum yapılmamış. İlk yorumu siz yapın!
Bu Kategorideki Diğer İncelemeler
Vercel Board Ajan Mesaj Panosu ve CodeRabbit Verify Ajan Tabanlı QA Betası Kullanıma Açıldı
Vercel, insanlarla kodlama ajanlarını tek bir mesaj panosunda buluşturan Vercel Board altyapısını tüm planlara açarken; CodeRabbit ise PR incelemelerini canlı tarayıcı testlerine taşıyan CodeRabbit Verify katmanını ücretsiz açık betaya çıkardı.
Anthropic ‘Claude Code v2.1.328’ Yayınlandı: Çoklu Bulut Auto Mode, Code Mode ve Self-Hosted Runner Genişletmesi
Anthropic, Claude Code v2.1.328 güncellemesiyle Amazon Bedrock, Google Cloud ve Microsoft Foundry üzerinde Auto Mode desteğini devreye aldı; Code Mode ile self-hosted runner yeteneklerini genişletip terminal ve uzaktan kontrol kararlılığını artırdı.
OpenAI, ChatGPT Yavaşlamalarını Otonom Olarak Teşhis Eden Codex Destekli ‘Performance Factory’ Sistemini Tanıttı
OpenAI, ChatGPT'deki performans gerilemelerini bulut tabanlı Codex ajanları ve rakip inceleme oturumlarıyla otonom olarak tespit edip çözüm öneren Performance Factory mimarisini duyurdu. Sistem, üç ayda 1.700'den fazla inceleme yürüterek 600'ün üzerinde kök nedeni %70 doğruluk oranıyla teşhis etti.