Yapay zeka üretimi kodun kalitesi neredeyse tamamen ne istediğinize ve nasıl istediğinize bağlıdır. Bu kılavuz, Claude Code ile tutarlı olarak daha iyi sonuçlar üreten kalıpları kapsar.
Görev kapsamlamasından sistem promptlarına, yinelemeli iyileştirmeden role özgü talimatlara. Bir sonraki kodlama oturumunuzda uygulayabileceğiniz pratik teknikler.
Bir insan geliştiriciden 'giriş sayfası yap' dediğinizde açıklayıcı sorular sorar: hangi kimlik doğrulama sağlayıcı? Hangi alanlar? OAuth yönetmeli mi? Hata mesajları? Yükleme durumları?
Yapay zeka kodlama ajanları tüm bu soruları kendileri yanıtlamaya çalışır. Bazen doğru tahmin ederler. Çoğu zaman mantıklı ama istediğiniz olmayan bir şey üretirler. 'Mantıklı' ile 'tam istenen' arasındaki farkı prompt mühendisliği kapatır.
İyi promptların uzun olması gerekmez. Önemli şeyler hakkında spesifik, önemli olmayanlar hakkında sessiz olmaları gerekir. Bu denge bu kılavuzun konusudur.
Görevden bağımsız olarak sonuçları iyileştiren kalıplar.
'React bileşeni oluştur, sonra state ekle, sonra stil ekle' demek yerine son sonucu tanımlayın: 'Proje adlarını gösteren, sürükle-yeniden sıralamayı destekleyen ve mevcut Tailwind temamızı kullanan katlanabilir kenar çubuğu yap.' Ajanın oraya nasıl ulaşacağına karar vermesine izin verin.
Avoid
Bir bileşen oluştur. useState ekle. Bir toggle düğmesi ekle. Tailwind ile stillendir.
Better
Projeleri ada göre listeleyen katlanabilir kenar çubuğu bileşeni yap. Sürükle-yeniden sıralamayı desteklemeli ve koyu temamıza (bg-[#111318], border-[#262b38]) uymalı. Katlanmış durum sayfa yenilemelerinde kalıcı olmalı.
Ajanlar sınırları bildiğinde en iyi çalışır. Hangi dosyalara dokunulacağını (veya kaçınılacağını), hangi kalıpların izleneceğini ve 'tamamlandı'nın nasıl görüneceğini belirleyin. Sınırsız görevler incelemesi zor yaygın değişikliklere yol açar.
Avoid
Kimlik doğrulama sistemini yeniden yapılandır.
Better
src/api/auth/login.ts'deki giriş işleyicisini parola hashleme için sha256 yerine bcrypt kullanacak şekilde yeniden yapılandır. JWT mantığı veya oturum çerez yönetimini değiştirme. tests/auth/ içindeki ilgili testleri güncelle.
Claude Code proje dosyalarınızı okuyabilir ama zihninizi okuyamaz. Uyduğunuz bir kural, tercih ettiğiniz bir kütüphane veya zaten oluşturduğunuz bir kalıp varsa söyleyin. Bu, yeniden çalışmadan tasarruf sağlar.
Avoid
Form doğrulama ekle.
Better
Kayıt formuna zod kullanarak form doğrulama ekle (zaten ayarlar formu için src/forms/settings.ts'de kullanıyoruz). Her alanın altında satır içi hata mesajları göster. Giriş formundaki aynı hata stillendirmesini takip et.
Bileşik promptlar ('API'yi yap, testleri yaz, dokümanları güncelle ve dağıt') ajanı aynı anda çok fazla hedef tutmaya zorlar. Karmaşık işi sıralı, odaklı görevlere bölen. Her biri bir önceki sonucun üzerine inşa eder.
Avoid
Kullanıcı profil sayfasını yap, API endpoint'lerini yaz, testler ekle, README'yi güncelle ve ara sıra nav bar'ı da düzelt.
Better
GET /api/user/profile endpoint'ini oluştur. id, name, email ve plan alanlarını döndür. Kimlik doğrulama için mevcut auth middleware'i kullan.
İlk sonuç doğru değilse baştan başlamak yerine promptu iyileştirin. Claude tam konuşma bağlamını korur. Neyin yanlış olduğunu, neyin değişmesi gerektiğini ve neyin kalmasını istediğinizi söyleyin. Yineleme yeniden icat etmekten daha hızlıdır.
Avoid
Yanlış. Baştan başla ve bileşeni farklı şekilde yap.
Better
Düzen iyi ama mobil kırılma noktası yanlış. 768px altında kartları ızgara yerine dikey olarak istifle. Geri kalan her şeyi olduğu gibi bırak.
Sistem promptları, siz bir şey söylemeden önce ajanın temel davranışını belirler. Yapay zeka kodlamadaki en az kullanılan araçtır.
Sistem promptu ajana kim olduğunu, neye odaklanması gerektiğini ve nelerden kaçınması gerektiğini söyler. Oturumdaki her mesaja uygulanır. Ajanın görev tanımı olarak düşünün.
AgentsRoom 14 role özgü sistem promptuyla gelir: her ajan tipi için bir tane. Frontend ajanının promptu bileşenlere, erişilebilirliğe ve duyarlı tasarıma odaklanmasını söyler. QA ajanının promptu sınır durumları hakkında düşünmesini ve kapsamlı testler yazmasını söyler. Bunları özelleştirebilir veya kendinizinkini yazabilirsiniz.
Kıdemli frontend geliştiricisiniz. React bileşenlerine, CSS/Tailwind stillendirmesine, erişilebilirliğe (WCAG AA) ve duyarlı tasarıma odaklanın. Yeni bileşenler oluşturmadan önce projenin mevcut bileşen kütüphanesini kullanın. Kalıtım yerine bileşimi tercih edin. Semantik HTML yazın. Backend dosyalarını asla değiştirmeyin.
En etkili prompt bir sohbete yazılmaz. Deponuzda yaşar.
CLAUDE.md, projenizin kökünde bulunan ve Claude Code'un otomatik okuduğu bir markdown dosyasıdır. Projedeki her ajan oturumuna uygulanan proje yapısı, kurallar, yığın ayrıntıları ve yönergeler içerir.
Her konuşmada 'Tailwind CSS 4, Prisma ORM ve Next.js 16 kullanıyoruz' demek yerine CLAUDE.md'ye bir kez yazın. Her ajan bu bağlamı devralır. AgentsRoom, uygulamadan çıkmadan CLAUDE.md'yi güncelleyebilmeniz için yerleşik editörle gelir.
İyi yazılmış bir CLAUDE.md düzinelerce özenle hazırlanmış bireysel prompttan daha değerlidir. Birikmeli etki yapar: her oturum bundan faydalanır.
Aynı talimatları tekrar tekrar yazmayı bırakın. İşleyeni kaydedin ve yeniden kullanın.
Projeler genelinde aynı tür istekleri yazdığınızı görüyorsanız ('bu dosya için birim testleri yaz', 'bunu repository kalıbına uyarla', 'tüm API rotalarına hata yönetimi ekle') yeniden kullanılabilir prompt olarak kaydedin.
AgentsRoom iki düzeyli prompt kütüphanesi özelliği içerir: projeye özgü görevler için proje düzeyinde promptlar ve her yerde kullandığınız kalıplar için global promptlar (bulut senkronizasyonlu).
Kütüphane promptları için iyi adaylar: kod inceleme kontrol listeleri, test yazma şablonları, taşıma betikleri, bileşen iskelesi talimatları, güvenlik denetim adımları. Bir ekip vikisine standart prosedür olarak koyacağınız her şey.
[dosya] için birim testleri yaz. vitest kullan. Mutlu yolu, sınır durumlarını (boş girdi, null, geçersiz tipler) ve hata yönetimini kapsa. Dış bağımlılıkları mockla. >%90 dal kapsamını hedefle.
Mevcut git diff'indeki değişiklikleri incele. Kontrol et: kullanılmayan importlar, eksik hata yönetimi, tip güvenliği sorunları, potansiyel yarış koşulları ve adlandırma tutarsızlıkları. Bulunan her sorun için düzeltme öner.
[kaynak] için REST endpoint oluştur. zod ile girdi doğrulaması, uygun hata yanıtları (400, 401, 404, 500), istek/yanıt için TypeScript tipleri ve endpoint'i tanımlayan JSDoc yorumu ekle. src/api/ içindeki mevcut kalıbı takip et.
Tek promptların ötesine geçen karmaşık görevler için teknikler.
Büyük bir görevi sıralı adımlara bölen. İlk ajanını birinci adımla başlatın, tamamlanmasını bekleyin, sonra bir sonraki ajanı ikinci adımla başlatın (birinci adımın çıktısına referansla). Her adım daha küçük ve daha odaklıdır. Örnek: Ajan 1 veritabanı şemasını tasarlar, Ajan 2 bu şemayı kullanan API'yi yazar, Ajan 3 API'ye karşı testler yazar.
Bir ajan bitirdikten sonra farklı bir ajanı çıktısına yönlendirin. 'Frontend ajanının src/components/ içinde yaptığı değişiklikleri incele. Erişilebilirlik sorunlarına ve eksik hata durumlarına bak.' Farklı role sahip yeni bir ajan, orijinal ajanın kaçırdıklarını yakalar.
Ajanın soruna nasıl yaklaştığını görmek için gevşek bir promptla başlayın. Sonra takip mesajlarında kısıtlamalar ekleyin: 'Yapı iyi ama istemci bileşenleri yerine sunucu bileşenleri kullan.' 'Hook'u koru ama useEffect'i kaldır ve React Query mutation kullan.' Her yineleme istediğiniz çözüme doğru daraltır.
Ajanı mevcut koda yönlendirin: 'src/pages/profile.tsx ile aynı kalıbı izleyerek ayarlar sayfası yap. Aynı düzen yapısı, aynı form yönetimi, aynı hata görüntülemesi.' Bu genellikle kalıbı kelimelerle tanımlamaktan daha etkilidir.
Tutarlı olarak daha kötü sonuçlar üreten kalıplar.
Ajana tam olarak hangi fonksiyonları yazacağını, hangi değişkenleri adlandıracağını ve hangi sırada uygulayacağını söylemek. Bu mikro yönetim ajanın daha iyi yaklaşım bulma yeteneğini ortadan kaldırır. Prosedürü değil sonucu tanımlayın.
Ajandan kısıtlama olmadan 'kod tabanını iyileştir' istemek. Sınırlar olmadan ajan dokunmak istemediğiniz dosyaları yeniden yapılandırabilir, diğer kodun bağımlı olduğu API'leri değiştirebilir veya düşük öncelikli iyileştirmelere token harcayabilir.
Projede zaten bir kalıp, araç veya bileşen bulunduğunu belirtmemek. Ajan yeni bir tane oluşturur. Basit bir 'src/hooks/'da zaten bir useAuth hook'umuz var' ciddi yeniden çalışmadan tasarruf sağlar.
Beş görevi tek mesaja sığdırmak. Ajan hepsini deneyecek ama yarışan hedeflerle başa çıkarken kalite düşer. Bunları sıralı, odaklı isteklere bölün.
Artık asıl darboğaz kod yazmak değil, iletişim. Claude, Codex, Antigravity ve Grok Build ile nasıl konuşursanız o kadar hızlı, o kadar az token harcayarak sonuca ulaşırsınız.
PDF'leri doğrudan Claude'a ya da herhangi bir LLM'e vermek sessizce token tüketir: her sayfa aynı zamanda görüntüye de dönüştürülür. Dosyayı önce Microsoft'un ücretsiz açık kaynak aracı MarkItDown ile Markdown'a çevirin ve token faturanızı %80'e varan oranda azaltın. CLI, Python ve MCP kurulumuyla eksiksiz rehber.
AgentsRoom size yerleşik sistem promptları, prompt kütüphanesi ve CLAUDE.md düzenleme sunar. Prompt hazırlama için daha az zaman, geliştirme için daha fazla zaman.
Yardımcı uygulama: hareket halindeyken ajanlarınızı izleyin
Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.
Hataları ve istekleri doğrudan genel backlogunuza gönderin.