Agentic Coding Frameworks

Agentic Coding Framework Nedir?

Agentic coding framework, AI coding assistant’ları (Claude Code, Cursor, Copilot vb.) yapılandırılmamış “vibe coding”den disiplinli bir geliştirme sürecine taşıyan yöntem ve kural setleridir. Bu framework’ler, AI’a ne yapacağını adım adım söylemek yerine; roller, fazlar, gate’ler ve specification’lar tanımlayarak AI’ın otonom ama kontrollü çalışmasını sağlar.

Geleneksel yaklaşımda geliştirici prompt yazar, AI kod üretir, geliştirici review eder. Agentic framework’lerde ise AI bir takım gibi davranır: analiz yapar, plan oluşturur, specification yazar, implement eder ve kendi kendini doğrular.

Ihtiyac Nereden Cikti?

AI coding tool’ları giderek daha yetenekli hale geldikce, “vibe coding” problemi büyüdü:

• Tekrarlanabilirlik sorunu: Aynı prompt, farklı session’larda farklı sonuçlar üretilmesi problemi
• Context kaybı: Uzun session’larda AI önceki kararları unutur, tutarsız kod üretir. Kodun okunaklığı veya tüm kod yapısında düzen bozulmasına sebebiyet verir.
• Specification eksikliği: Geliştirici kafasındaki tasarımı AI’a aktaramaz, sonuç beklentiden sapar. Hepimizin çok sık karşılaştığı, talep edilen ister ile üretilen arasındaki fark (analiz gap) sonucudur. Bu gerçek hala devam etmektedir.
• Review darboğazı: AI hızlı kod üretir ama review edilmemiş kod teknik borç biriktiriyor. Tamamen AI ile vibe coding yaptırılarak yazılan bir proje için destek istendi. 4M satır kod üretmiş. Yukarıdaki tüm problemlere referans ve örnekti. Agentic framework kullanılmamasının bir sonucu.
• Koordinasyon zorluğu: Birden fazla AI session’ı aynı proje üzerinde çalıştığında conflict ve tutarsızlık oluşuyor. (Yine bütünlük problemi ana sebep)

Enterprise projelerde bu sorunlar katlanarak büyüyor. Bir startup’ta “hızlı ve kırılgan” kabul edilebilirken, 50+ kişilik bir takımda AI’ın ürettiği her satır kodun izlenebilir, tekrarlanabilir ve review edilmiş olması gerekiyor.

Neden Kullanmalıyız?

Framework kullanmanın temel faydası: AI’ı bir araçtan bir takım üyesine dönüştürmek. Araç kullanırsınız; takım üyesiyle işbirliği yaparsınız.

The Shared Triad: Agent, Workflow, Skill

Framework’ler arasındaki farklara dalmadan once, ortak noktalarını görmek gerekir. Felsefi olarak ne kadar ayrışsalar da, bu karşılaştırmadaki her framework zekasını aynı üç temel yapı taşı üzerine kurar.

Agent’lar, sistemin üstlendigi persona veya rollerdir. BMAD bunlara persona der (Analyst, Architect, Developer). GSD subagent olarak adlandırır (researcher, planner, executor). Superpowers bunları contextual olarak tetiklenen skill’ler (bazen gate olarak da anılır) olarak tanımlar. SpecKit ise agent davranışını CLI komutlarına gömmüştür. Terminoloji değişir ama konsept aynıdır: tanımlı sorumlulukları olan, sınırları belirlenmiş bir uzmanlık alanı olarak belirlenir.

Workflow’lar, agent’ları pipeline’lara bağlayan dizilerdir. BMAD dört fazlı agile döngüsü kullanır. SpecKit explicit checkpoint’ler ile gated faz’ları zorunlu kılar. GSD execution’ı dependency-ordered wave’ler halinde organize eder. Superpowers skill’leri brainstorming’den code review’a kadar otomatik bir pipeline’a zincirleyerek çalıştır. Her framework, yapılandırılmamış prompting’in kalitesiz sonuç ürettiği konusunda hemfikir; anlaşmazlık ne kadar yapının yeterli olduğuna bağlıdır. (Zayıf promting kaynaklı)

Skill’ler, agent’ların gerçekleştirdiği atomik yeteneklerdir. PRD yazmak. Test çalıştırmak. Diagram üretmek. Kod review etmek. Dependency’leri parse etmek. Her framework farklı skill’ler içerir ama soyutlama aynıdır: tanımlı girdi ve çıktıları olan, yeniden kullanılabilir bir iş birimi olşuturur.

Aşağıdaki diyagram, her framework’un bu ortak triad’ı nasıl farklı uyguladığını gosterir:

graph TD
    AGENTS(["AGENT'LAR<br/><small>Tanımlı sorumlulukları olan<br/>sınırlı uzmanlık alanları</small>"])
    SKILLS(["SKILL'LER<br/><small>Tanımlı girdi ve çıktıları olan<br/>atomik yetenekler</small>"])
    WORKFLOWS(["WORKFLOW'LAR<br/><small>Agent'ları kalite kontrollü<br/>pipeline'lara bağlayan diziler</small>"])

    AGENTS -. "yönetir" .-> WORKFLOWS
    WORKFLOWS -. "çağırır" .-> SKILLS
    SKILLS -. "güçlendirir" .-> AGENTS

    SKILLS -.-> B1
    SKILLS -.-> SK1
    SKILLS -.-> G1
    SKILLS -.-> SP1

    subgraph BMAD [" BMAD "]
        direction TB
        B1["<b>12+ Persona</b><br/>Analyst, Architect<br/>Developer, Scrum Master"]
        B2["<b>4 Fazlı Agile Döngüsü</b><br/>Analiz - Planlama<br/>Çözümleme - Uygulama"]
        B3["<b>34+ Temel Workflow</b><br/>PRD, Hikayeler<br/>Mimari Dökümanlar"]
        B1 --- B2 --- B3
    end

    subgraph SPECKIT [" SpecKit "]
        direction TB
        SK1["<b>CLI Komutları</b><br/>Her faz icin gömülü<br/>agent davranışı"]
        SK2["<b>5 Kapılı Faz</b><br/>Constitution - Specify<br/>Plan - Tasks - Implement"]
        SK3["<b>Çıktı Üretimi</b><br/>spec.md, plan.md<br/>research.md, contracts"]
        SK1 --- SK2 --- SK3
    end

    subgraph GSD [" GSD "]
        direction TB
        G1["<b>Uzman Subagent'lar</b><br/>Araştırmacılar, Planlayıcılar<br/>Uygulayıcılar, Doğrulayıcılar"]
        G2["<b>Wave Tabanlı Çalıştırma</b><br/>Bağimlılık sıralı<br/>paralel wave'ler"]
        G3["<b>Çıktı Üretimi</b><br/>spec.md, plan.md<br/>research.md, contracts"]
        G1 --- G2 --- G3
    end

    subgraph SUPERPOWERS [" Superpowers "]
        direction TB
        SP1["<b>Bağlamsal Skill'ler</b><br/>Geliştirme fazına göre<br/>otomatik tetiklenir"]
        SP2["<b>Kapılı Pipeline</b><br/>Brainstorm - TDD<br/>Implement - Review"]
        SP3["<b>Kalite Zorunlulugu</b><br/>TDD silme kuralı<br/>iki aşamalı review"]
        SP1 --- SP2 --- SP3
    end

    classDef triad fill:#0d1b2a,stroke:#e63946,stroke-width:2px,color:#f1faee,font-weight:bold
    classDef fwTitle fill:#1b263b,stroke:#e63946,stroke-width:2px,color:#e63946,font-weight:bold
    classDef fwItem fill:#1b263b,stroke:#457b9d,stroke-width:1px,color:#a8dadc

    class AGENTS,SKILLS,WORKFLOWS triad
    class B1,B2,B3,SK1,SK2,SK3,G1,G2,G3,SP1,SP2,SP3 fwItem

    linkStyle 0,1,2,3,4,5,6 stroke:#e63946,stroke-width:1px,stroke-dasharray:5

Framework Karşılaştırması

Beş agentic coding framework toplamda 200K+ GitHub star’a sahip ve her biri vibe coding’i disiplinli AI-assisted development ile değiştirmeyi vaat ediyor.

Bu karşılaştırma; BMAD’ın enterprise takım simülasyonunu, SpecKit’in gated specification sürecini, OpenSpec’in brownfield-first delta spec yaklaşımını, GSD’nin context-isolating wave parallelism’ini ve Superpowers’ın TDD-enforced disiplin sistemini inceliyor.

Choosing Your Framework: A Decision Matrix

Hiçbir framework evrensel olarak en iyisi değildir. Doğru seçim takım büyüklüğünüze, proje tipinize, kalite gereksinimlerinize ve seremoni toleransınıza bağlıdır. AI assistant alışkanlıkları, ekibinizin ve sizin iş yapış yöntemlerinize göre değişiklik göstermektedir.

Hangi Framework’ü Kullanmalısınız?

flowchart TD
    START{"Yeni proje mi,<br/>mevcut kod tabanı mı?"}

    START -- "Yeni proje" --> ENT{"Enterprise izlenebilirlik<br/>ve denetim izi<br/>gerekiyor mu?"}
    START -- "Mevcut kod tabanı" --> EXIST{"En önemli olan:<br/>çalıştırma hızı mı,<br/>kod kalitesi mi?"}

    ENT -- "Evet" --> BMAD_R["BMAD"]
    ENT -- "Hayır" --> SPEC_Q{"Specification titizliği<br/>en öncelikli mi?"}

    SPEC_Q -- "Evet" --> SPECKIT_R["SpecKit"]
    SPEC_Q -- "Hayır" --> FREQ{"Sık, artımsal<br/>değişiklikler mi<br/>yapıyorsunuz?"}

    FREQ -- "Evet" --> GSD_R["GSD"]
    FREQ -- "Hayır, büyük<br/>feature çalışması" --> GSD_R2["GSD"]

    EXIST -- "Çalıştırma hızı" --> PAR{"Çok görevde paralel<br/>çalıştırma gerekiyor mu?"}
    EXIST -- "Kod kalitesi" --> SP_R["Superpowers"]

    PAR -- "Evet" --> GSD_R3["GSD"]
    PAR -- "Hayır" --> OPENSPEC_R["OpenSpec"]

    BMAD_R --> HYBRID{"Hybrid<br/>Kombinasyonlar"}
    SPECKIT_R --> HYBRID
    GSD_R --> HYBRID
    GSD_R2 --> HYBRID
    SP_R --> HYBRID
    GSD_R3 --> HYBRID
    OPENSPEC_R --> HYBRID

    HYBRID --- H1["SpecKit + GSD"]
    HYBRID --- H2["BMAD + Superpowers"]
    HYBRID --- H3["OpenSpec + Superpowers"]

    style START fill:#0d1b2a,stroke:#e63946,stroke-width:2px,color:#f1faee
    style ENT fill:#0d1b2a,stroke:#e63946,stroke-width:1px,color:#f1faee
    style SPEC_Q fill:#0d1b2a,stroke:#e63946,stroke-width:1px,color:#f1faee
    style FREQ fill:#0d1b2a,stroke:#e63946,stroke-width:1px,color:#f1faee
    style EXIST fill:#0d1b2a,stroke:#e63946,stroke-width:1px,color:#f1faee
    style PAR fill:#0d1b2a,stroke:#e63946,stroke-width:1px,color:#f1faee
    style HYBRID fill:#0d1b2a,stroke:#e63946,stroke-width:2px,color:#f1faee,stroke-dasharray:5

    style BMAD_R fill:#1b263b,stroke:#e63946,stroke-width:2px,color:#f1faee,font-weight:bold
    style SPECKIT_R fill:#1b263b,stroke:#e63946,stroke-width:2px,color:#f1faee,font-weight:bold
    style GSD_R fill:#1b263b,stroke:#e63946,stroke-width:2px,color:#f1faee,font-weight:bold
    style GSD_R2 fill:#1b263b,stroke:#e63946,stroke-width:2px,color:#f1faee,font-weight:bold
    style GSD_R3 fill:#1b263b,stroke:#e63946,stroke-width:2px,color:#f1faee,font-weight:bold
    style SP_R fill:#1b263b,stroke:#e63946,stroke-width:2px,color:#f1faee,font-weight:bold
    style OPENSPEC_R fill:#1b263b,stroke:#e63946,stroke-width:2px,color:#f1faee,font-weight:bold

    style H1 fill:#1b263b,stroke:#457b9d,stroke-width:1px,color:#a8dadc,stroke-dasharray:5
    style H2 fill:#1b263b,stroke:#457b9d,stroke-width:1px,color:#a8dadc,stroke-dasharray:5
    style H3 fill:#1b263b,stroke:#457b9d,stroke-width:1px,color:#a8dadc,stroke-dasharray:5

Quick Decision Guide

BMAD’ı seçin; birden fazla paydaşı olan enterprise yazılım geliştiriyorsanız, denetim izlerine ihtiyacınız varsa ve rol bazlı organizasyondan faydalanacak büyüklükte bir takımınız varsa. Overhead, compliance ve devir teslim dokümantasyonu gerçek gereksinimler olduğunda size avantaj sağlar.

SpecKit’i seçin;sıfırdan yeni bir proje başlatıyorsanız ve mevcut en titiz specification sürecini istiyorsanız. Kapılı fazlar erken implementation’ı önler ve 20+ agent desteği sizi tek bir AI aracına kilitlemez. Artifact üretimindeki zaman yatırımını yeniden çalışmaya karşı garanti olarak kabul edebilirsiniz.

OpenSpec’i seçin; mevcut bir kod tabanı (yada brownfield proje) üzerinde çalışıyorsanız ve devam eden değişiklikler için hafif, iteratif specification gerekiyorsa. Delta marker sistemi ve düşük seremoni günlük kullanım için pratiktir. Yeni bir sistem için kapsamlı mimari dokümantasyon gerekiyorsa atlayın.

GSD’yi seçin; paralel çalıştırmadan faydalanan çok bağımsız bileşenli karmaşık feature’lar geliştiriyorsanız. Context izolasyon mimarisi uzun geliştirme session’ları için gerçekten üstündür. Düzinelerce görev boyunca tutarlı kalitenin bedeli olarak yüksek token maliyetini kabul edin. Ayrıca GSD mevcut kod tabanları için mükemmel desteğe sahiptir ve brownfield projeleri desteklemede uzmandır.

Not: Birçok kategoride başka bir araç bir şeyde en iyiyse, GSD her zaman ikinci en iyidir. Hızlıca bir tane seçmeniz gerekiyorsa, başlamanız gereken GSD’dir.

Superpowers’ı seçin; kod kalitesi birincil endişenizse ve test edilmiş, review edilmiş ve disiplinli çıktı karşılığında daha yavaş hızı kabul etmeye istekliyseniz. Zorunlu brainstorming ve TDD dayatması bu karşılaştırmadaki herhangi bir framework’ün en güvenilir kodunu üretir, ancak her göreve zaman ekler.

Benim Tercihim

Eğer yeni bir proje yapacaksam BMAD Method ile başlıyorum: research, brainstorming, project-brief, mimari, test mimarisi ve PRD adımlarıyla planlama aşamasına kadar tüm artifact’ları oluşturuyorum. Sonrasında Superpowers ile TDD yöntemiyle teknik implementation ve BRD’leri geliştiriyorum.

Superpowers’ın kod kalitesi ve code review aşamaları çok daha güvenli ve Spec Driven Development prensiplerine sadık kalmanızı zorluyor. Yaklaşımındaki disiplini seviyorum.

Yukarıdaki karar grafiğindeki hybrid seçimleri tercih edebilirsiniz. Unutmayın: hiçbir framework tüm problemi çözmüyor. Her şey trade-off. Hiçbir SDD framework silver bullet değildir.

Örnek bir BMAD ve Superpowers uyguladığım proje artifact’larını buradan inceleyebilirsiniz:

• BMAD ile gerçekleşen conversation’lar: bmad-conversation-sessions
• Framework’ün ürettiği artifact’lar: artifacts