Repo'yu bilgisayarına al

  • Terminali aç.
  • git clone https://github.com/<kullanici>/<repo>.git yaz. <kullanici> yerine GitHub kullanıcı adını, <repo> yerine ilk derste açtığın repo'nun adını koy.
  • cd <repo> yazıp klasöre gir.
  • claude yazıp Claude Code'u aç.
  • İlk mesaj olarak "CLAUDE.md'yi oku ve başlayalım" yaz.

CLAUDE.md, şablonla gelen yöntem dosyası ve ajan neyi hangi sırayla yapacağını oradan okur. İşe gh auth status ile git remote -v koşarak başlıyor.

GitHub'a bağlı değilsen ya da klasör kendi repo'na bağlı değilse ajan önce bunu düzeltmeni ister.

Üç soru

Neyin listesini tutmak istiyorsun? O listeden ne öğrenmek istiyorsun? Uygulamayı kim kullanacak?

Kısa cevaplar yetiyor. Hesaplanan özellik ikinci soruya verdiğin cevaptan çıkıyor ve bir toplam, bir sıralama, bir öneri ya da bir filtre olabilir. Kitaplarını tutan biri için bu, okumadığı kitaplar arasında en kısası olabilir.

Seçtiğin özellik listede olmayan bir bilgiye ihtiyaç duyarsa ajan bunu söyleyip tek bir soru sorar. Kitaplarının yalnız adını ve sayfa sayısını tutup sıradaki kitabı soruyorsan, okuduklarını nereden bileceğini sorması gerekir.

Okundu ya da ödendi gibi evet ya da hayır diye cevaplanan bir alan, kayıt eklendikten sonra da değişebilir. Böyle bir alanı listede işaretleyebiliyorsun.

SPEC.md'de neye bakacaksın

SPEC.md tek ekranı geçmiyor. Başta amaç ve bir kaydın alanları var, ardından hesaplanan özellik tek cümleyle yazılı. En altta kapsam dışı kalanlar duruyor.

En dikkatli okuyacağın yer kabul kriterleri. Given, when, then kalıbındalar, Türkçesi şu durumdayken, şunu yapınca, şunu görüyorum. Her biri tek bir durum için neye "bitti" deneceğini söylüyor.

Okuduktan sonra "tamam" de ya da düzeltmek istediğin yeri söyle. Onaydan sonra ajan şablonun örnek uygulamasını bilgisayarında çalıştırıp sana bir adres verir.

Kolay yapılan hata

Ajanın verdiği adres yerine ezbere localhost:3000'i açmak. Adres çoğu zaman bu ama bilgisayarında o portu başka bir program kullanıyorsa uygulama başka bir numarayla açılır.

O zaman 3000'de ya hiçbir şey çıkmaz ya da başka bir uygulama. Ajanın mesajındaki adresi aç.

Küçük görev

Hesaplanan özelliğin için rakamlı bir örnek yaz. Kitap listesi için şöyle bir örnek olabilir. Okunmamış 120 ve 300 sayfalık iki kitap, bir de okunmuş 50 sayfalık bir kitap varken uygulama 120 sayfalık kitabı önermeli.

SPEC.md'nin kabul kriterlerinde bu örnek ya da benzeri yoksa ajandan eklemesini iste ve sonra onay ver.