Gün 1: Kural Defteri Ver (CLAUDE.md)

R — Kurallar Başlıyor

Artık Bıdık kurulu, ilk dosyamız hazır. Şimdi RAMP’ın ilk harfine geçiyoruz: R — Rules (Kurallar). Bugün çok önemli bir şey öğreneceksin: Bıdık’a bir kural defteri vermek.

Kuralsız Bıdık biraz “kafasına göre takılan” bir arkadaş — hep tahmin eder. Kurallı Bıdık ise tam sana göre çalışır: önce sorar, sonra yapar.

Bu dersin asıl konusu ne yaptırdığın değil, nasıl yaptırdığın. Aynı istek, iki farklı Bıdık. Birinde tahmin eder, diğerinde sorar.

Bıdık’ın Kural Defteri: CLAUDE.md

Claude Code’un her projede aradığı özel bir dosya var: CLAUDE.md. Bu, Bıdık’ın kural defteri. Bıdık her açıldığında bu dosyayı okur ve “tamam, bu projede böyle davranacağım” der.

CLAUDE.md = Bıdık’ın el kitabı. Bir sınıfa yeni gelen öğretmene “bu sınıfta şöyle çalışırız” diye bir not bırakmak gibi. Bıdık o notu okur, ona göre davranır.

Deney: Aynı İstek, İki Farklı Bıdık

Önce kuralsız Bıdık’ı görelim, sonra kurallı olanı. Farkı kendi gözünle göreceksin.

Birinci Tur: Kuralsız

Bıdık’ı başlat (claude) ve şu isteği ver:

Bana yapılacaklar listesi yapan bir uygulama yap. Kanban tahtası gibi
sütunlar olsun, takvim görünümü de olsun.

İzle. Bıdık hemen kod yazmaya başlayacak. Sana hiçbir şey sormayacak. Tahmin edecek, kendi kafasına göre yapacak. Bittiğinde elinde bir uygulama olacak ama tam istediğin gibi olmayabilir. Bu bizim “önce” halimiz.

Belki sütunları beğenmedin, belki takvim farklı oldu. Olabilir — Bıdık senin kafandaki planı okuyamadı. Şimdi ikinci tura geçiyoruz.

İkinci Tur: Kural Defterli

Şimdi Bıdık’a bir kural defteri yazdıracağız. Şu komutu ver:

Bu projeye bir CLAUDE.md kural defteri ekle. İçinde tam olarak şu üç
bölüm olsun:

## 1. Planla
- Bana asla "herhalde böyle ister" deme. Önce sor.
- Tasarım, veri saklama ve kullanıcı hakkında sorular sor.
- Cevaplarım netleşene kadar kod yazmaya başlama.

## 2. Yap
- İşi küçük parçalara böl.
- Her parçayı sırayla yap.
- Çok zor bir parça olursa bir yardımcı robot (subagent) çağır.

## 3. Kontrol Et
- Yazdığın kodu mutlaka test et. "Çalışıyor" sanma, gör.
- Tarayıcıda aç, tıkla, gezin, sonra bana göster.

Dosyayı oluştur ve bana göster.

Bıdık CLAUDE.md dosyasını oluşturacak:

● CLAUDE.md dosyasını oluşturuyorum...

  CLAUDE.md (yeni dosya)
  ──────────────────────
  ## 1. Planla
  - Bana asla "herhalde böyle ister" deme. Önce sor.
  ...

✓ CLAUDE.md oluşturuldu. Bunu her açılışta okuyacağım.

Şimdi çok önemli bir adım: Bıdık’ı kapat ve yeniden aç (kural defterini okusun diye):

/exit

Sonra tekrar:

claude

Bıdık açılırken artık CLAUDE.md’yi okuyacak. Şimdi aynı isteği tekrar ver:

Bana yapılacaklar listesi yapan bir uygulama yap. Kanban tahtası gibi
sütunlar olsun, takvim görünümü de olsun.

İzle. Bıdık bu sefer kod yazmadan önce sana sorular soracak:

• “Görevler nerede saklanacak: tarayıcıda mı, dosyada mı?”
• “Hangi sütunlar olsun: Yapılacak, Yapılıyor, Bitti mi?”
• “Her görevde hangi bilgiler olsun?”
• “Tema açık mı koyu mu olsun?”

Her soruya cevap ver. Bittiğinde elindeki uygulama tam istediğin gibi olacak. Bu bizim “sonra” halimiz.

Aynı istek, iki farklı Bıdık. Kurallar o farkı yarattı.

Bıdık Kendi Defterini de Yazabilir: /init

Her kuralı tek tek yazmak zorunda değilsin. Bıdık, projene bakıp kendi kural defterinin ilk halini yazabilir. Bunun için özel bir komut var:

/init

Bunu yazdığında Bıdık projendeki dosyalara bakar, “burada ne var, ne yapılıyor” diye anlar ve sana bir başlangıç CLAUDE.md hazırlar. Sonra sen onu kendine göre düzenlersin.

/init = “Bıdık, etrafına bak ve bana bir kural defteri taslağı hazırla.” Sonra sen üstüne kendi kurallarını eklersin.

Şimdi Dene: Örnek Projene Kural Defteri

Şimdi bunu kendi örnek projemize (Sanal Evcil Hayvan Bakıcısı) uygulayalım. Bıdık’a şunu ver:

Bizim Sanal Evcil Hayvan Bakıcısı projesi için bir CLAUDE.md yaz.
Şu kuralları koy:
- Bu basit, tek sayfalık bir oyun. Karmaşık şeyler ekleme.
- Sadece üç dosya kullan: index.html, style.css, app.js.
- Renkler neşeli ve çocuk dostu olsun.
- Her değişiklikten sonra bana ne yaptığını kısaca anlat.
- Emin olmadığında tahmin etme, bana sor.

Bıdık bu kural defterini oluşturacak. Artık bu projede Bıdık hep bu kurallara göre çalışacak.

Kontrol Noktası ✅

• Kuralsız Bıdık’ın hemen kod yazmaya başladığını gördüm.
• Bir CLAUDE.md oluşturdum (Planla / Yap / Kontrol Et).
• Bıdık’ı kapatıp açtım, kurallı Bıdık’ın sorular sorduğunu gördüm.
• Örnek projem için kendi CLAUDE.md kural defterimi yazdırdım.

Neden Bu Kadar Önemli?

Çünkü gerçek hayatta da böyle. Bir arkadaşın “film izleyelim” derse, “hangi film?” diye sorarsın. “Yemek yapalım” derse, “ne yemek?” diye sorarsın. Sormak, tahmin etmekten her zaman daha iyi.

CLAUDE.md’ye “bana sor, tahmin etme” yazınca, Bıdık da artık tahmin etmeyi bırakıp soruyor. Her ciddi projeye önce kurallarla başlanır. Bu işin ilk adımı.

Bugün Ne Öğrendin?

• CLAUDE.md Bıdık’ın kural defteri; her açılışta okur.
• Kuralsız Bıdık tahmin eder; kurallı Bıdık sorular sorar.
• Kuralları kapat-aç ile aktif edersin (Bıdık açılışta okur).
• /init ile Bıdık sana bir kural defteri taslağı hazırlayabilir.

Ebeveyn Notu

CLAUDE.md, Claude Code’un kalbidir — projeye özel talimatları buraya yazarsınız ve Bıdık her oturumda otomatik okur. Çocuğunuz bu deneyle çok değerli bir alışkanlık kazanır: “önce sor, sonra yap”. İlk turda Bıdık’ın tahmin edip ikinci turda sorular sormaya başlaması, çocuğunuz için somut bir “kuralların gücü” dersidir. Bu deneyi farklı isteklerle tekrarlayabilirsiniz.

Etkinlik (Elle Yapılacak)

Bir kağıda iki sütun çizin: “Kuralsız Bıdık” ve “Kurallı Bıdık”.

1. Sol sütuna Bıdık’ın kuralsız yaptığı tahminleri yazın (ne yanlış oldu, neleri sormadı).
2. Sağ sütuna Bıdık’ın kural defteriyle sorduğu soruları yazın.
3. İki sütunu karşılaştırın. Fark net görülecek.

Bu kağıdı bilgisayarın yanında tut. Yarın Bıdık’a bir hafıza vereceğiz — geçmişi hatırlayan bir Bıdık!

Yarın

Yarın Bıdık’ın hafızasını (memory) tanıyacağız. Bıdık’a bir şeyi “bunu hep hatırla” diye söylemeyi öğreneceksin. Böylece her seferinde aynı şeyi tekrar tekrar anlatmak zorunda kalmayacaksın!