# Yapay Zeka Ajanları İçin Spesifikasyon Odaklı Geliştirme Canonical: https://specscore.md/tr/spec-driven-development/ SpecScore, spesifikasyonlar için Markdown ve YAML (YAML Ain't Markup Language) ile yazılmış açık ve linter ile denetlenebilir bir dosya formatıdır; bir komut satırı arayüzü (CLI) bu dosyaları denetler. **Spesifikasyon odaklı geliştirme (SDD), yazılı ve test edilebilir bir spesifikasyonun — gereksinimler ve kabul kriterleri — kodun inşa edildiği ve doğrulandığı tek doğruluk kaynağı (source of truth) olduğu bir uygulamadır.** Doğrudan bir prompttan veya biletten koda geçmek yerine, önce yazılımın ne yapması gerektiği konusunda anlaşırsınız ve ardından bu spesifikasyona göre inşa edersiniz. Artık kodun büyük bir kısmını yapay zeka ajanları yazdığı için spesifikasyon, onların doğru olanı inşa etmesini sağlayan şeydir. - Spesifikasyon doğruluk kaynağıdır; kod ondan türetilir ve ona karşı kontrol edilir. - Gereksinimlere açık kabul kriterleri eşlik eder, böylece «tamamlandı» ifadesi öznel değil test edilebilirdir. - Yapay zeka ajanları amacı koddan tahmin etmek yerine spesifikasyondan sorgular — daha az hatalı inşa. - Test odaklı geliştirmenin (TDD) alternatifi değil, tamamlayıcısıdır. Son güncelleme: 30 Ekim 2026 ## Spesifikasyon odaklı geliştirme nedir? Spesifikasyon odaklı geliştirme olağan çalışma sırasını tersine çevirir. Spesifikasyonu sonradan yazılan bir dokümantasyon olarak ele almak — veya tamamen atlamak — yerine SDD, spesifikasyonu birincil yapı taşı (artifact) yapar. Kod, testler ve incelemeler tamamen ona atıfta bulunur. Bu anlamda bir spesifikasyon düz bir metin yığını değildir. Yapılandırılmıştır: her biri gereksinimin karşılanmış sayılması için neyin doğru olması gerektiğini test edilebilir terimlerle belirten açık **kabul kriterlerine** sahip **gereksinimler**kümesidir. Bir inceleyicinin, bir test paketinin ve bir yapay zeka ajanının aynı belgeyi aynı şekilde yorumlamasını sağlayan şey bu yapıdır. Spesifikasyon aynı zamanda **yaşayan bir yapı taşıdır**. Gereksinimler değiştiğinde önce spesifikasyon değişir ve kod onu takip eder — böylece spesifikasyon asla kurgusal bir metne dönüşmez. ## Neden şimdi önemli: Yapay zeka riskleri artırdı Yapay zeka kodlama ajanları, bir insanın okuyabileceğinden çok daha hızlı kod üretir. Bu durum darboğazı kaydırır. Zor olan kısım artık uygulamayı yazmak değildir —**üretilen kodun istediğiniz kod olmasını sağlayacak kadar amacı net bir şekilde belirtmektir**. Belirsiz bir prompt verilen bir ajan, makine hızında akla yatkın ama tamamen yanlış bir şey üretecektir. Spesifikasyon güvenlik bariyeridir. Amaçlanan davranış ve kabul kriterleri yazıldığında ajanın inşa edebileceği net bir hedefi ve doğrulayabileceği bir kontrol listesi olur — ve insan bir incelemecinin ortada henüz kod yokken onaylayabileceği somut bir şeyi olur. SDD, ekiplerin yapay zeka hızının yapay zeka yeniden çalışmasına (rework) dönüşmesini önleme yoludur. ## Spesifikasyon odaklı geliştirme nasıl çalışır İş akışı tek seferlik bir belge değil, bir döngüdür: - **Amacı yakalayın.** Bir çözüme bağlanmadan önce henüz olgunlaşmamış yönü — sorunu, hedefi, açık soruları — kaydedin. - **Davranışı belirtin.** Üzerinde anlaşılan yönü, her biri açık ve test edilebilir kabul kriterlerine sahip gereksinimlere dönüştürün. - **Bir plana bölün.** Spesifikasyonu sıralı görevlere bölün; her görev karşıladığı kabul kriterlerine atıfta bulunsun. - **Uygulayın.** Görev görev — bir insan veya bir yapay zeka ajanı tarafından — spesifikasyona göre inşa edin. - **Kriterlere karşı doğrulayın.** Sonucu bir önseziye göre değil, kabul kriterlerine göre kontrol edin. - **Spesifikasyonu canlı tutun.** Gereksinimler değiştiğinde önce spesifikasyonu güncelleyin; kod onu takip etsin. ## Spesifikasyon odaklı geliştirmenin faydaları - Anlaşmazlıklar uygulamanın sonrasında (pahalı) değil, spesifikasyon incelemesi sırasında (ucuz) yüzeye çıkar. - «Tamamlandı» nesneldir, çünkü kabul kriterleri test edilebilirdir. - Spesifikasyon herkes için ortak bağlamdır: ürün, mühendislik ve yapay zeka ajanları. - Değişiklikler izlenebilirdir — her görev karşıladığı kriterlere atıfta bulunur. ### Yapay zeka ajanlarına özellikle nasıl yardımcı olur? - **Makine tarafından okunabilir amaç:** ajan gereksinimleri koddan çıkarmak yerine doğrudan okur. - **Yüklenecek daha az bağlam:** ajan tüm repo yerine spesifikasyonun yalnızca ilgili kısmını sorgular. - **Doğrulanabilir çıktı:** kabul kriterleri ajana geçti/kaldı şeklinde somut bir hedef verir. - **İzlenebilirlik:** üretilen kod, kendisini motive eden gereksinime geri bağlanabilir. ## İlgili uygulamalarla karşılaştırma Uygulama Doğruluk Kaynağı SDD ile İlişkisi Test odaklı geliştirme (TDD) Kod düzeyinde başarısız olan testler Tamamlayıcı — kabul kriterleri testlere dönüşür. Geleneksel PRD İnsanlar için yazılmış düz metin Daha az yapılandırılmış; doğrudan test edilebilir veya makine tarafından okunabilir değildir. Salt prompt ("vibe coding") Prompt ve modelin tahmini Kalıcı ve incelenebilir bir hedefi yoktur — SDD'nin çözmek için var olduğu şey. SpecScore'un diğer spesifikasyon araçlarıyla ayrıntılı bir karşılaştırması için[karşılaştırma sayfalarına](/tr/vs/) bakın. Ayrıca şu karşılaştırmalar: [Kiro](/tr/vs/kiro/), [Tessl](/tr/vs/tessl/), [BMAD Method](/tr/vs/bmad-method/), [Task Master AI](/tr/vs/task-master-ai/). Araçların tamamı — GitHub Spec Kit, OpenSpec, Kiro ve diğerleri —[2026’nın en iyi spesifikasyon güdümlü geliştirme araçları](/tr/spec-driven-development/tools/) sayfasında. Bir yapay zekâ ajanının doğrulayabileceği kabul kriterlerini nasıl yazacağınız[kabul kriterleri nasıl yazılır](/tr/articles/acceptance-criteria/)sayfasında. Kiro gereksinimlerinin kullandığı EARS cümle kalıpları [EARS gereksinim sözdizimi](/tr/articles/ears-requirements/) sayfasındadır. Bu spesifikasyon linterini sürekli entegrasyonda çalıştırmak [spesifikasyonları CI’da lintlemek](/tr/articles/lint-specs-in-ci/) sayfasındadır. Gereksinimler, kabul kriterleri, bir plan ve görevler içeren bir Markdown özellik spesifikasyonu şablonu — bir ürün gereksinimleri belgesi (PRD) — [Markdown PRD şablonu](/tr/articles/feature-spec-template/) sayfasındadır. Claude Code ve Cursor ile spesifikasyon odaklı geliştirme — özellik dosyasına ne yazılır, `specscore agent setup` ne yazar ve `specscore spec lint` döngüde ve CI’da nasıl çalışır — [Claude Code ve Cursor ile spesifikasyon odaklı geliştirme](/tr/articles/claude-code-specs/). ## Ödünleşimler ve ne zaman kullanılmamalı Spesifikasyon odaklı geliştirme bedava değildir. Herhangi bir kod çalıştırılmadan önce düşünme ve yazma çabasını öne çeker; bu da tek seferlik bir script veya atılabilir bir deney için yanlış bir tercihtir. Ve bir spesifikasyon yalnızca güncel tutulursa yardımcı olur — terk edilmiş bir spesifikasyon yanıltıcı hale gelir, hiç olmamasından daha kötüdür. SDD, iş planlanacak kadar büyük olduğunda, sürdürüleceğinde veya büyük ölçekte inşa etmesi için bir yapay zeka ajanına teslim edileceğinde karşılığını verir. ## Pratikte yapay zeka ajanlarıyla SDD uygulamak Yapay zeka ajanlarıyla SDD yapmak için iki şeye ihtiyacınız vardır: hem ekibinizin hem de ajanlarınızın anlayacağı **makine tarafından okunabilir bir spesifikasyon formatı**ve **ajanların bu spesifikasyonları okuması, yazması ve doğrulaması için bir yol**. **SpecScore** tam olarak bunun bir uygulamasıdır. Özellikler, gereksinimler ve kabul kriterleri için açık bir Markdown + YAML formatıdır — reponuzdaki düz dosyalar — ve ajanlarınızın bunları sorgulamak, düzenlemek ve lint etmek için çağırdığı bir CLI ile eşleştirilmiştir. Yapı makine tarafından okunabilir olduğu için bir ajan «sırada ne inşa etmeliyim?» diye sorabilir, açık gereksinimleri ve kabul kriterlerini alabilir ve ardından çalışmasını bunlarla karşılaştırabilir. Araçlardan bağımsızdır ve [açık kaynaklıdır](https://github.com/specscore/specscore). [Kodlama ajanınız için Yapay Zeka Becerileri](/tr/ai/) ile başlayın veya[CLI'yı yükleyin](/tr/cli/). ## Sıkça sorulan sorular Spesifikasyon odaklı geliştirme, test odaklı geliştirme (TDD) ile aynı şey midir? Hayır. TDD uygulamayı kod düzeyinde başarısız olan testlerden yönlendirir. Spesifikasyon odaklı geliştirme bir seviye yukarıda çalışır: önce amaçlanan davranışı ve kabul kriterlerini yazılı bir spesifikasyonda sabitler. Birbirini tamamlarlar — bir spesifikasyonun kabul kriterleri genellikle TDD'yi yönlendiren testlere dönüşür. Spesifikasyon odaklı geliştirme sizi yavaşlatır mı? Kod yazmadan önceki süreyi artırır ve yanlış olan şeyi yeniden inşa etmeye harcanan süreyi ortadan kaldırır. Tek seferlik scriptler için maliyet değmez. Ancak bir yapay zeka ajanının büyük ölçekte ürettiği veya bir ekibin sürdürmesi gereken herhangi bir şey için önce spesifikasyonu yazmak baştan sona genellikle daha hızlıdır. Bir spesifikasyon ile PRD arasındaki fark nedir? Bir PRD genellikle insanlara yönelik düz metindir. Spesifikasyon odaklı geliştirmedeki bir spesifikasyon yapılandırılmış ve test edilebilirdir — açık kabul kriterlerine sahip ayrık gereksinimler — böylece hem inceleyiciler hem de yapay zeka ajanları üzerinde kesinlikle hareket edebilir. Yapay zeka kodlama ajanları bir spesifikasyonu nasıl kullanır? Spesifikasyon makine tarafından okunabilir olduğunda ajan, tüm kod tabanını yüklemek yerine mevcut göreviyle ilgili gereksinimleri ve kabul kriterlerini almak için spesifikasyonu sorgular ve ardından çıktısını bu kriterlerle karşılaştırır — bu, makul görünen ancak hatalı koda karşı bir önlemdir. SpecScore nedir? SpecScore, Markdown ve YAML ile yazılmış, açık ve linter ile denetlenebilir bir spesifikasyon dosya formatıdır; bir komut satırı arayüzü (CLI) bu dosyaları sorgular, düzenler ve lint eder. Format herkese açık [specscore/specscore](https://github.com/specscore/specscore) deposundadır. SpecScore hangi lisansla yayımlanır? Herkese açık [specscore/specscore](https://github.com/specscore/specscore) deposundaki belirtim ve belgeler [CC BY 4.0](https://github.com/specscore/specscore/blob/main/LICENSE) lisanslıdır. [specscore/specscore-cli](https://github.com/specscore/specscore-cli) deposundaki referans komut satırı arayüzü (CLI) [Apache-2.0](https://github.com/specscore/specscore-cli/blob/main/LICENSE) lisanslıdır. Spesifikasyon güdümlü geliştirme tek bir yapay zekâ satıcısı ister mi? Hayır. Spesifikasyonlar depodaki düz metin dosyalarıdır. CLI yerel bir programdır. Bu sitedeki AI Skills, skill çalıştırabilen ajanlar için o CLI'yi sarar. Format tek bir satıcı gerektirmez. CLI'yi nasıl kurarım? Kurulum: [/tr/cli/install/](/tr/cli/install/). [AI Skills](/tr/ai/) ile de başlayabilirsiniz. CLI programı [specscore/specscore-cli](https://github.com/specscore/specscore-cli) deposundan yayımlanır.