Yöntem

SDD Nasıl Çalışır

Şelaleden spesifikasyon odaklı AI yürütmeye — tam teknik analiz.

Evrim

Yazılım Geliştirme Nasıl Evrildi

Yazılım inşa etmenin dört dönemi — katı şelalelerden spesifikasyon odaklı AI ajanlara.

01 1970s–1990s

Waterfall

Sıralı aşamalar: gereksinimler, tasarım, uygulama, test, dağıtım. Her aşama bir sonraki başlamadan önce tamamlanır. Değişiklikler pahalıdır; geri bildirim döngüleri aylarla ölçülür.

Öngörülebilir ama yavaş. Tasarım aşamasından sonra bir değişiklik talebi tüm zaman çizelgesini sıfırlayabilirdi.
02 2001–2020s

Agile

İteratif sprintler, kullanıcı hikayeleri, günlük toplantılar, retrospektifler. Ekipler artımlı olarak teslim eder ve değişime uyum sağlar. Ancak hız hala ekip boyutu ve koordinasyon yükü ile sınırlıdır.

Daha hızlı geri bildirim, ancak ölçeklendirme daha fazla kişi gerektirir — ve daha fazla kişi daha fazla koordinasyon gerektirir.
03 2023–2024

AI-Assisted

Kod tamamlama, AI copilotlar, sohbet tabanlı kod üretimi. Bireysel geliştiriciler daha hızlı olur, ancak geliştirme süreci kendisi değişmez. AI yardım eder; insanlar hala işi yapar.

Geliştirici başına %20–40 verimlilik artışı — ama süreç, roller ve darboğazlar aynı kalır.
04 2025+

SDD

Spesifikasyon yürütülebilir sözleşme haline gelir. AI ajanları uygular, test eder, belgeler ve dağıtır — tüm yaşam döngüsünü resmi spec'ler aracılığıyla kontrol eden kıdemli bir mühendis tarafından orkestre edilir.

Daha hızlı geliştiriciler değil — temelden farklı bir süreç. Bir mühendis, önce spesifikasyon, AI ile yürütme.

Temel Kavram

Specification-Driven Development Nedir?

Spesifikasyonun doğru kaynak ve AI ajanlarının iş gücü olduğu bir metodoloji.

Specification-Driven Development (SDD), her özellik, hizmet ve entegrasyonun herhangi bir kod yazılmadan önce resmi, makine tarafından okunabilir bir spesifikasyon olarak başladığı bir metodolojidir.

Geliştiricilerin gereksinimleri yorumladığı ve uygulama kararlarını anlık aldığı geleneksel yaklaşımların aksine, SDD tüm mimari ve iş kararlarını spec'e öne yükler. Spesifikasyon dokümantasyon değildir — AI ajanlarının karşısında yürüttüğü doğru kaynaktır.

Sonuç: öngörülebilir çıktı, tutarlı kalite ve ekip boyutuyla değil spesifikasyon derinliğiyle ölçeklenen bir geliştirme hızı.

Spesifikasyon Koddur

Her özellik resmi bir spec olarak başlar: API sözleşmeleri, veri modelleri, iş kuralları, kabul kriterleri. Spec, AI ajanlarının belirsizlik olmadan uygulaması için yeterince kesindir.

Ajanlar İşi Yapar

AI ajanları uygulama, test, dokümantasyon, CI/CD yapılandırması ve lokalizasyonu yönetir. Her ajan tanımlanmış bir rol ve katı bağlam sınırları içinde çalışır.

İnsan Kontrolü Elinde Tutar

Kıdemli bir mühendis spec'leri yazar, tüm çıktıyı inceler, mimari kararlar alır ve kaliteyi doğrular. AI uzmanlığı güçlendirir — yargıyı değiştirmez.

Mimari

Üç Bağlam Katmanı

Her AI ajanı tutarlılık ve kaliteyi sağlayan katı bir bağlam hiyerarşisi içinde çalışır.

01

Sistem Bağlamı

Mimari kurallar, teknoloji stack'i kısıtlamaları, kodlama standartları, adlandırma kuralları ve proje genelindeki değişmezler. Bu bağlam her ajan oturumuna yüklenir ve proje süresince asla değişmez.

Örnek: "Java 21, Spring Boot 3.2, PostgreSQL. Tüm servisler altıgen mimari kullanır. REST API'lar OpenAPI 3.1 spec'ini takip eder. ORM yok — jOOQ ile doğrudan SQL."
02

Özellik Bağlamı

Belirli bir özellik için gereksinimler, kabul kriterleri, API sözleşmeleri, veri modelleri ve iş kuralları. Bu bağlam mevcut görevle sınırlıdır ve ajanın ne inşa etmesi gerektiğini tanımlar.

Örnek: "Sertifika düzenleme servisi: POST /api/v1/certificates. Depo kapasitesini doğrular, yinelenen seri numaralarını kontrol eder, CertificateIssued alan olayını yayar."
03

Yürütme Bağlamı

Mevcut dosya, fonksiyon kapsamı, test beklentileri ve anlık bağımlılıklar. Bu en dar bağlam katmanıdır — ajana tam olarak nerede olduğunu ve ne üretmesi gerektiğini söyler.

Örnek: "CertificateService.issue() metodunu uygula. Giriş: IssueCertificateCommand. Çıkış: CertificateDTO. Geçmeli: CertificateServiceTest satırlar 45–78."

Yaşam Döngüsü

SDD Yaşam Döngüsü

Spesifikasyondan üretime yedi adım — her kritik aşamada insan kontrol noktalarıyla.

01

Sistem Spesifikasyonunu Yaz

Mimariyi, teknoloji stack'ini, kodlama standartlarını, API kurallarını ve proje genelindeki kuralları tanımla. Bu tüm ajanlar için değişmez sistem bağlamı olur.

02

Özellik Gereksinimlerini Tanımla

Her özellik için: API sözleşmeleri, veri modelleri, iş kuralları, kabul kriterleri ve test beklentileri. Spec belirsiz olmayan uygulama için yeterince kesin olmalıdır.

03

İnsan İncelemesi: Spesifikasyon

Mühendis spec'i tamlık, tutarlılık ve mimari sağlamlık açısından inceler. Bu en kritik kontrol noktasıdır — buradaki hatalar her yere yayılır.

04

AI Ajanları Uygular

Ajanlar spec'i yürütür: kod yazar, test oluşturur, dokümantasyon üretir, CI/CD yapılandırır. Her ajan kendi rolü ve bağlam sınırları içinde çalışır.

05

Otomatik Doğrulama

Tüm üretilen kod otomatik olarak derlenir, test edilir ve analiz edilir. Test kapsamı, tip güvenliği ve kodlama standartları CI pipeline'ları tarafından uygulanır — insanlar tarafından değil.

06

İnsan İncelemesi: Çıktı

Mühendis üretilen kodu doğruluk, uç durumlar, güvenlik ve üretim hazırlığı açısından inceler. AI çıktısı insan doğrulaması olmadan asla dağıtılmaz.

07

Ürüne Dağıt

Onaylanan kod birleştirilir, pipeline'lar çalışır ve sistem dağıtılır. Spec'ten commit'e, dağıtıma kadar tam izlenebilirlik.

Başlamaya Hazır mısınız?

Gerçek Bir Şey İnşa Edelim

Önce NDA. Sonra net bir spesifikasyon, sabit fiyat ve çalışan bir sistem — aylar değil, haftalar içinde teslim.