/focused-fix

5 aşamalı protokolü kullanarak bir özelliği veya modülü sistematik olarak onarın. Hedef: $ARGUMENTS (bir özellik yolu veya modül adı).

Eğer $ARGUMENTS boşsa, kullanıcıdan hangi özelliği/modülü düzeltmek istediğini sorun.

Protokol — TÜM 5 Aşamayı SIRASI İLE Uygulayın

Aşama 1: KAPSAM — Özellik Sınırını Haritalayın

1. Hedef özelliğin birincil klasörünü/dosyalarını belirleyin
2. O klasördeki HER dosyayı okuyun — amacını anlayın
3. Bir özellik manifestosu oluşturun:

FEATURE SCOPE:
  Primary path: <path>
  Entry points: [uygulamanın diğer bölümleri tarafından import edilen dosyalar]
  Internal files: [sadece bu özellik içinde kullanılan dosyalar]
  Total files: N

Aşama 2: İZLE — Tüm Bağımlılıkları Haritalayın

GELEN (bu özelliğin import ettiği şeyler):

• Her import statement'ı için kaynağı izleyin, var olduğunu ve export edildiğini doğrulayın
• Çevre değişkenlerini, config dosyalarını, DB modellerini, API endpoint'lerini, üçüncü taraf paketlerini kontrol edin

GIDEN (bu özelliği import eden şeyler):

• Tüm kod tabanında bu özellikten import aramalarını yapın
• Tüketicilerin doğru API/interface kullandığını doğrulayın

Gelen, giden, çevre değişkenleri ve config dosyalarını içeren bir bağımlılık haritası çıktısı alın.

Aşama 3: TANI KOY — Her Sorunu Bulun

TÜM tanı kontrolleri çalıştırın:

• Kod: import'lar çözülüyor, dairesel dependency yok, tipler tutarlı, hata yönetimi, TODO/FIXME
• Çalışma Zamanı: çevre değişkenleri ayarlandı, migrasyonlar güncel, API şekilleri doğru
• Testler: TÜM ilişkili testleri çalıştırın, hataları kaydedin, kapsama kontrolü yapın
• Loglar: git log'da son değişiklikleri kontrol edin, hata loglarını arayın
• Config: config dosyalarını doğrulayın, dev/prod uyuşmazlıklarını kontrol edin

Bulunan her sorun için:

• Düzeltme listesine eklemeden önce kanıtla kök sebebi onaylayın
• Risk ata: HIGH (public API, auth, >3 çağrı yapan) / MED (test ile dahili) / LOW (yaprak modül)

Sorunları önem düzeyine göre gruplandıran bir tanı raporu çıktısı alın.

Aşama 4: ONAR — Sistematik Olarak Düzeltin

Bu tam sırada düzeltin:

1. Bağımlılıklar — kırık import'lar, eksik paketler
2. Tipler — sınırlardaki tür uyuşmazlıkları
3. Mantık — iş mantığı hataları
4. Testler — her düzeltme için testleri düzeltin veya oluşturun
5. Entegrasyon — tüketicilerle uçtan uca doğrulayın

Kurallar:

• BİR sorunu bir seferde düzeltin, sonra ilgili testi çalıştırın
• Bir düzeltme başka bir şeyi kırarsa → TANI KOY'a geri dönün
• HIGH'ı MED'den, MED'i LOW'dan önce düzeltin
• 3-Strike Kuralı: 3 veya daha fazla düzeltme YENİ sorun oluşturursa, DURUN. Kullanıcıya mimarinin yamama değil, yeniden düşünülmesi gerekebileceğini söyleyin.

Aşama 5: DOĞRULA — Her Şeyin Çalıştığını Onaylayın

1. Özellik klasöründeki TÜM testleri çalıştırın
2. Bu özellikten import yapan dosyalardaki TÜM testleri çalıştırın
3. Varsa tam test paketi çalıştırın
4. Yapılan tüm değişiklikleri özetleyin

Değiştirilen dosyalar, uygulanan düzeltmeler, test sonuçları ve doğrulanan tüketiciler ile bir tamamlama raporu çıktısı alın.

Demir Yasa

KAPSAM → İZLE → TANI KOY'u BİTİRMEDEN ONARIM YOK

Aşama 3'ü bitirmediyseniz, düzeltme öneremezsiniz.

İlişkili Beceriler

• engineering/focused-fix — Ayrıntılı kontrol listeleri, çıktı şablonları ve anti-pattern'ler ile tam SKILL.md
• superpowers:systematic-debugging — Aşama 3 sırasında bulunan bireysel karmaşık hatalar için