# ai Kuralları - Pezkuwi SDK

Bu dosya her oturumda ai tarafından okunmalı ve kurallara kesinlikle uyulmalıdır.

---

## ANA HEDEF

**Rebrand edilmiş Pezkuwi SDK projesinin `cargo check` komutundan `Finished` çıktısı alması.**

Bu hedef iki parçadan oluşur:
1. Rebrand tamamlanmış olmalı (tüm eski terimler yeni terimlerle değiştirilmiş)
2. Proje derlenebilir durumda olmalı (cargo check Finished)

**HER İKİ KOŞUL DA SAĞLANMALI. BİRİ DİĞERİ İÇİN FEDAKARİLİK EDİLEMEZ.**

---

## DEĞİŞMEZ KURALLAR - ASLA YAPMA

### 1. Rebrand'i Geri Alma Yasağı
- **ASLA** rebrand edilmiş kodu eski haline döndürme
- **ASLA** cargo check hataları için isim değişikliklerini geri alma
- **ASLA** "çalışsın diye" terminolojiyi bozma
- **ASLA** pezkuwi → pezkuwi, bizinikiwi → bizinikiwi gibi geri dönüşüm yapma

### 2. Terminoloji Koruma
Aşağıdaki dönüşümler kalıcıdır ve geri alınamaz:

| Eski (KULLANMA) | Yeni (KULLAN) |
|-----------------|---------------|
| polkadot | pezkuwi |
| Polkadot | Pezkuwi |
| substrate | bizinikiwi |
| Substrate | Bizinikiwi |
| cumulus | pezcumulus |
| Cumulus | Pezcumulus |
| westend | zagros |
| Westend | Zagros |
| rococo | pezkuwichain |
| Rococo | Pezkuwichain |
| parachain | teyrchain |
| Parachain | Teyrchain |
| paritytech | pezkuwichain |
| frame- | pezframe- |
| pallet- | pezpallet- |
| sp- | pezsp- |
| sc- | pezsc- |

### 3. Hata Çözme Yaklaşımı
Cargo check hatası aldığında:
- **DOĞRU:** Hatayı rebrand'e uygun şekilde düzelt (yeni terminoloji kullan)
- **YANLIŞ:** Rebrand'i geri alarak hatayı "çöz"

Örnek:
```
Hata: pezsp_runtime bulunamadı
DOĞRU: pezsp_runtime modülünü/import'unu düzelt
YANLIŞ: pezsp_runtime'a geri dön
```

---

## ÇALIŞMA PRENSİPLERİ

### 1. Checkpoint Sistemi
- Her büyük işlemden önce git commit yap
- Her hata düzeltmesinde "ne yaptım" raporu ver
- Geri dönüşü olmayan değişiklikler için onay iste

### 2. Audit Trail
- Değişiklik yapılan dosyaları listele
- Her oturum sonunda özet rapor sun

### 3. Şeffaflık
- Yapılan her değişikliği kullanıcıya bildir
- Varsayımda bulunma, sor
- Kısayol arama, doğru yolu izle

---

## YASAK DAVRANIŞLAR

1. Kullanıcının talimatı olmadan rebrand'i geri alma
2. "Derleme için gerekli" bahanesiyle terminolojiyi bozma
3. Uzun süren hatalar için "kolay çözüm" olarak geri dönüş yapma
4. Commit mesajına ai imzası ekleme
5. Test etmeden commit/push yapma

---

## HATA DURUMUNDA

Eğer cargo check 100+ hata veriyorsa:
1. Panik yapma
2. Hataları kategorize et
3. Sistematik olarak düzelt (rebrand'e uygun)
4. Her 10-20 hata düzeltmesinde ara commit yap
5. İlerlemeyi kullanıcıya bildir

**ASLA "çok fazla hata var, rebrand'i geri alayım" deme.**

---

## REFERANS: REBRAND_MAP

Tam crate isim değişiklikleri için `/home/mamostehp/pezkuwi-sdk/REBRAND_PROGRESS.md` dosyasına bak.
Terminoloji kılavuzu için `.ai/TERMINOLOGY.md` dosyasına bak.

---

*Bu kurallar Kurdistan Tech Institute tarafından belirlenmiştir ve kesinlikle uyulmalıdır.*
