systematic-debugging

Files (1)

• SKILL.md

SKILL.md (first lines)

# Sistematik Hata Ayıklama

Rastgele düzeltmeler zaman kaybettirir ve yeni bug üretir. Hızlı yamalar asıl sorunu maskeler.

**Temel ilke:** Düzeltme denemeden ÖNCE her zaman kök nedeni bul. Belirti düzeltmesi başarısızlıktır.

## Demir Kural

```
ÖNCE KÖK NEDEN ARAŞTIRMASI, SONRA DÜZELTME
```

1. Fazı tamamlamadıysan düzeltme öneremezsin.

## Dört Faz

### Faz 1: Kök Neden Araştırması (düzeltmeden ÖNCE)

1. **Hata mesajlarını dikkatle oku** — tam stack trace, satır numaraları, hata kodları. Atlamadan.
2. **Tutarlı çoğalt** — güvenilir tetikleyebiliyor musun? Kesin adımlar? Her seferinde mi?
3. **Son değişiklikleri kontrol et** — git diff, son commit'ler, yeni bağımlılıklar, yapılandırma.
4. **Çok bileşenli sistemlerde kanıt topla** — her bileşen sınırına giren/çıkan veriyi logla, ortam/yapılandırma yayılımını doğrula, her katmanda durumu kontrol et. Nerede koptuğunu göster.
5. **Veri akışını izle** — kötü değer nereden geliyor? Bunu kötü değerle kim çağırdı? Kaynağa kadar izle. Belirtide değil kaynakta düzelt.

### Faz 2: Örüntü Analizi

- Aynı kod tabanında çalışan benzer kodu bul
- Referans uygulamayı TAMAMEN oku (atlayarak değil)
- Çalışan ile bozuk arasındaki her farkı listele
- Bağımlılıkları anla: hangi bileşenler, ayarlar, varsayımlar gerekli

### Faz 3: Hipotez ve Test

- Tek hipotez kur ve yaz: "X kök nedendir çünkü Y"
- En küçük değişiklikle test et, tek değişken
- Çalışmadı mı? Yeni hipotez kur. Üstüne düzeltme ekleme.

### Faz 4: Uygulama

1. Başarısız test oluştur (en basit yeniden üretim — tdd skill)
2. TEK düzeltme uygula (kök neden; "madem buradayım" iyileştirmeleri yok)
3. Düzeltmeyi doğrula: test geçiyor mu? Başka test bozuldu mu?
4. 3+ düzeltme denendi ve her biri başarısız → DUR, mimariyi sorgula:
   - Temel örüntü sağlam mı? "Ataletle sürdürüyoruz" mu?
   - Düzeltmek yerine mimariyi refactor mu etmeli? İnsana danış.

## Kırmızı Bayraklar — DUR ve 1. Faza Dön

- "Şimdilik hızlı düzelt, sonra araştırırım"
- "X'i değiştirip oluyor mu bakayım"
- "Birden çok değişiklik ekleyip testleri çalıştırayım"
- "Testi atla, manuel doğrularım"
- Veri akışını izlemeden çözüm önermek

## Hızlı Referans

| Faz | Ana Faaliyet | Başarı Ölçütü |
|---|---|---|
| 1. Kök Neden | Hata oku, çoğalt, değişiklikleri kontrol et | NE ve NEDEN'i anlamak |
| 2. Örüntü | Çalışan örnekler bul, karşılaştır | Farkları belirlemek |
| 3. Hipotez | Teori kur, minimal test et | Onaylı ya da yeni hipotez |
| 4. Uygulama | Test yaz, düzelt, doğrula | Bug çözüldü, testler geçiyor |

## İlgili Skill'ler

- `tdd` — Faz 4 adım 1 için başarısız test yazma
- `verification-before-completion` — başarı iddia etmeden düzeltmeyi doğrulama

From murataslan1/kamuyz-agent-starter, MIT.

More from murataslan1/kamuyz-agent-starter