1) VS Code “Workspace” Nedir?
VS Code’da “workspace” şu demek:
Bir proje klasörünü VS Code’da açtığında, o klasör senin çalışma alanın (workspace) olur.
Yani çoğu insan için workspace = tek bir klasör.
VS Code bunu resmi olarak şöyle tanımlar: bir VS Code penceresinde açtığın bir veya daha fazla klasörün toplamı. Genelde tek klasör olur.
Workspace neden önemli?
Çünkü VS Code o proje için:
- Açık dosyaları hatırlar
- Ayarları proje bazlı saklar
- Eklenti önerilerini proje bazlı tutabilir
Workspace nasıl açılır?
- VS Code → File (Dosya) → Open Folder (Klasör Aç)
- Bir klasör seç → bitti.
O klasör artık “workspace” oldu.
“Multi-root workspace” diye bir şey daha var: Aynı workspace içine birden fazla klasör ekleyebiliyorsun. Ama şimdilik buna gerek yok.
2) BMAD Nedir?
BMAD’i şöyle düşün:
Tek bir yapay zekâ yerine, rolü ve işi belli bir yapay zekâ ekibiyle çalışmak.
Bu ekipte örnek roller:
- Analist: “Bu fikir mantıklı mı?”
- Ürün yöneticisi: “Ne yapacağız, ne yapmayacağız?”
- Mimar: “Bunu nasıl kurarız?”
- Geliştirici: “Bunu yapıyorum”
- Tester: “Çalışıyor mu, sorun var mı?”
3) BMAD Kurulumu (Adım Adım)
Adım 0 — Ön Koşullar
- Node.js v20+ (indir)
- VS Code (indir)
- (Önerilen) VS Code içinde “agentic” çalışabilen bir AI aracı:
- Roo Code (VS Code eklentisi)
- Alternatif: GitHub Copilot Chat
BMAD’i kurmak için tek yapacağın şey: VS Code içindeki terminale bir komut yazmak.
Adım 1 — Proje klasörü oluştur
Bilgisayarda bir klasör oluştur:
- Örn:
bmad-projem
Adım 2 — VS Code’da bu klasörü aç
- VS Code → File → Open Folder
bmad-projemklasörünü seç
Adım 3 — Terminali aç
- VS Code → View → Terminal (Alt tarafta bir ekran açılır)
Adım 4 — BMAD’i kur
Terminale şunu yaz:
npx bmad-method install
Bu komut BMAD’in kurulum yöntemidir.
Kurulum sırasında bazen “nereye kurayım?” gibi bir soru sorabilir. O da proje klasörün (açtığın klasör) olacak.
Kurulum bitince proje klasörünün içinde BMAD ile ilgili dosyalar oluşur. (Ajanlar da bu dosyaların içindedir.)
4) VS Code’da “Ajanları Çalıştırmak” İçin AI Paneli Kur (Roo Code)
BMAD tek başına “konuşmaz/çalışmaz”; onu konuşturmak için VS Code’da bir AI sohbet paneli gerekir. En kolay seçeneklerden biri Roo Code.
Roo Code kurulumu
- VS Code → Extensions (Eklentiler) (
Cmd+Shift+Xya da Ctrl+Shift+X) - “Roo Code” yaz
- Install (Yükle)
- Sol menüde Roo Code ikonuna tıklayıp sohbet panelini aç.
5) Kurduktan Sonra: BMAD Ajanlarını Nasıl Çalıştırırız?
Şimdi en kritik kısım:
BMAD’de “ajan çalıştırmak” demek, AI’ye “şu rol gibi davran” demek.
Yani bir düğmeye basıp robotu başlatmıyorsun; AI ile konuşarak doğru rolü veriyorsun.
BMAD’in mantığı: rol bazlı ajanlar ve iş akışlarıyla (workflow) süreç yönetmek.
En Basit Kullanım
Roo Code sohbetine şu şekilde başlayabilirsin:
1) Analist’i çalıştır (fikir netleştirme) – Project Brief
“BMAD Method kullanıyoruz. Sen şimdi Analist gibi davran. Bana 6 soru sor: hedef kitle, problem, çözüm, neden kullanacaklar, MVP, riskler. Sonra bana 1 sayfalık proje özeti çıkar.”
2) Ürün Yöneticisi’ni çalıştır (ne yapılacak?) – PRD
“Şimdi Ürün Yöneticisi (Product Manager) gibi davran. Bu özete göre ‘PRD’ hazırla: özellikler, yapılmayacaklar, kullanıcı akışı, basit user story listesi.”
3) Mimar’ı çalıştır (nasıl kurulur?) – Sistem Mimarisi
“Şimdi Sistem Mimarı gibi davran. Teknik detayları basitleştirerek anlat: hangi parçalar gerekir (web sitesi, giriş sistemi, veritabanı gibi).”
4) Testçi’yi çalıştır (kontrol) –
“Şimdi Tester gibi davran. En çok nerede hata çıkar? Kullanıcı nerede zorlanır? Checklist hazırla.”
Hepsi bu. Kod bilmeden “şunun gibi davran bunun gibi davran” diyerek ilerlersin.
6) “Workflow” ile İlerlemek (Daha Düzenli Yol)
BMAD’in asıl gücü burada:
Bir iş akışı (workflow) seçersin ve sırayla ilerlersin.
Örnek düzen:
- Analyst → Project brief
- PM → PRD
- Architect → Mimari
- Dev → Yapım
- QA → Test
Bu akış BMAD’in “yapılandırılmış AI geliştirme” fikrinin temelidir.
7) (Opsiyonel) Projeyi AI’ye “Tek Dosya” Olarak Vermek: Flatten
Bazen AI’ye bütün projeyi tek seferde göstermek istersin. BMAD’in bunun için bir “flatten” aracı var (projeyi tek bir dosyada toplar).
Komut örneği:
npx bmad-method flatten --input /proje/klasor/yolu
Not: Bazı sürümlerde “dosya yolunu” vermen gerekebiliyor.
Yeni başlayanlar için şart değil. “Takıldım, AI her şeyi görsün” dediğin gün kullanırsın.
Mini Özet (3 cümlede)
- Workspace: VS Code’da açtığın proje klasörü.
- Kurulum: Terminalde
npx bmad-method install. - Ajan çalıştırma: Roo Code sohbetinde “Analist gibi davran”, “PM gibi davran” diyerek adım adım ilerlemek.
Sonuç: BMAD Neden Önemli?
BMAD Method, yapay zekâyı:
- Sadece “yardımcı” olmaktan çıkarır
- Süreç sahibi bir ekip üyesine dönüştürür
AI destekli geliştirmenin geleceği:
Daha fazla prompt yazmak değil,
doğru ajanı, doğru zamanda konuşturmaktır.
Eğer AI ile ciddi, sürdürülebilir ve profesyonel yazılım geliştirmek istiyorsan, BMAD Method kesinlikle radarında olmalı.
Bir sonraki yazımızda 0’dan propmtlarıyla birlikte örnek proje geliştirmesi yayınlayacağız.
