tdd

Files (1)

• SKILL.md

SKILL.md (first lines)

# Test Güdümlü Geliştirme (TDD)

Önce testi yaz. Fail ettiğini izle. Geçmesi için minimal kodu yaz.

**Temel ilke:** Testin fail ettiğini izlemediysen, doğru şeyi test ettiğini bilemezsin.

## Demir Kural

```
ÖNCE FAIL EDEN TEST OLMAYAN ÜRETİM KODU YOK
```

Kodu testten önce mi yazdın? Sil. Baştan başla.

## Kırmızı-Yeşil-Refactor

### KIRMIZI — Başarısız testi yaz
- Tek davranış, net isim, gerçek kod (zorunlu değilse mock yok)

### KIRMIZI doğrula — Fail'i izle (asla atlanmaz)
```bash
pytest tests/dosya.py::test_adi -v
```
- Test FAIL olmalı (hata değil)
- Başarısızlık mesajı beklenen olmalı
- Özellik eksik olduğu için fail etmeli (yazım hatası değil)

### YEŞİL — Minimal kod
Testi geçiren en basit kod. Testin ötesinde özellik/refactor/iyileştirme yok.

### YEŞİL doğrula — PASS'i izle (zorunlu)
```bash
pytest tests/dosya.py::test_adi -v
```
- Test geçer, diğer testler hâlâ geçer, çıktı temiz

### REFACTOR — Temizlik (sadece yeşilden sonra)
- Duplikasyonu kaldır, isimleri iyileştir, helper çıkar
- Testler yeşil kalmalı, davranış değişmez

### Tekrarla
Sıradaki özellik için sıradaki test.

## Neden Sıra Önemli

Koddan sonra yazılan test anında geçer; anında geçmek hiçbir şey kanıtlamaz. Test-önce, testin gerçekten bir şeyi test ettiğini kanıtlamak için fail'i görmeye zorlar.

## Sık Mazeretler ve Gerçek

| Mazeret | Gerçek |
|---|---|
| "Test etmek için çok basit" | Basit kod da bozulur. Test 30 saniye sürer. |
| "Sonra test yazarım" | Anında geçen test hiçbir şey kanıtlamaz. |
| "Zaten manuel test ettim" | Ad-hoc kayıt bırakmaz, tekrar çalışmaz. |
| "X saatlik işi silmek israf" | Batık maliyet. Doğrulanmamış kod teknik borçtur. |
| "TDD beni yavaşlatır" | TDD debug'tan hızlıdır. |

## Uyarı İşaretleri — DUR ve Baştan Başla

- Koddan önce test yazılmadı
- Test implementasyondan sonra yazıldı
- Test anında geçti
- "Sadece bu seferlik" mazereti
- Test neden fail ettiği açıklanamıyor

## Hata Düzeltme Entegrasyonu

Bug mı buldun? Onu üreten başarısız bir test yaz. TDD döngüsünü uygula. Test, düzeltmeyi kanıtlar ve regresyonu önler. Testsiz bug düzeltmesi asla yapma.

## Son Kural

```
Üretim kodu → önce test var ve fail etti
Aksi hâlde → bu TDD değil
```

From murataslan1/kamuyz-agent-starter, MIT.

More from murataslan1/kamuyz-agent-starter