Yapay zeka uretimi kodun kalitesi neredeyse tamamen ne istediginize ve nasil istediginize baglidir. Bu kilavuz, Claude Code ile tutarli olarak daha iyi sonuclar ureten kaliplari kapsar.
Görev kapsamlamasindan sistem promptlarina, yinelemeli iyilestirmeden role ozgu talimatlara. Bir sonraki kodlama oturumunuzda uygulayabileceginiz pratik teknikler.
Bir insan geliştiriciden 'giris sayfası yap' dediginizde aciklayici sorular sorar: hangi kimlik dogrulama saglayici? Hangi alanlar? OAuth yönetmeli mi? Hata mesajlari? Yükleme durumlari?
Yapay zeka kodlama ajanlari tum bu sorulari kendileri yanitlamaya calisir. Bazen dogru tahmin ederler. Cogu zaman mantikli ama istediginiz olmayan bir sey uretirler. 'Mantikli' ile 'tam istenen' arasindaki farki prompt muhendisligi kapatir.
Iyi promptlarin uzun olmasi gerekmez. Önemli seyler hakkinda spesifik, önemli olmayanlar hakkinda sessiz olmalari gerekir. Bu denge bu kilavuzun konusudur.
Görevden bagimsiz olarak sonuclari iyilestiren kaliplar.
'React bileseni olustur, sonra state ekle, sonra stil ekle' demek yerine son sonucu tanimlayin: 'Proje adlarini gosteren, surukle-yeniden siralamayi destekleyen ve mevcut Tailwind temamizi kullanan katlanabilir kenar cubugu yap.' Ajanin oraya nasil ulasacagina karar vermesine izin verin.
Avoid
Bir bilesen olustur. useState ekle. Bir toggle dugmesi ekle. Tailwind ile stillendir.
Better
Projeleri ada gore listeleyen katlanabilir kenar cubugu bileseni yap. Surukle-yeniden siralamyi desteklemeli ve koyu temamiza (bg-[#111318], border-[#262b38]) uymal. Katlanmis durum sayfa yenilemelerinde kalici olmali.
Ajanlar sinirlari bildiginde en iyi calisir. Hangi dosyalara dokunulacagini (veya kacinilacagini), hangi kaliplarin izlenecegini ve 'tamamlandi'nin nasil gorunecegini belirleyin. Sinirsiz görevler incelemesi zor yaygin değişikliklere yol acar.
Avoid
Kimlik dogrulama sistemini yeniden yapılandır.
Better
src/api/auth/login.ts'deki giris isleyicisini parola hashleme icin sha256 yerine bcrypt kullanacak sekilde yeniden yapılandır. JWT mantigi veya oturum cerez yönetimini değiştirme. tests/auth/ icindeki ilgili testleri guncelle.
Claude Code proje dosyalarinizi okuyabilir ama zihninizi okuyamaz. Uydugunuz bir kural, tercih ettiginiz bir kutuphane veya zaten olusturdugunuz bir kalip varsa soyleyin. Bu, yeniden çalışmadan tasarruf saglar.
Avoid
Form dogrulama ekle.
Better
Kayit formuna zod kullanarak form dogrulama ekle (zaten ayarlar formu icin src/forms/settings.ts'de kullaniyoruz). Her alanin altinda satir ici hata mesajlari goster. Giris formundaki ayni hata stillendirmesini takip et.
Bilesik promptlar ('API'yi yap, testleri yaz, dokumanlari guncelle ve dagit') ajani ayni anda cok fazla hedef tutmaya zorlar. Karmasik isi sirali, odakli görevlere bolen. Her biri bir onceki sonucun uzerine insa eder.
Avoid
Kullanici profil sayfasini yap, API endpoint'lerini yaz, testler ekle, README'yi guncelle ve ara sira nav bar'i da düzelt.
Better
GET /api/user/profile endpoint'ini olustur. id, name, email ve plan alanlrini dondur. Kimlik dogrulama icin mevcut auth middleware'i kullan.
Ilk sonuc dogru degilse bastan baslamak yerine promptu iyilestirin. Claude tam konusma baglamini korur. Neyin yanlis oldugunu, neyin degismesi gerektigini ve neyin kalmasini istediginizi soyleyin. Yineleme yeniden icat etmekten daha hizlidir.
Avoid
Yanlis. Bastan basla ve bileseni farkli sekilde yap.
Better
Duzen iyi ama mobil kirilma noktasi yanlis. 768px altinda kartlari izgara yerine dikey olarak istifle. Geri kalan her seyi oldugu gibi birak.
Sistem promptlari, siz bir sey soylemeden once ajanin temel davranisini belirler. Yapay zeka kodlamadaki en az kullanilan aractir.
Sistem promptu ajana kim oldugunu, neye odaklanmasi gerektigini ve nelerden kacinmasi gerektigini soyler. Oturumdaki her mesaja uygulanir. Ajanin görev tanimi olarak dusunun.
AgentsRoom 14 role ozgu sistem promptuyla gelir: her ajan tipi icin bir tane. Frontend ajaninin promptu bilesenlere, erisilebilirlige ve duyarli tasarima odaklanmasini soyler. QA ajaninin promptu sinir durumlari hakkinda dusunmesini ve kapsamli testler yazmasini soyler. Bunlari ozellestirebilir veya kendinizinkini yazabilirsiniz.
Kidemli frontend geliştiricisiniz. React bilesenlerine, CSS/Tailwind stillendirmesine, erisilebilirlige (WCAG AA) ve duyarli tasarima odaklanin. Yeni bilesenler olusturmadan once projenin mevcut bilesen kutuphanesini kullanin. Kalitim yerine bilesimi tercih edin. Semantik HTML yazin. Backend dosyalarini asla değiştirmeyin.
En etkili prompt bir sohbete yazilmaz. Deponuzda yasalar.
CLAUDE.md, projenizin kokunde bulunan ve Claude Code'un otomatik okuudugu bir markdown dosyasidir. Projedeki her ajan oturumuna uygulanan proje yapisi, kurallar, yigin ayrintilari ve yonergeler icerir.
Her konusmada 'Tailwind CSS 4, Prisma ORM ve Next.js 16 kullaniyoruz' demek yerine CLAUDE.md'ye bir kez yazin. Her ajan bu baglami devralir. AgentsRoom, uygulamadan cikmadan CLAUDE.md'yi guncelleyebilmeniz icin yerlesik editorle gelir.
Iyi yazilmis bir CLAUDE.md duuzinelerce ozenle hazirlanmis bireysel prompttan daha degerlidir. Birikmeli etki yapar: her oturum bundan faydalanir.
Ayni talimatlari tekrar tekrar yazmayi birakin. Isleyeni kaydedin ve yeniden kullanin.
Projeler genelinde ayni tür istekleri yazdiginizi goruyorsaniz ('bu dosya icin birim testleri yaz', 'bunu repository kalibina uyarla', 'tum API rotalarina hata yönetimi ekle') yeniden kullanilabilir prompt olarak kaydedin.
AgentsRoom iki duzeyyle prompt kutuphanesi ozelligi icerir: projeye ozgu görevler icin proje duzeyinde promptlar ve her yerde kullandiginiz kaliplar icin global promptlar (bulut senkronizasyonlu).
Kutuphane promptlari icin iyi adaylar: kod inceleme kontrol listeleri, test yazma sablonlari, taasima betikleri, bilesen iskelesi talimatlari, güvenlik denetim adimlari. Bir ekip vikisine standart prosedur olarak koyacaginiz her sey.
[dosya] icin birim testleri yaz. vitest kullan. Mutlu yolu, sinir durumlarini (bos girdi, null, gecersiz tipler) ve hata yönetimini kapsa. Dis bagimliliklari mockla. >%90 dal kapsamini hedefle.
Mevcut git diff'indeki değişiklikleri incele. Kontrol et: kullanilmayan importlar, eksik hata yönetimi, tip güvenligi sorunlari, potansiyel yaris kosullari ve adlandirma tutarsizliklari. Bulunan her sorun icin düzeltme oner.
[kaynak] icin REST endpoint olustur. zod ile girdi dogrulamasi, uygun hata yanitlari (400, 401, 404, 500), istek/yanit icin TypeScript tipleri ve endpoint'i tanimlayan JSDoc yorumu ekle. src/api/ icindeki mevcut kalibi takip et.
Tek promptlarin otesine gecen karmasik görevler icin teknikler.
Buyuk bir görevi sirali adimlara bolen. Ilk ajanini birinci adimla baslatin, tamamlanmasini bekleyin, sonra bir sonraki ajani ikinci adimla baslatin (birinci adimin ciktisina referansla). Her adim daha kucuk ve daha odaklidir. Ornek: Ajan 1 veritabani semasini tasarlar, Ajan 2 bu semayi kullanan API'yi yazar, Ajan 3 API'ye karsi testler yazar.
Bir ajan bitirdikten sonra farkli bir ajani ciktisina yönlendirin. 'Frontend ajaninin src/components/ icinde yaptigi değişiklikleri incele. Erisilebilirlik sorunlarina ve eksik hata durumlarinia bak.' Farkli role sahip yeni bir ajan, orijinal ajanin kacirdiklarini yakalar.
Ajanin soruna nasil yaklastigini gormek icin gevsek bir promptla baslayin. Sonra takip mesajlarinda kisitlamalar ekleyin: 'Yapi iyi ama istemci bilesenleri yerine sunucu bilesenleri kullan.' 'Hook'u koru ama useEffect'i kaldir ve React Query mutation kullan.' Her yineleme istediginiz cozume dogru daraltir.
Ajani mevcut koda yönlendirin: 'src/pages/profile.tsx ile ayni kalibi izleyerek ayarlar sayfası yap. Ayni duzen yapisi, ayni form yönetimi, ayni hata görüntülemesi.' Bu genellikle kalibi kelimelerle tanimlamaktan daha etkilidir.
Tutarli olarak daha kotu sonuclar ureten kaliplar.
Ajana tam olarak hangi fonksiyonlari yazacagini, hangi degiskenleri adlandiracagini ve hangi sirada uygulayacagini soylemek. Bu mikro yönetim ajanin daha iyi yaklasim bulma yetenegini ortadan kaldirir. Proseduru degil sonucu tanimlayin.
Ajandan kisitlama olmadan 'kod tabanini iyilestir' istemek. Sinirlar olmadan ajan dokunmak istemediginiz dosyalari yeniden yapılandırabilir, diger kodun bagimli oldugu API'leri değiştirebilir veya dusuk oncelikli iyilestirmelere token harcayabilir.
Projede zaten bir kalip, araac veya bilesen bulundugunu belirtmemek. Ajan yeni bir tane olusturur. Basit bir 'src/hooks/'da zaten bir useAuth hook'umuz var' ciddi yeniden çalışmadan tasarruf saglar.
Bes görevi tek mesaja sigdirmak. Ajan hepsini deneyecek ama yarisan hedeflerle basa cikarken kalite duser. Bunlari sirali, odakli isteklere bolun.
AgentsRoom size yerlesik sistem promptlari, prompt kutuphanesi ve CLAUDE.md düzenleme sunar. Prompt hazirlama icin daha az zaman, geliştirme icin daha fazla zaman.
Yardımcı uygulama: hareket halindeyken ajanlarinizi izleyin
Claude, Codex, Gemini CLI veya başka bir AI sağlayıcı kullan.
Hataları ve istekleri doğrudan genel backlogunuza gönderin.