Prompt Mühendisliği

Daha İyi Promptlar. Daha İyi Kod.

Yapay zeka üretimi kodun kalitesi neredeyse tamamen ne istediğine ve nasıl istediğine 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 oturumunda uygulayabileceğin pratik teknikler.

Prompt Mühendisliği Kod İçin Neden Önemli

Bir insan geliştiriciden 'giriş sayfası yap' dediğinde 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ğin 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.

Beş Temel Prensip

Görevden bağımsız olarak sonuçları iyileştiren kalıplar.

1

Adımlar Değil Sonuçlar Hakkında Spesifik Ol

'React bileşeni oluştur, sonra state ekle, sonra stil ekle' demek yerine son sonucu tanımla: '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 ver.

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ı.

2

İşi Net Olarak Kapsamın

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 belirle. 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.

3

Önemli Bağlamı Sağla

Claude Code proje dosyalarını okuyabilir ama zihnini okuyamaz. Uyduğun bir kural, tercih ettiğin bir kütüphane veya zaten oluşturduğun bir kalıp varsa söyle. 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.

4

Prompt Başına Tek Görev

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.

5

Yeniden Başlatma Yerine Yinele

İlk sonuç doğru değilse baştan başlamak yerine promptu iyileştir. Claude tam konuşma bağlamını korur. Neyin yanlış olduğunu, neyin değişmesi gerektiğini ve neyin kalmasını istediğini söyle. 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ı: Kalıcı Bağlam

Sistem promptları, sen 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.

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 kendininkini yazabilirsin.

Örnek: Frontend Ajanı Sistem Promptu

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.

Etkili Sistem Promptları Yazma

  • ✓Rolü ve sınırlarını tanımla. Ajan neye odaklanmalı? Neyi görmezden gelmeli?
  • ✓Belirli teknolojileri ve sürümleri belirt. 'Server Components ile React 19', 'modern React'tan daha iyidir.
  • ✓Proje kurallarına referans ver. 'State için Zustand kullan', ajana Redux veya Context'e yönelmemesini söyler.
  • ✓Kalite beklentileri belirle. 'Strict mode ile TypeScript yaz, any tipi yok' kısayolları önler.
  • ✓Olumsuz kısıtlamalar ekle. '/api/ içindeki dosyaları asla değiştirme' ajanı kendi şeridinde tutar.

CLAUDE.md: Proje Düzeyinde Bağlam

En etkili prompt bir sohbete yazılmaz. Deponda yaşar.

CLAUDE.md, projenin 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. Her ajan bu bağlamı devralır. AgentsRoom, uygulamadan çıkmadan CLAUDE.md'yi güncelleyebilmen 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.

Prompt Kütüphanesi Oluştur

Aynı talimatları tekrar tekrar yazmayı bırak. İşleyeni kaydet ve yeniden kullan.

Projeler genelinde aynı tür istekleri yazdığını görüyorsan ('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 kaydet.

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 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 her şey.

Prompt Kütüphanesi Örnekleri

Birim Test Yaz

[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.

Kod İnceleme

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.

API Endpoint

[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.

İleri Düzey Kalıplar

Tek promptların ötesine geçen karmaşık görevler için teknikler.

Prompt Zincirleme

Büyük bir görevi sıralı adımlara bölen. İlk ajanını birinci adımla başlat, tamamlanmasını bekle, sonra bir sonraki ajanı ikinci adımla başlat (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.

Çapraz Ajan İnceleme

Bir ajan bitirdikten sonra farklı bir ajanı çıktısına yönlendir. '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.

Aşamalı Kısıtlamalar

Ajanın soruna nasıl yaklaştığını görmek için gevşek bir promptla başla. Sonra takip mesajlarında kısıtlamalar ekle: '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ğin çözüme doğru daraltır.

Referans Uygulama

Ajanı mevcut koda yönlendir: '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.

Yaygın Hatalar

Tutarlı olarak daha kötü sonuçlar üreten kalıplar.

Uygulamayı Aşırı Belirleme

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ımla.

Kapsam Sınırı Yok

Ajandan kısıtlama olmadan 'kod tabanını iyileştir' istemek. Sınırlar olmadan ajan dokunmak istemediğin 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.

Mevcut Kodu Görmezden Gelme

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.

Bileşik Mega Promptlar

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.

Kodlama promptu ne kadar uzun olmalı?
Çoğu etkili kodlama promptu 2 ile 5 cümle arasındadır. Sonucu, kapsamı ve temel kısıtlamaları belirtmeye yetecek kadar uzun. Ajanın detaylarda kaybolmayacağı kadar kısa. Promptun tam bir paragrafsa, o bağlamın bir kısmının CLAUDE.md veya sistem promptuna ait olup olmadığını düşün.
Opus ve Sonnet için promptları farklı yazmalı mıyım?
Biraz. Opus belirsizliği daha iyi yönetir ve daha az bağlamdan niyet çıkarabilir. Sonnet daha açık talimatlardan ve daha net kapsam sınırlarından faydalanır. Her iki model için de beklenen sonuç hakkında spesifik olmak sonuçları iyileştirir.
AgentsRoom prompt mühendisliğine nasıl yardımcı olur?
Üç yolla: 14 ajan tipinin her biri için yerleşik role özgü sistem promptları, etkili promptları kaydetmek ve yeniden kullanmak için prompt kütüphanesi ve proje düzeyinde bağlam için CLAUDE.md editörü. Bu katmanlar temel bağlam zaten iyi olduğu için bireysel mesajlar hazırlama için daha az zaman harcanmanı sağlar.
Promptları bir ekip genelinde paylaşabilir miyim?
Evet. AgentsRoom promptlarını hesabında tutar: proje başına bir kütüphane, artı her projede kullanılabilen bir Genel kütüphane; ikisi de makinelerin ve mobil uygulama arasında senkronize edilir ve çevrimdışı çalışma için yerel bir önbellek bulunur. Kişisel promptları yalnızca sen görürsün ve depoya hiçbir şey commit edilmez.
Sistem promptu ile CLAUDE.md arasındaki fark nedir?
CLAUDE.md, her ajanın otomatik okuduğu proje bağlamıdır: yığın, yapı, kurallar. Sistem promptları ajana özgü davranışsal talimatlardır: rol, odak alanları, kısıtlamalar. Birbirini tamamlarlar. CLAUDE.md 'bu proje Next.js 16 ve Prisma kullanır' der. Sistem promptu 'API rotalarına odaklanan backend geliştiricisiniz' der.

Konuyla ilgili yazılar

Daha İyi Promptlar Yaz, Daha İyi Kod Gönder

AgentsRoom sana 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.

macOS ve Linux İçin İndirÜcretsiz

Yardımcı uygulama: hareket halindeyken ajanlarını izle

Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.

Hataları ve istekleri doğrudan genel backloguna gönder.