Development (#172)

* docs: Add CLAUDE_RULES.md with strict rebrand protection rules

- Define immutable rebrand rules that cannot be violated
- Prohibit reverting rebrand for cargo check convenience
- Establish checkpoint and audit trail requirements
- Document correct error handling approach

* refactor: Complete kurdistan-sdk to pezkuwi-sdk rebrand

- Update README.md with pezkuwi-sdk branding
- Replace all kurdistan-sdk URL references with pezkuwi-sdk
- Replace kurdistan-tech with pezkuwichain in workflows
- Update email domains from @kurdistan-tech.io to @pezkuwichain.io
- Rename tool references: kurdistan-tech-publish → pezkuwi-publish
- Update runner names: kurdistan-tech-* → pezkuwichain-*
- Update analytics/forum/matrix domains to pezkuwichain.io
- Keep 'Kurdistan Tech Institute' as organization name
- Keep tech@kurdistan.gov as official government contact
This commit is contained in:
2025-12-19 23:30:43 +03:00
committed by GitHub
parent 2093647fea
commit 3680848df2
209 changed files with 496 additions and 454 deletions
+112
View File
@@ -0,0 +1,112 @@
# Claude Kuralları - Pezkuwi SDK
Bu dosya her oturumda Claude 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 → polkadot, bizinikiwi → substrate 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Ş: sp_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 Claude 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 `.claude/TERMINOLOGY.md` dosyasına bak.
---
*Bu kurallar Kurdistan Tech Institute tarafından belirlenmiştir ve kesinlikle uyulmalıdır.*