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.
Gorev kapsamlamasindan sistem promptlarina, yinelemeli iyilestirmeden role ozgu talimatlara. Bir sonraki kodlama oturumunuzda uygulayabileceginiz pratik teknikler.
Bir insan gelistiriciden 'giris sayfasi yap' dediginizde aciklayici sorular sorar: hangi kimlik dogrulama saglayici? Hangi alanlar? OAuth yonetmeli mi? Hata mesajlari? Yukleme 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. Onemli seyler hakkinda spesifik, onemli olmayanlar hakkinda sessiz olmalari gerekir. Bu denge bu kilavuzun konusudur.
Gorevden 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-[#1a1a2e], border-[#2a2a40]) 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 gorevler incelemesi zor yaygin degisikliklere yol acar.
Avoid
Kimlik dogrulama sistemini yeniden yapilandir.
Better
src/api/auth/login.ts'deki giris isleyicisini parola hashleme icin sha256 yerine bcrypt kullanacak sekilde yeniden yapilandir. JWT mantigi veya oturum cerez yonetimini degistirme. 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 calismadan 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 gorevlere 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 duzelt.
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 gorev 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 gelistiricisiniz. 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 degistirmeyin.
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 tur istekleri yazdiginizi goruyorsaniz ('bu dosya icin birim testleri yaz', 'bunu repository kalibina uyarla', 'tum API rotalarina hata yonetimi ekle') yeniden kullanilabilir prompt olarak kaydedin.
AgentsRoom iki duzeyyle prompt kutuphanesi ozelligi icerir: projeye ozgu gorevler 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, guvenlik 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 yonetimini kapsa. Dis bagimliliklari mockla. >%90 dal kapsamini hedefle.
Mevcut git diff'indeki degisiklikleri incele. Kontrol et: kullanilmayan importlar, eksik hata yonetimi, tip guvenligi sorunlari, potansiyel yaris kosullari ve adlandirma tutarsizliklari. Bulunan her sorun icin duzeltme 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 gorevler icin teknikler.
Buyuk bir gorevi 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 yonlendirin. 'Frontend ajaninin src/components/ icinde yaptigi degisiklikleri 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 yonlendirin: 'src/pages/profile.tsx ile ayni kalibi izleyerek ayarlar sayfasi yap. Ayni duzen yapisi, ayni form yonetimi, ayni hata goruntulemesi.' 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 yonetim 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 yapilandirabilir, diger kodun bagimli oldugu API'leri degistirebilir 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 calismadan tasarruf saglar.
Bes gorevi 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 duzenleme sunar. Prompt hazirlama icin daha az zaman, gelistirme icin daha fazla zaman.
Yardimci uygulama: hareket halindeyken ajanlarinizi izleyin
Tum Claude planlariyla uyumlu (Free, Pro, Max, Team, Enterprise)