# Clarity and Specificity: From Vague to Surgical Prompts

> Source: https://sukruyusufkaya.com/en/learn/claude-ustaligi/aciklik-ve-spesifiklik
> Updated: 2026-05-13T09:12:49.419Z
> Category: Claude Ustalığı
> Module: 2. Prompt Engineering Foundations
**TLDR:** Vague prompts produce vague answers. Learn to surface the true intent under fuzzy requests and acquire surgical specificity.

> **Tek bir kural**
>
> Bir AI'a verdiğin prompt'u **bir stajyere e-posta** olarak yaz. Stajyer 'bu ne demek?' sorusunu soracak mı? Sorarsa, prompt'un eksik.

# Belirsizlik Vergisi

Belirsiz bir prompt çift bedel ödetir:

1. **Tahmin maliyeti:** Claude eksik bilgileri tahmin eder, çoğu zaman yanlış.
2. **Düzeltme maliyeti:** İlk cevabı senin beklentine uydurmak için ek mesajlar gerekir.

Yani aslında "kısa prompt" yazarak hız kazandığını sanırken, üç-beş tur düzeltmeye girer ve toplamda daha çok zaman / token harcarsın.

### Belirsiz: ⚠️
"Müşteri verisini analiz et"

---

### Spesifik: ✅
"Aşağıdaki CSV'de son 90 günlük abonelik
verisi var. Şu üçünü çıkar:

1) Aylık churn oranı (%) — ay-ay tablo
2) En çok churn eden 3 kohort (ülke, plan,
   kanal eksenlerinden hangisinde fark
   istatistiksel anlamlıysa)
3) İki cümlelik yönetici özeti

Format: tablolar Markdown, özet ayrı paragraf.
Hesaplamaları code interpreter'ı kullanarak doğrula.
Yanlış olabilecek tüm varsayımları sonda listele."

### Anti-pattern 1: Görüşülmesi gereken şeyleri varsaymak

"Sunum hazırla" gibi cümlelerde model **kim için, kaç slayt, hangi tarz** sorularını boşluğa karşı tahmin eder. Çoğu zaman yanlış tahmin yapar. Çözüm: ya bilgi ver ya da Claude'a "şu üç bilgi olmadan başlama" diyerek soru sordur.

### Anti-pattern 2: Çoklu görevi tek cümleye sıkıştırmak

"Bunu refactor et, test yaz, README oluştur, deploy script'i hazırla" → tek mesajda dört iş. Cevap dağınık ve eksik olur. Bunu **birden fazla turda** ya da listeli format ve numaralı çıktı talebiyle yap.

### Anti-pattern 3: Negatif komutlar tek başına

"Yanlış cevap verme" → modele ne yapmaması gerektiğini söyler ama ne yapması gerektiğini söylemez. Onun yerine: "Emin değilsen 'bilmiyorum' yaz ve hangi bilgiyi doğrulamamız gerektiğini listele."

### Anti-pattern 4: Çıktı formatını sona bırakmak

"Şunu analiz et... ve ha bir de tablo olsun" → model serbest yazıma başlar, sonradan formata sığdıramaz. Format **prompt'un başında**, hatta öncesinde sistem prompt'unda olmalı.

## Spesifiklik Kontrol Listesi

Bir prompt'u göndermeden önce şu 7 sorudan geç:

1. **Kim:** Hedef kitle / kullanıcı kim?
2. **Ne:** Tam olarak hangi çıktı isteniyor?
3. **Neden:** Bu çıktı hangi karara hizmet ediyor?
4. **Nasıl:** Hangi yöntem / yaklaşım?
5. **Hangi sınırlarda:** Uzunluk, dil, ton, mevzuat?
6. **Hangi formatta:** Markdown, JSON, tablo, prose?
7. **Başarı kriteri:** Çıktı 'iyi' sayılır mı?

Bu 7 soruya cevap veremiyorsan prompt henüz hazır değil.

```text
# Spesifiklik kontrol listesi şablonu

<task>...</task>

<audience>...</audience>

<purpose>Bu çıktı hangi karara hizmet edecek?</purpose>

<constraints>
- Uzunluk: ...
- Ton: ...
- Mevzuat / kısıtlama: ...
</constraints>

<format>
- ...
</format>

<success_criteria>
- ...
- ...
</success_criteria>
```

## Mini egzersiz: Belirsiz prompt'u dönüştür
Aşağıdaki Python parçası bir 'belirsizlik skoru' tahmin eder. Sezgisel ama eğitici. Düşük skorlu prompt'lar genelde daha iyi cevap döndürür.

```python
def fuzziness_score(prompt: str) -> int:
    fuzzy_words = ["güzel", "iyi", "düzgün", "akıllı", "uygun", "bir şekilde"]
    score = 0
    for w in fuzzy_words:
        score += prompt.lower().count(w)
    if "format" not in prompt.lower():
        score += 2
    if len(prompt) < 60:
        score += 3
    return score

ornek = "Müşteri için iyi bir e-posta yaz"
print("Fuzziness:", fuzziness_score(ornek))   # yüksek

ornek2 = """Kıdemli SaaS satış koçusun. 50-200 kişilik
firmaların CFO'larına 120 kelime, profesyonel ton, tek CTA
ile soğuk satış e-postası yaz. Format: konu + 3 paragraf."""
print("Fuzziness:", fuzziness_score(ornek2)) # düşük
```

**Boşluk doldurma egzersizi (text):**
```text
Belirsiz prompt'lar _____ vergisi yaratır. Spesifiklik için 7 soruyu kontrol etmeliyiz: kim, ne, _____ , nasıl, kısıtlar, _____ , başarı kriteri.
```

**Sıralama egzersizi:**
- `Talebin altındaki gerçek niyeti tanımla`
- `Hedef kitle ve kararı yaz`
- `Format ve uzunluk gibi kısıtları belirt`
- `Başarı kriterini iki cümleyle yaz`
- `Prompt'u 7-soru filtresinden geçir`

> **Köprü cümlesi**
>
> Eksik bilgi varsa Claude'a şu cümleyi ekleyebilirsin: "Cevap vermeden önce, başarılı bir çıktı için sana sormam gereken eksik bilgi varsa beni durdur ve sor." Claude eksik bilgiyi doğru biçimde çıkarmak için bunu kullanır.

> ✋ Kontrol noktası: `q-202-mc1`