Gün 4: Workflow — Kendi Komut Düğmeni Yap

Aynı İşi Tekrar Tekrar Yazmak Yorucu

Dün bir harita çizdik: requirements.md (varış) + features/ klasörü (duraklar). Şimdi her durağı yapmak için Bıdık’a hep aynı şeyi söyleyeceğiz:

“Sıradaki özellik dosyasını oku, kabul kriterine bak, kodu yaz, sonra tarayıcıda test et.”

Bunu her özellik için tekrar yazmak çok yorucu. İşte burada workflow (iş akışı) devreye girer.

Workflow = sık yaptığın bir işi tek bir komuta dönüştürmek. Tıpkı bir oyun kumandasındaki tek tuşa “zıpla + dön + ateş et” hareketini atamak gibi. Bir kere ayarlarsın, sonra tek tuşla çalışır.

Kendi Komutunu Yapmak: Custom Slash Command

Hatırla, / ile başlayan şeyler komuttu (/help, /memory, /skills). Bunlar Bıdık’ın hazır komutları. Ama sen kendi komutunu da yapabilirsin!

Bunun için projende özel bir klasör var: .claude/commands/. Bu klasöre koyduğun her dosya, otomatik olarak bir /komut haline gelir.

.claude/commands/siradaki-ozellik.md   →   /siradaki-ozellik komutu olur

.claude/commands/ = senin özel komut düğmelerinin kutusu. İçine bir dosya koyarsan, adı /dosya-adı olan yeni bir komut doğar. Dosyanın içine “bu komut ne yapsın” yazarsın; Bıdık çağrılınca onu okuyup yapar.

Şimdi Dene: /siradaki-ozellik Komutunu Yarat

Bıdık’a kendi komut düğmemizi yaptıralım. Şu komutu birebir ver:

.claude/commands/ klasörüne "siradaki-ozellik.md" adında bir komut
dosyası oluştur. Bu komut şunu yapsın:

1. features/ klasörüne bak ve henüz bitmemiş ilk özelliği bul
   (numara sırasına göre: 01, 02, 03...).
2. O özelliğin dosyasını oku, kabul kriterini gör.
3. Özelliği yap (kodu yaz).
4. Playwright aletiyle oyunu tarayıcıda açıp test et, ekran görüntüsü al.
5. Kabul kriteri sağlandıysa bana "imzaya hazır" de, sağlanmadıysa düzelt.

Komut dosyasını oluştur ama henüz çalıştırma.

Bıdık komut dosyasını oluşturacak:

● .claude/commands/siradaki-ozellik.md oluşturuluyor...

  ✓ Yeni komutun hazır: /siradaki-ozellik
  Bunu yazınca haritadaki sıradaki durağı otomatik yaparım.

Komutun gerçekten oluştuğunu görmek için /help yazabilirsin — listede artık /siradaki-ozellik görünür.

Tek Tuşla Özellik İnşası

Şimdi büyülü kısım. Bıdık’a sadece şunu yaz:

/siradaki-ozellik

Bıdık komutu okuyacak ve tüm adımları kendisi yapacak:

● /siradaki-ozellik çalışıyor...

  → features/01-temel-oyun.md okundu (henüz bitmemiş ilk özellik)
  → Kabul kriteri: Besle/Oyna/Uyut çubukları doğru değiştirsin
  → Kod yazılıyor... app.js güncellendi
  → Playwright ile test ediliyor... butonlar çalışıyor ✓
  → Ekran görüntüsü alındı

  ✓ 01-temel-oyun imzaya hazır! Onaylıyor musun?

Tek bir komut — /siradaki-ozellik — bütün bir işi başlattı: dosyayı okudu, kodu yazdı, test etti, kanıt getirdi. İşte workflow’un gücü bu.

Onayladığında (“imzalandı, sıradakine geç” de), bir dahaki sefere yine /siradaki-ozellik yazarsın ve Bıdık bir sonraki durağa (02) geçer. Aynı tuş, sıradaki iş.

Eski usul: Her özellik için dört beş cümle yazardın. Workflow ile: /siradaki-ozellik yaz, gerisini Bıdık halleder.

Başka Komut Düğmeleri de Yapabilirsin

Aynı mantıkla istediğin kadar komut yapabilirsin:

• /renk-degistir → oyunun temasını yenileyen bir komut.
• /hata-avi → oyundaki bütün hataları arayan bir komut.
• /ekran-goruntusu → oyunun bütün ekranlarının fotoğrafını çeken bir komut.

Hayat kuralı: Bir işi ikiden fazla kez yapıyorsan, onu bir komuta dönüştür. Bir kere ayarla, sonsuza kadar tek tuşla çalıştır.

Kontrol Noktası ✅

• .claude/commands/ klasöründe siradaki-ozellik.md dosyası oluştu.
• /help listesinde kendi komutum /siradaki-ozellik görünüyor.
• /siradaki-ozellik yazdım; Bıdık dosyayı okudu, kodu yazdı, test etti.
• İlk özelliği (01) tek bir komutla inşa edip imzaladım.

Bugün Ne Öğrendin?

• Workflow, sık yaptığın bir işi tek bir komuta dönüştürmektir.
• .claude/commands/ klasörüne koyduğun her dosya bir /komut olur.
• Kendi /siradaki-ozellik komutun, haritadaki durağı otomatik yapar.
• İki kez yaptığın işi bir komuta çevir: bir kere ayarla, hep kullan.

Ebeveyn Notu

Custom slash command, Claude Code’da tekrar eden iş akışlarını otomatikleştirmenin yoludur: .claude/commands/ klasöründeki her Markdown dosyası, /dosya-adı ile çağrılan bir komuta dönüşür. Çocuğunuz, “tekrar eden işi araca öğret” prensibini öğrenir — bu, bilgisayar biliminde “otomasyon” denen temel bir fikirdir. Kendi komutunu yaratmak, çocuğunuzu pasif kullanıcıdan araç tasarımcısı konumuna taşır. Yarın bu komutu daha da akıllı hale getireceğiz (şartlı akış).

Etkinlik (Elle Yapılacak)

Bir kağıda “Komut Düğmesi Tasarımı” yapın. Çocuğunuz hayalindeki bir komutu tasarlasın:

• Komutun adı: /...
• Ne yapsın? (adım adım): 1… 2… 3…
• Ne zaman kullanılır?

Sonra bu komutu gerçekten Bıdık’a yazdırmayı deneyin. Çocuğunuz kendi tasarladığı bir aracı çalışırken görmenin gururunu yaşayacak.

Yarın

Yarın komutumuzu akıllı yapacağız: Dynamic Workflow (şartlı akış) ve Hooks (otomatik tetikleyiciler). Bıdık “eğer şu olursa şunu yap, yoksa bunu yap” diye karar verebilecek ve bazı işleri sen söylemeden, otomatik yapacak!