Ana içeriğe atla

Claude Code ile Şarta Dayalı (Spec-Driven) Geliştirme: Kılavuzlu Bir Eğitim

Bir şartname yazmayı, onu plana dönüştürmeyi ve Claude Code ile şarta dayalı (spec-driven) geliştirme yapmayı öğrenin. İş akışınıza uygun aracı bulmak için Superpowers, Spec Kit ve BMAD-METHOD’u karşılaştırın.
Güncel 3 Eki 2026  · 15 dk. oku

Yapay Zeka ile Keşfedin

ChatGPTClaudePerplexity

Claude Code ile "vibe-coding" yaklaşımı küçük işlerde gayet iyi çalışır. Bir değişikliği tarif edersiniz, ajan yazar ve sonucu kontrol edersiniz. Sorun, bir özelliğin aynı anda birden çok dosyaya dokunduğunda başlar. O noktada zor olan kısım uygulama değil, tasarım kararının kendisidir.

Spec-driven (şarta dayalı) geliştirme, herhangi bir kod çalışmadan önce bu tasarım kararını yazılı olarak ele alır. Değişikliğin ne yapması gerektiğini söyleyen kısa bir şartname (spec) yazarsınız. Şartnameyi numaralı görevlerden oluşan bir plana dönüştürürsünüz. Ardından Claude Code, her adım arasında insan incelemesi olacak şekilde, plana göre kodu görev görev yazar.

Bu eğitim, iş akışını uçtan uca öğretir. Claude Code içinde çalışan üç açık kaynak kurulumu adım adım gösterir: Superpowers, GitHub Spec Kit ve BMAD-METHOD.

Claude Code’a yeniyseniz, Claude Code 101 kursuyla başlamanızı öneririm. Farklı yapay zekâ kodlama araçlarıyla pratik yapmak için AI for Software Engineering yetenek yolumuza göz atın.

Spec-Driven Development Nedir?

Spec-driven geliştirme, sırayla üç belgeden oluşan bir iş akışıdır: Değişikliğin ne yapması gerektiğini söyleyen bir belge, adımları belirleyen bir plan ve plan doğrultusunda yazılmış kod; her ikili arasında bir insan incelemesiyle.

Title: Three stacked shelves on a white canvas, each labeled Gate 1 Spec, Gate 2 Plan, Gate 3 Code review, with a thin line threading downward through all three to show a feature passing through each gate in sequence. - Description: Three stacked shelves on a white canvas, each labeled Gate 1 Spec, Gate 2 Plan, Gate 3 Code review, with a thin line threading downward through all three to show a feature passing through each gate in sequence.

Spec-driven geliştirmede bir özelliğin geçtiği üç inceleme noktası.

Şartname (spec), herhangi bir koddan önce düz dilde yazılan, değişikliğin ne yapması gerektiğini söyleyen kısa bir belgedir. “Kullanıcıların verilerini dışa aktarmasına izin ver” gibi bir özelliği düşünün. Bunun için hazırlanacak bir şartname, ajanın aksi halde tahmin edeceği cevapları netleştirir. Şunları listeler: 

  • Desteklenen dosya formatları
  • Dağıtım/teslim yöntemi
  • Yarıda kalmış bir dışa aktarma sırasında davranış
  • Kasıtlı olarak kapsam dışı bırakılan kısımlar

Aşağıda, Telegram tabanlı bir sorumluluk uygulamamda workout-shape-verification değişikliği için Claude Code’un yazdığı gerçek bir şartnamenin açılışı var. Bu değişiklik, kırılgan bir nabız eşiğini, zaman içindeki nabız eğrisinin şekline yönelik bir kontrolle değiştiriyor:

# Workout Shape-Based Verification — Design Spec
 
**Created:** 2026-05-05
**Status:** Draft
**Supersedes (partially):** [2026-03-17-calisthenics-verification-design.md]
  — replaces the absolute-HR thresholds for the Workout activity type.
  Run / Ride / Walk verification is unchanged.
 
## Problem
 
The current Workout verifier accepts an activity only if absolute heart-rate
levels clear fixed cutoffs: avg ≥ 120, max ≥ 140, range ≥ 30, suffer_score ≥ 3.
Two failures in production:
 
1. **False-negative risk.** As cardiovascular fitness improved
   (resting HR ~80), real calisthenics sessions with disciplined rest now
   average 115–125 bpm. Recent sessions have come within 4 bpm of the 120 floor.
 
<!-- ... continues for hundreds of lines through Solution, Risks,
 	Out of scope, and What is removed / added / changed / unchanged -->

Plan bir sonraki belgedir. Yukarıdaki şartnameyi, ajanın tek tek üzerinde çalışabileceği şekilde, her görevde dosyayı, değişikliği, sıralamayı ve testi adlandıran numaralı görevlere böler. Şartname “ne”yi yanıtlarken, plan “hangi adımlarda”yı yanıtlar. 

Kod en sonda gelir; plana göre, görev görev yazılır.

Üç belge. Her ikili arasında bir insan incelemesi vardır. Şartname, plana dönüşmeden önce incelenir. Plan, koda dönüşmeden önce incelenir. Kod, birleştirilmeden önce incelenir.

Spec-driven geliştirme, plan modundan nasıl farklıdır?

Claude Code’un yerleşik plan modunu (girmek için Shift+Tab’e iki kez basın) kullanmış ve bunun neden farklı olduğunu merak etmiş olabilirsiniz. Plan modu, tek bir sohbet turu içinde bir plan üretir. Plan bellekte yaşar; kalıcı bir şartname yoktur ve aşamalar arasında bir inceleme adımı bulunmaz.

Spec-driven geliştirme ise şartnameyi ve planı disk üzerinde dosya olarak kalıcı hale getirir. Her biri bir sonraki aşama başlamadan önce insan incelemesinden geçer ve bu çıktılar oturumlar boyunca yaşar. Plan modu, yazılım geliştirmesinin iki aşamasını tek bir sohbet turuna sıkıştırır. Bu, küçük işlerde çalışır; kod tabanı büyüyüp gerçek kullanıcılara hizmet vermeye başladığında ise başarısız olur.

Neden Vibe-Coding Duvara Toslar

Vibe-coding prototiplerde, tek dosyalarda ve atılacak betiklerde işe yarar. Gerçek kullanıcılara yanıt vermeniz gereken uygulamalarda ve mevcut büyük kod tabanlarında kötüleşir. Çizilmesi gereken sınır yaklaşık 4 dosyadır. Bu kadar dosyaya dokunan her değişikliğin bir şartnameye ihtiyacı vardır; ayrıca tutarlı bir nihai duruma sahip her yeniden düzenleme (refactor) ve “bu tam olarak ne yapmalı?” sorusunun zor olduğu her görev için de geçerlidir.

Başarısızlığın nedeni nettir. “Uygulamama fotoğraf paylaşımı ekle” gibi muğlak bir istem, modelin binlerce ifade edilmemiş gereksinimi tahmin etmesine yol açar.

Bu gereksinimlerden yalnızca birini ele alalım: bildirim tercihleri. Ürün yöneticisi kanal başına anahtarlar varsayar. Arka uç bir aç/kapa anahtarı kurar. Ön uç, işletim sistemi seviyesinde entegrasyon varsayar. Üç kelimenin dört makul okuması, dört farklı ürün.

Spec-driven geliştirmedeki her inceleme adımı, pahalı hale gelmeden farklı bir hata sınıfını yakalar. Şartname incelemesi, kapsam şişmesini ve yanlış kök-neden kurgularını yakalar. Plan incelemesi, yarıda kalmış uygulamaları ve çakışan kalıpları yakalar. Kod incelemesi ise kağıt üzerinde iyi görünen ama ilk başarısız testte dağılan planları yakalar.

Hata modu

Ne ters gider

Nerede yakalanır

Görev ortasında kapsam şişmesi

Ajan, özelliği ilk talepten öteye genişletir

Şartname incelemesi

Yarım kalmış uygulamalar

Ajan, iskeletler ve TODO’larla %80’de “bitti” der

Plan incelemesi

Çatışan kalıplar

Ajan, kod tabanının geri kalanından farklı bir kalıp seçer

Plan incelemesi

Yanlış kök-neden düzeltmeleri

Ajan, temel hatayı değil semptomu yamalar

Şartname incelemesi

Temasla bozulan planlar

Plan iyi okunur ama ilk başarısız testte ayakta kalamaz

Kod incelemesi

Getirisi gerçektir ve yavaş yavaş birikir. Şartname aşaması, herhangi bir kod çalışmadan önce saatlerce yazım maliyeti getirir ve ilk birkaç özellik vibe-coding’den daha yavaş hissettirir. Benim başa baş noktam dördüncü ya da beşinci özellik civarında geldi. O zamana kadar şartnameler, aksi halde yayına alıp bir hafta sonra yeniden yazacağım tasarım hatalarını yakalıyordu.

Sıradaki üç bölüm, bu iş akışını Claude Code içinde çalıştıran üç açık kaynak yaklaşımı anlatıyor. Zorladıkları yapı bakımından en hafiften en ağıra doğru sıralıdır.

Superpowers

Superpowers üçlü arasındaki en hafif olanıdır. Günlükte benim de kullandığım araçtır ve en ayrıntılı anlatacağımız da bu olacak.

Superpowers nedir?

Superpowers, Jesse Vincent’ın (obra/superpowers, MIT lisans) geliştirdiği bir Claude Code eklentisidir; GitHub’da yaklaşık 194 bin yıldızı vardır. 

Bir dizi beceriyle birlikte gelir. Claude becerisi, Claude Code’da, ajanının belirli bir iş akışını takip etmek için talep üzerine yüklediği adlandırılmış bir talimat dosyasıdır. Superpowers, Claude Code’un doğrudan koda atlamak yerine spec-driven döngüde kalmasını sağlayan beceriler sunar.

Title: GitHub repo page for obra/superpowers showing the repo title, description, star count, and the top of the README. - Description: GitHub repo page for obra/superpowers showing the repo title, description, star count, and the top of the README.

GitHub’daki Superpowers proje sayfası.

Superpowers nasıl kurulur

Claude Code’un resmi eklenti pazar yeri üzerinden kurun:

/plugin install superpowers@claude-plugins-official

SessionStart kancası using-superpowers becerisini otomatik yükler; böylece siz yazmaya başlar başlamaz iş akışı devrededir. (Claude code hooks, ajanın belirli bir yaşam döngüsü olayında çalıştırdığı betiklerdir.) Proje başına ayrıca kurulum yapmanız gerekmez.

Superpowers iş akışı

Sonrasında, dört beceri günlük işinizi yönetir:

Beceri

Ne yapar

brainstorming

Sizinle tasarımı tartışır ve şartname belgesini üretir

writing-plans

Onaylanmış şartnameyi numaralı görev listesine dönüştürür

subagent-driven-development

Planı görev görev uygular; test-önce döngüsüyle ve her görevden sonra kod inceleme alt-ajanıyla

requesting-code-review

Birleştirmeden önce tüm fark (diff) üzerinde bağımsız bir kod inceleme alt-ajanı çalıştırır

Bir alt-ajan, ebeveynin kendi bağlam penceresinde odaklı iş yaptırmak için görevlendirdiği ayrı bir Claude Code örneğidir. Yukarıdaki tabloda yer alan inceleme alt-ajanları, alt-ajan olarak çalışır; böylece kodu ebeveynin çerçevesi olmadan, “soğuk” okurlar.

Superpowers nasıl kullanılır

Bu dört beceriyi, ne istediğinizi düz dilde anlatarak çağırırsınız. Beyin fırtınası (brainstorming) becerisi “yeni özelliği tartışalım” ifadesini duyunca, şartname konuşmasını kendiliğinden başlatır. Diğerleri de benzer şekilde tetiklenir.

Title: Four horizontal stages on a white canvas, labeled brainstorming, writing-plans, subagent-driven-development, and requesting-code-review, with a red human-gates badge between the first two stages. - Description: Four horizontal stages on a white canvas, labeled brainstorming, writing-plans, subagent-driven-development, and requesting-code-review, with a red human-gates badge between the first two stages.

Dört Superpowers becerisi sırasıyla; iki insan inceleme noktası brainstorming ile writing-plans arasında yer alır.

Aşağıdaki yürüyüş, yukarıdaki şartname alıntısında geçen aynı workout-shape-verification özelliğini kullanır.

Aşama 1: beyin fırtınasından şartnameye

Claude Code’u açıp şunu yazıyorum:

Let's discuss a new feature. The Workout verifier in make-me-work uses absolute heart-rate cutoffs and is now misfiring as my resting HR drops. I want to replace the absolute cutoffs with a check on the shape of the HR curve over the session.

brainstorming becerisi devralır ve aralarında şunların da bulunduğu on kadar soru sorar:

  • Doğru “şekil” ne olarak sayılır
  • Hangi veri akışlarının birleştirileceği
  • Şekil bakımından doğru görünüp eski bir eşiği geçemeyen oturumlarla ne yapılacağı
  • Değişikliğin Run ve Ride için de geçerli olup olmayacağı

Burada iki insan inceleme noktası bulunur. İlki, verdiğim yanıtların istediğimle örtüştüğünü doğruladığım tasarım incelemesidir. İkincisi şartname incelemesidir. Claude’un yazdığı dosyayı okur ve herhangi bir plan çalışması başlamadan önce onaylarım.

Aşama 2: şartnameden plana

writing-plans becerisini çalıştırırım. Onaylanmış şartnameyi okur ve dört bölümden oluşan bir plan dosyası yazar:

  • “Bitti”nin tanımı
  • Dokunulan dosyaların dosya haritası
  • Demo yolculuğundan geçen bir kullanıcı yolculuğu
  • Numaralı görev listesi şeklinde onay kutulu alt adımlar 

Planı gözden geçiririm, sırası bozuk ya da fazla kaba görünen görevlere itiraz ederim ve onaylarım.

Aşama 3: plandan koda

subagent-driven-development çalıştırırım. Bu noktadan sonra döngü bensiz ilerler. Plandaki her görev için beceri:

  1. Başarısız bir test yazar
  2. Onu geçecek kodu yazar
  3. Refaktör eder
  4. Farkı (diff) soğuk okuyan bir kod inceleme alt-ajanı görevlendirir

İnceleyici bir sorun işaretlerse, döngü sonraki göreve geçmeden önce onu düzeltir. Bu aşamanın içinde bir insan inceleme noktası yoktur. Bu aşama için önemli olan, önceki iki incelemedir.

Aşama 4: tam diff incelemesi

Plan bittiğinde requesting-code-review çalıştırırım. Taze bir alt-ajan, tüm farkı şartname ve planla karşılaştırarak okur ve bir inceleme paylaşır. Birleştirmeden önce önerileri alırım.

Plândaki bir görev şartnameyle çeliştiğini ortaya koyduğunda, döngü durur ve sorar. Şartnameyi düzenleyebilirim (ya da Claude’a düzenletebilirim) ve etkilenen görevleri yeniden üretebilirim. Diğer seçenek, görevin içinde tek seferlik bir düzeltmedir. Superpowers, şartname hatalarını sessizce es geçmez.

Diskte gerçek şartnameler ve planlar

İşte editörde açık olan workout-shape-verification özelliğinin şartnamesi:

Title: The author's real spec file for workout-shape-verification open in an editor, showing the file path in the sidebar and the H1 title plus the Problem section visible in the main pane. - Description: The author's real spec file for workout-shape-verification open in an editor, showing the file path in the sidebar and the H1 title plus the Problem section visible in the main pane.

Beyin fırtınası becerisinin yazdığı şartname dosyası, diske bu şekilde düşer.

Başlıkta, beyin fırtınası becerisinin varsayılan olarak yazdığı Created, Status ve Supersedes alanları yer alır. Ardından Problem bölümü gelir. Hiçbiri kod değildir. Dosya, ekran görüntüsünün ötesinde önerilen çözüm ve değişikliğin dokunması gereken/olmaması gereken alanlara dair kısımlar ile devam eder.

Eşleşen plan, User Journey bölümüyle açılır:

Title: The author's real plan file for workout-shape-verification open in an editor, showing the User Journey section with its numbered list of demo-path steps. - Description: The author's real plan file for workout-shape-verification open in an editor, showing the User Journey section with its numbered list of demo-path steps.

Onaylı şartnameden writing-plans becerisinin ürettiği plan dosyası.

Yolculuk, demo yolunu beşer adımda yürütür; her adımda tam komutları, dosyaları ve argümanları adlandırır. Ardından gelen numaralı görevler, her adımı subagent-driven-development becerisinin çalışabileceği onay kutulu alt adımlara çevirir.

İki belge şöyle eşleşir:

Title: Two side-by-side page rectangles on a white canvas, the left labeled spec.md with six sections, the right labeled plan.md with four sections, connected by an arrow labeled spec gates the plan. - Description: Two side-by-side page rectangles on a white canvas, the left labeled spec.md with six sections, the right labeled plan.md with four sections, connected by an arrow labeled spec gates the plan.

Şartname ve plan yan yana. Şartname neyin ve neden değiştiğini yanıtlar. Plan ise hangi adımlarla yanıtlar.

Daha büyük şartname ve planlarda, resmi döngüde olmayan bir adım ekliyorum: kırmızı takım (red-team) geçişi. Onaylamadan önce, bir veya birkaç Opus alt-ajanına şartnameyi soğuk okutup farklı açılardan açıklar aratıyorum. Bu bir Superpowers özelliği değil, kişisel bir alışkanlık. Yeterince kötü varsayımı yakaladığı için sürdürüyorum.

Superpowers’ın yanlış tercih olduğu durumlar

Superpowers, tek bir depoda solo çalışmaya uyar. Tüm kod tabanı tek bir Claude Code oturumuna sığıyorsa ve iki sayfalık bir şartnameyi gerçekten okuyacaksanız en iyi sonucu verir. Ayrıntılı karşılaştırma aşağıda Aralarından nasıl seçim yapmalı bölümünde. Kısa versiyon: Superpowers, çok depolu özelliklerde ve net rol ayrımı gerektiren işlerde zorlanır.

Bir geliştirici, eklenti hakkında yaptığı kamuya açık bir şikâyette dördüncü bir hata modunu yakaladı: “En küçük görev bile sonsuza kadar sürüyor; Claude alt-ajanlar başlatıp tamamen lüzumsuz planlar yazıyor. Biraz CSS değiştirmek bile artık sonsuza kadar sürüyor.”

Çözüm, minicik değişikliklerde Superpowers’ı atlamaktır. Beceriler yalnızca beyin fırtınası tetikleyicisiyle etkinleşir. Tek satırlık bir CSS düzenlemesi, şartname döngüsünü hiç çağırmadan Claude Code’dan geçirilebilir. Buradaki gerçek hata modu, şartname gerektirmeyen işe iş akışını aşırı uygulamaktır.

GitHub Spec Kit

Spec Kit, şartnamenin tek bir Claude Code oturumundan daha uzun ömürlü olması gerektiğinde tercih edilir. Ayrıca Claude Code’u hiç açmayan kişilerin şartnameyi okuması gerektiğinde de doğru seçimdir.

GitHub spec-kit nedir?

Spec Kit, GitHub’ın ( github/spec-kit, MIT lisans) bizzat bakımını yaptığı, 100 binden fazla yıldıza sahip bir GitHub projesidir. Tüm büyük yapay zekâ kodlama ajanlarında aynı şekilde çalışan bir CLI ve iş akışı sunar. Claude Code, Cursor, Aider, Cline ve Roo Code desteklenir. Ajan-nötr tasarım, şartnamenin Claude Code dışında yaşamasını sağlar.

Title: GitHub repo page for github/spec-kit showing the repo title, description, star count, and the top of the README. - Description: GitHub repo page for github/spec-kit showing the repo title, description, star count, and the top of the README.

GitHub’daki Spec Kit proje sayfası.

GitHub spec-kit nasıl kurulur

Henüz resmi bir PyPI paketi yok; bu yüzden CLI’ı etiketten uv ile kurun:

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z

vX.Y.Z’yi güncel sürüm etiketiyle değiştirin. Paketin adı specify-cli’dır ve kaydettiği komut specify’dır.

GitHub spec-kit iş akışı

İş akışı, CLI’ın ajanın eğik çizgi (slash) komut listesine eklediği dokuz komutla çalışır. Altısı döngünün çekirdeğidir; üçüyse, çekirdek döngünün kapsamadığı durumlar için isteğe bağlıdır.

Eğik çizgi komutu

Tür

Açıklama

/speckit.constitution

Çekirdek

Daha sonra gelecek her çıktının uyması gereken proje kurallarını yazar

/speckit.specify

Çekirdek

Şartnameyi üretir

/speckit.plan

Çekirdek

Mimari belgeyi üretir

/speckit.tasks

Çekirdek

Numaralı görev listesini üretir

/speckit.taskstoissues

Çekirdek

Bu görevleri GitHub issue’larına dönüştürür

/speckit.implement

Çekirdek

Görevleri tek tek işler

/speckit.clarify

İsteğe bağlı

Şartnamede boşluk olduğunda kullanıcıya takip soruları sorar

/speckit.analyze

İsteğe bağlı

Şartname, plan ve görevler arasında çelişki arar

/speckit.checklist

İsteğe bağlı

Uygulamadan önce çıktılar üzerinde kalite kontrolü çalıştırır

Komut grubu ile fiil arasındaki ayırıcı iki nokta değil, noktadır: /speckit.specify, /speckit:specify değil. 

Title: A horizontal blue pipeline of six core Spec Kit slash commands on a white canvas, with three green optional commands sitting below and connecting upward to the pipeline via dashed lines. - Description: A horizontal blue pipeline of six core Spec Kit slash commands on a white canvas, with three green optional commands sitting below and connecting upward to the pipeline via dashed lines.

Dokuz Spec Kit eğik çizgi komutu: boru hattında altı çekirdek komut, ona bağlı üç isteğe bağlı komut.

Bu komutların ürettiği çıktılar, Superpowers bölümünde gördüğünüzle aynı şartname ve plandır; bunlar da diske yazılır ve Git ile izlenir. Fark, taşınabilirliktir: Spec Kit’in çıktıları yalnızca Claude Code ile değil herhangi bir yapay zekâ kodlama ajanıyla çalışacak şekilde tasarlanmıştır; ayrıca iş akışı, tek bir aracın döngüsünün yan ürünü olmak yerine, GitHub pull request’leri üzerinden paydaş incelemesi için inşa edilmiştir.

GitHub spec-kit ne zaman kullanılmalı

Solo bir projede muhtemelen Spec Kit’e ihtiyaç duymazsınız. Şu durumlarda ona başvurun:

  • Proje bir kişiyi aşıyorsa
  • Şartnamenin, Claude Code’u hiç açmayan kişilerce incelenmesi gerekiyorsa
  • İşin bir kısmında Claude Code dışındaki bir ajan çalıştırıyorsanız
  • Herhangi bir araca bağlı olmadan yaşayacak ve aylar sonra da okunacak bir şartname formatı istiyorsanız

BMAD Yöntemi

Spec Kit çıktıları düzenlerken, BMAD insanları düzenler. Spec’ten koda iş akışını, her biri isimli bir rol-ajan tarafından yürütülen dört aşamaya böler.

BMAD nedir?

BMAD-METHOD (bmad-code-org/BMAD-METHOD, MIT lisans, yaklaşık 47 bin yıldız) sürüm 6’dadır. Projenin kendi dokümanlarında akronim, “Breakthrough Method for Agile AI-Driven Development” olarak açılır. Claude Code ve diğer ajanların üzerinde çalışır ve bir modül ekosistemi olarak kurulur. Varsayılan kurulum, altı rol-ajanı, dört iş akışı aşaması ve 34+ adlandırılmış iş akışı barındıran bir çekirdek modül sunar.

Title: GitHub repo page for bmad-code-org/BMAD-METHOD showing the repo title, description, star count, and the top of the README. - Description: GitHub repo page for bmad-code-org/BMAD-METHOD showing the repo title, description, star count, and the top of the README.

GitHub’daki BMAD-METHOD proje sayfası.

BMAD nasıl kurulur

BMAD’i Node ile kurun:

npx bmad-method install

Altı rol-ajan, kullanıcı tarafından ajan barındırıcısı içinden adlarıyla etkinleştirilen komut istemi personalarıdır. Claude Code’da bu, BMAD’in kurduğu etkinleştirme komutunu yazmak anlamına gelir. Sürümden sürüme değişebildiği için tam sözdizimi için README’ye bakın. 

BMAD çalışma arkadaşı ajanları ve çıktılarıyla tanışın

Bir kez etkinleşince, ajan o rolün talimatlarını, sesini ve çıktılarını siz kişilik değiştirene kadar üstlenir. Altısı şunlardır:

  • Mary, Analist
  • Paige, Teknik Yazar
  • John, Ürün Yöneticisi
  • Sally, UX Tasarımcısı
  • Winston, Mimar
  • Amelia, Geliştirici

v6’da bekleyebileceğiniz iki rol eksiktir: Scrum Master ajanı ve bağımsız bir QA ajanı yoktur. Sprint planlama ve hikâye hazırlığı Geliştirici ajanına düşer; QA test üretimi ise Geliştiricinin tetiklediği bir iş akışıdır.

Çıktı seti tek bir şartnameden daha ağırdır. Şunları elde edersiniz:

  • bir ürün özeti
  • bir PRD (Ürün Gereksinimleri Dokümanı)
  • bir UX şartnamesi
  • bir mimari belge
  • epiklerin kullanıcı hikâyelerine (iş sevk edildiğinde kullanıcıların yapabilecekleri) bölünmüş hâli

PRD ve mimari belge, birlikte Superpowers şartnamesiyle aynı rolü oynar. Ayrım, bunları iki rol-ajan arasında ve daha resmî bir biçime yayar. Çıktı seti bir bütün olarak, her özelliğin bir üst katmandan bağlam devraldığı tam bir yazılım geliştirme yaşam döngüsünü kapsar.

BMAD iş akışı

v6 iş akışı dört aşamada çalışır.

Title: A horizontal four-phase pipeline on a white canvas labeled Analysis, Planning, Solutioning, and Implementation, each phase naming its BMAD agents, with artifacts passed between phases and a Quick Flow shortcut bypassing the first three phases into Implementation. - Description: A horizontal four-phase pipeline on a white canvas labeled Analysis, Planning, Solutioning, and Implementation, each phase naming its BMAD agents, with artifacts passed between phases and a Quick Flow shortcut bypassing the first three phases into Implementation.

Dört BMAD aşaması ve her birini yürüten rol-ajan. Quick Flow hattı, küçük işler için ilk üç aşamayı atlar.

Aşama 1, analiz, isteğe bağlıdır. Mary (Analist) ve Paige (Teknik Yazar) araştırma yapar ve bir ürün özeti üretir. Ne inşa edeceğinizi zaten biliyorsanız bu aşamayı atlayın.

Aşama 2, planlama, zorunludur. John (ÜY) PRD’yi yazar. Özelliğin bir arayüzü varsa Sally (UX Tasarımcısı) bir UX şartnamesi ekler.

Aşama 3, çözümleme, Winston’ın aşamasıdır. Mimar önce mimari taslağı çıkarır, ardından John gereksinimleri epiklere ve hikâyelere böler. Hikâyeleri mimarinin arkasından yerleştirmek, onları gerçek uygulama sınırlarına göre boyutlandıran bir v6 tercihidir. Winston daha sonra UYGUN (PASS), ENDİŞELER (CONCERNS) veya BAŞARISIZ (FAIL) hükmüyle sonuçlanan bir uygulama-hazırlığı kontrolü yürütür.

Aşama 4, uygulama, Amelia’nın (Geliştirici) hikâye hikâye çalıştığı yerdir: hikâyeyi oluştur, inşa et ve kod incelemesini yap. Tam bir epik bittiğinde, tüm epik için QA test üretimi iş akışını tetikler. Claude Code’un gerçek kodlamayı yaptığı aşama, Amelia olarak çalıştığı bu aşamadır.

Küçük ve iyi kapsamlanmış işler için BMAD, Amelia’yı doğrudan etkinleştirip ilk üç aşamayı atlayan bir “Quick Flow” hattı sunar. Etkinleştirme komutu BMAD README’sindedir (tam sözdizimi sürümler arasında değişebilir). Quick Flow, PRD ve mimari belge üretmez; yalnızca kısa bir hikâye ve onu karşılayan kodu üretir. “Bir düğme değişikliği için bu fazla” itirazına cevaptır.

Şartname, uygulama ortasında hatalı çıkarsa BMAD, Winston’ın Aşama 3 hükmüne geri döner. BAŞARISIZ (FAIL), PRD’yi yeniden yazmak üzere sizi Aşama 2’ye gönderir. ENDİŞELER (CONCERNS), Winston’ın belirttiği riskler hikâyeye eklenmiş şekilde devam eder. Bu ayrım, küçük tutarsızlıklarda ilerlemeyi sürdürmenize, büyüklerinde ise sert fren yapmanıza imkân verir.

Karmaşıklığın ne zaman karşılığını verir

BMAD, gerçek kullanıcılara yanıt verilen, uzun soluklu projelerde karşılığını verir. Ayrıca çok geliştiricili ekiplerde işi kişiler arasında devretmeye uygundur. Aşama ve rol ayrımının, maliyetinden daha çok zaman kazandırması gerekir.

Tek kişilik yan projeler için doğru uyum değildir. Solo çalışmada, dört aşama ve altı ajan bölünmesi çoğunlukla ek yüktür. Rol ayrımının anlam taşıyacağı ikinci bir kişi ekipte yoktur.

Çerçeveler Arasında Nasıl Seçim Yapılır

Çerçeve

Kurulum

İşin yaşadığı yer

En uygun olduğu durum

Superpowers

/plugin install superpowers@claude-plugins-official (CC pazar yeri)

Claude Code içinde otomatik yüklenen beceriler

Solo çalışma, tek depo özellikleri, uzun gözetimsiz çalıştırmalar

GitHub Spec Kit

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z (CLI)

Diske şartname, plan ve görev çıktıları üreten dokuz /speckit.* eğik çizgi komutu

Takımlar arası şartname incelemesi, şartnameden koda izlenebilirlik

BMAD-METHOD

npx bmad-method install (Node)

Dört aşama boyunca altı adlandırılmış rol-ajan (Analiz, Planlama, Çözümleme, Uygulama)

Uzun soluklu projeler, döngüde gerçek bir ÜY, çok geliştiricili devirler

Seçimi belirleyen üç kural vardır.

  • Şartname, Claude Code’u hiç açmayan kişilerce okunmalıysa veya Git’te uzun vadeli bir çıktı olarak yaşamalıysa Spec Kit’i kullanın.
  • Birden fazla kişi belirgin rollerde çalışıyorsa veya gerçek bir ÜY tarzı paydaş döngüdeyse BMAD’i kullanın.
  • Aksi halde Superpowers’ı kullanın.

Title: A vertical decision tree on a white canvas with three diamond questions about spec audience, team handoff, and traceability, branching to four outcome cards labeled Superpowers, GitHub Spec Kit, BMAD-METHOD, and Combine. - Description: A vertical decision tree on a white canvas with three diamond questions about spec audience, team handoff, and traceability, branching to four outcome cards labeled Superpowers, GitHub Spec Kit, BMAD-METHOD, and Combine.Projenize dair üç soru, diğer tarafta dört çerçeve seçeneği.

Karar ağacının adlandırdığı dördüncü bir seçenek daha var: Spec Kit ile Superpowers’ı birleştirmek. Çıktılar Git’te takımlar arası inceleme için yaşasın diye şartname aşamasında Spec Kit’i kullanın. Sonra tek satırlık bir yapılandırmayla Superpowers’ın subagent-driven-development becerisini Spec Kit plan dosyasına yönlendirin. Böylece Spec Kit’ten kalıcı şartnameyi, Superpowers’tan ise sıkı uygulama döngüsünü elde edersiniz.

 

Sonuç

Spec-driven geliştirme, sırayla üç belgedir. Şartname neyin inşa edileceğini söyler, plan hangi adımlarla yapılacağını söyler, kod ise planı izler. Her ikili arasında bir insan incelemesi vardır.

Yukarıdaki karar ağacını kullanarak bir çerçeve seçin; çoğu okur için bu Superpowers olacaktır. Onu kurun ve normalde vibe-coding ile yapacağınız, 3 ila 5 dosyaya dokunan bir özelliği seçin. Beyin fırtınası, şartname, plan ve uygulama aşamalarından uçtan uca geçirin. Gerçek bir koşum, bu iş akışını herhangi bir açıklamadan daha iyi öğretir.

Claude Code temel bilgilerini önce tazelemek isterseniz, DataCamp’te uygulamalı bir Claude Code eğitimi, plan modu, CLAUDE.md ve TDD’yi kapsayan en iyi uygulamalar rehberi ve plan modunun kendisine dair derinlemesine bir inceleme bulunur.

Claude Code’da Spec-Driven Development Hakkında SSS

Claude Code’da spec-driven development nedir?

Spec-driven geliştirme, sırayla üç belgeden oluşan bir iş akışıdır: Değişikliğin ne yapması gerektiğini söyleyen bir belge, adımları belirleyen bir plan ve plan doğrultusunda yazılmış kod; her ikili arasında bir insan incelemesiyle.

Claude Code’un yerleşik plan modundan farkı nedir?

Plan modu, tek bir sohbet turu içinde bellekte bir plan üretir; kalıcı bir şartname ve inceleme adımı yoktur. Spec-driven geliştirme ise her iki dosyayı da diskte kalıcı kılar, her birini insan incelemesinden geçirir ve oturumlar boyunca yaşatır.

Hangi çerçeveyle başlamalıyım: Superpowers, GitHub Spec Kit mi yoksa BMAD-METHOD mu?

Tek depo üzerinde solo çalışma için Superpowers ile başlayın. Şartnamenin Git’te yaşaması ve Claude Code’u hiç açmayanlarca okunması gerekiyorsa Spec Kit’e yönelin. Ayrı rollerde çalışan birden fazla kişi varsa BMAD-METHOD’u seçin.

Superpowers’ı Claude Code’a nasıl kurarım?

Claude Code içinde tek komut: /plugin install superpowers@claude-plugins-official. SessionStart kancası iş akışını otomatik yükler; proje başına ayrıca bir kurulum gerekmez.

Uygulama ortasında şartnamenin hatalı olduğu ortaya çıkarsa ne olur?

Döngü durur ve sorar. Superpowers’ta şartnameyi düzenleyip etkilenen görevleri yeniden üretirsiniz. Spec Kit’te çelişkiyi ortaya çıkarmak için /speckit.analyze çalıştırırsınız. BMAD’de, 3. Aşamadan gelen “FAIL” hükmü sizi PRD’yi yeniden yazmak üzere 2. Aşamaya geri gönderir.


Bexruz (Bex) Tuychiev's photo
Author
Bexruz (Bex) Tuychiev
LinkedIn

2 yılı aşkın deneyime sahip bir veri bilimi içerik üreticisiyim ve Medium’da en büyük takipçi kitlelerinden birine sahibim. Yapay zekâ ve makine öğrenimi üzerine, biraz da alaycı bir üslupla yazılmış, ayrıntılı makaleler kaleme almayı seviyorum; çünkü onları biraz daha az sıkıcı hale getirmek için bir şeyler yapmak gerekiyor. 130’un üzerinde makale ve bir de DataCamp kursu ürettim; bir diğeri de hazırlık aşamasında. İçeriklerim 5 milyondan fazla kişi tarafından görüldü; bunların 20 bini Medium ve LinkedIn’de takipçim oldu. 

Konular
Yapay Zekâ Aracıları
Yapay Zeka

En İyi Yapay Zekâ Yazılım Mühendisliği Kursları

Kurs

Claude Code 101

3 sa
27.8K
Learn how to use Claude Code effectively in your daily development workflows.
Ayrıntıları GörüntüleRight Arrow
Kursa Başla
Devamını GörRight Arrow