mirror of
https://github.com/pezkuwichain/pezkuwi-runtime-templates.git
synced 2026-04-22 03:17:56 +00:00
Update documentation and templates for Pezkuwi branding
This commit is contained in:
+112
@@ -0,0 +1,112 @@
|
||||
# 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.*
|
||||
Reference in New Issue
Block a user