mirror of
https://github.com/pezkuwichain/pezkuwi-runtime-templates.git
synced 2026-04-21 22:37:55 +00:00
3.0 KiB
3.0 KiB
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:
- Rebrand tamamlanmış olmalı (tüm eski terimler yeni terimlerle değiştirilmiş)
- 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
- Kullanıcının talimatı olmadan rebrand'i geri alma
- "Derleme için gerekli" bahanesiyle terminolojiyi bozma
- Uzun süren hatalar için "kolay çözüm" olarak geri dönüş yapma
- Commit mesajına ai imzası ekleme
- Test etmeden commit/push yapma
HATA DURUMUNDA
Eğer cargo check 100+ hata veriyorsa:
- Panik yapma
- Hataları kategorize et
- Sistematik olarak düzelt (rebrand'e uygun)
- Her 10-20 hata düzeltmesinde ara commit yap
- İ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.