speccrew 0.5.9 → 0.5.11

package/docs/GETTING-STARTED.tr.md

@@ -1,4 +1,4 @@
-# SpecCrew - Hızlı Başlangıç Kılavuzu
+# SpecCrew Hızlı Başlangıç Kılavuzu
 
 <p align="center">
   <a href="./GETTING-STARTED.md">简体中文</a> |
@@ -11,23 +11,22 @@
   <a href="./GETTING-STARTED.it.md">Italiano</a> |
   <a href="./GETTING-STARTED.da.md">Dansk</a> |
   <a href="./GETTING-STARTED.ja.md">日本語</a> |
-  <a href="./GETTING-STARTED.ar.md">العربية</a> |
-  <a href="./GETTING-STARTED.tr.md">Türkçe</a>
+  <a href="./GETTING-STARTED.ar.md">العربية</a>
 </p>
 
-Bu belge, standart mühendislik süreçlerini takip ederek gereksinimlerden teslimata kadar tam geliştirme döngüsünü tamamlamak için SpecCrew Ajan ekibini nasıl kullanacağınızı hızlıca anlamanıza yardımcı olur.
+Bu belge, SpecCrew'ın Agent ekibini kullanarak standart mühendislik süreçlerine göre gereksinimlerden teslimata kadar tam geliştirmeyi nasıl tamamlayacağınızı hızlıca anlamanıza yardımcı olur.
 
 ---
 
 ## 1. Ön Koşullar
 
-### SpecCrew Kurulumu
+### SpecCrew'ı Yükle
 
 ```bash
 npm install -g speccrew
 ```
 
-### Projeyi Başlatma
+### Projeyi Başlat
 
 ```bash
 speccrew init --ide qoder
@@ -40,11 +39,11 @@ Desteklenen IDE'ler: `qoder`, `cursor`, `claude`, `codex`
 ```
 .
 ├── .qoder/
-│   ├── agents/          # Ajan tanım dosyaları
-│   └── skills/          # Beceri tanım dosyaları
-├── speccrew-workspace/  # Çalışma alanı
+│   ├── agents/          # Agent tanım dosyaları
+│   └── skills/          # Skill tanım dosyaları
+├── speccrew-workspace/  # Workspace
 │   ├── docs/            # Yapılandırmalar, kurallar, şablonlar, çözümler
-│   ├── iterations/      # Mevcut iterasyonlar
+│   ├── iterations/      # Devam eden iterasyonlar
 │   ├── iteration-archives/  # Arşivlenmiş iterasyonlar
 │   └── knowledges/      # Bilgi tabanı
 │       ├── base/        # Temel bilgiler (teşhis raporları, teknik borçlar)
@@ -55,21 +54,96 @@ Desteklenen IDE'ler: `qoder`, `cursor`, `claude`, `codex`
 ### CLI Komut Hızlı Başvurusu
 
 | Komut | Açıklama |
-|---------|-------------|
-| `speccrew list` | Mevcut tüm Ajanları ve Becerileri listele |
-| `speccrew doctor` | Kurulum bütünlüğünü kontrol et |
+|------|------|
+| `speccrew list` | Tüm mevcut Agent'ları ve Skill'leri listele |
+| `speccrew doctor` | Yükleme bütünlüğünü kontrol et |
 | `speccrew update` | Proje yapılandırmasını en son sürüme güncelle |
 | `speccrew uninstall` | SpecCrew'ı kaldır |
 
 ---
 
-## 2. İş Akışı Genel Bakış
+## 2. Kurulumdan Sonra 5 Dakikada Hızlı Başlangıç
+
+`speccrew init` çalıştırdıktan sonra, hızlıca çalışma durumuna girmek için şu adımları izleyin:
+
+### Adım 1: IDE'nizi Seçin
+
+| IDE | Başlatma Komutu | Uygulama Senaryosu |
+|-----|-----------|----------|
+| **Qoder** (Önerilen) | `speccrew init --ide qoder` | Tam agent orkestrasyonu, paralel worker'lar |
+| **Cursor** | `speccrew init --ide cursor` | Composer tabanlı iş akışları |
+| **Claude Code** | `speccrew init --ide claude` | CLI-first geliştirme |
+| **Codex** | `speccrew init --ide codex` | OpenAI ekosistem entegrasyonu |
+
+### Adım 2: Bilgi Tabanını Başlat (Önerilen)
+
+Mevcut kaynak kodu olan projeler için, agent'ların kod tabanınızı anlaması için önce bilgi tabanını başlatmanız önerilir:
+
+```
+@speccrew-team-leader teknik bilgi tabanını başlat
+```
+
+Sonra:
+
+```
+@speccrew-team-leader iş bilgi tabanını başlat
+```
+
+### Adım 3: İlk Görevinizi Başlatın
+
+```
+@speccrew-product-manager Yeni bir gereksinimim var: [işlevsel gereksiniminizi açıklayın]
+```
+
+> **İpucu**: Ne yapacağınızdan emin değilseniz, sadece `@speccrew-team-leader başlamama yardım et` deyin — Team Leader proje durumunuzu otomatik olarak algılayacak ve size rehberlik edecektir.
+
+---
+
+## 3. Hızlı Karar Ağacı
+
+Ne yapacağınızdan emin değil misiniz? Senaryonuzu aşağıda bulun:
+
+- **Yeni bir işlevsel gereksinimim var**
+  → `@speccrew-product-manager Yeni bir gereksinimim var: [işlevsel gereksiniminizi açıklayın]`
+
+- **Mevcut proje bilgisini taramak istiyorum**
+  → `@speccrew-team-leader teknik bilgi tabanını başlat`
+  → Sonra: `@speccrew-team-leader iş bilgi tabanını başlat`
+
+- **Önceki çalışmaya devam etmek istiyorum**
+  → `@speccrew-team-leader mevcut ilerleme nedir?`
+
+- **Sistem sağlık durumunu kontrol etmek istiyorum**
+  → Terminalde çalıştır: `speccrew doctor`
+
+- **Ne yapacağımdan emin değilim**
+  → `@speccrew-team-leader başlamama yardım et`
+  → Team Leader proje durumunuzu otomatik olarak algılayacak ve size rehberlik edecektir
+
+---
+
+## 4. Agent Hızlı Başvurusu
+
+| Rol | Agent | Sorumluluklar | Komut Örneği |
+|------|-------|-----------------|-----------------|
+| Takım Lideri | `@speccrew-team-leader` | Proje navigasyonu, bilgi tabanı başlatma, durum kontrolü | "Başlamama yardım et" |
+| Ürün Yöneticisi | `@speccrew-product-manager` | Gereksinim analizi, PRD oluşturma | "Yeni bir gereksinimim var: ..." |
+| İşlev Tasarımcısı | `@speccrew-feature-designer` | İşlev analizi, spesifikasyon tasarımı, API sözleşmeleri | "X iterasyonu için işlev tasarımını başlat" |
+| Sistem Tasarımcısı | `@speccrew-system-designer` | Mimari tasarımım, platform detaylı tasarım | "X iterasyonu için sistem tasarımını başlat" |
+| Sistem Geliştirici | `@speccrew-system-developer` | Geliştirme koordinasyonu, kod oluşturma | "X iterasyonu için geliştirmeyi başlat" |
+| Test Yöneticisi | `@speccrew-test-manager` | Test planlaması, vaka tasarımı, yürütme | "X iterasyonu için testleri başlat" |
+
+> **Not**: Tüm agent'ları hatırlamanıza gerek yok. Sadece `@speccrew-team-leader` ile konuşun, isteğinizi doğru agent'a yönlendirecektir.
+
+---
+
+## 5. İş Akışı Genel Bakış
 
 ### Tam Akış Diyagramı
 
 ```mermaid
 flowchart LR
-    PRD[Aşama 1<br/>Gereksinim Analizi<br/>Product Manager] --> FD[Aşama 2<br/>Özellik Tasarımı<br/>Feature Designer]
+    PRD[Aşama 1<br/>Gereksinim Analizi<br/>Product Manager] --> FD[Aşama 2<br/>İşlev Tasarımı<br/>Feature Designer]
     FD --> SD[Aşama 3<br/>Sistem Tasarımı<br/>System Designer]
     SD --> DEV[Aşama 4<br/>Geliştirme<br/>System Developer]
     DEV --> TEST[Aşama 5<br/>Sistem Testi<br/>Test Manager]
@@ -85,49 +159,49 @@ flowchart LR
 ### Temel İlkeler
 
 1. **Aşama Bağımlılıkları**: Her aşamanın çıktısı bir sonraki aşamanın girdisidir
-2. **Kontrol Noktası Onayı**: Her aşama, devam etmeden önce kullanıcı onayı gerektiren bir onay noktasına sahiptir
-3. **Bilgi Tabanı Güdümlü**: Bilgi tabanı tüm süreç boyunca ilerler, tüm aşamalar için bağlam sağlar
+2. **Checkpoint Onayı**: Her aşamanın, bir sonraki aşamaya geçmeden önce kullanıcı onayı gerektiren bir onay noktası vardır
+3. **Bilgi Tabanı Destekli**: Bilgi tabanı tüm süreç boyunca çalışır, tüm aşamalar için bağlam sağlar
 
 ---
 
-## 3. Sıfırıncı Adım: Bilgi Tabanı Başlatma
+## 6. Adım Sıfır: Bilgi Tabanı Başlatma
 
-Resmi mühendislik sürecini başlatmadan önce proje bilgi tabanını başlatmanız gerekir.
+Resmi mühendislik sürecini başlatmadan önce, proje bilgi tabanını başlatmanız gerekir.
 
-### 3.1 Teknik Bilgi Tabanı Başlatma
+### 6.1 Teknik Bilgi Tabanı Başlatma
 
-**Örnek Konuşma**:
+**Konuşma Örneği**:
 ```
 @speccrew-team-leader teknik bilgi tabanını başlat
 ```
 
 **Üç Aşamalı Süreç**:
-1. Platform Tespiti — Projedeki teknoloji platformlarını tanımla
-2. Teknik Dokümantasyon Üretimi — Her platform için teknik özellik belgeleri oluştur
-3. İndeks Üretimi — Bilgi tabanı indeksini oluştur
+1. Platform Algılama — Projedeki teknik platformları tanımla
+2. Teknik Doküman Oluşturma — Her platform için teknik spesifikasyon belgeleri oluştur
+3. İndeks Oluşturma — Bilgi tabanı indeksini oluştur
 
 **Çıktı**:
 ```
 speccrew-workspace/knowledges/techs/{platform-id}/
 ├── tech-stack.md          # Teknoloji yığını tanımı
 ├── architecture.md        # Mimari kurallar
-├── dev-spec.md            # Geliştirme özellikleri
-├── test-spec.md           # Test özellikleri
+├── dev-spec.md            # Geliştirme spesifikasyonları
+├── test-spec.md           # Test spesifikasyonları
 └── INDEX.md               # İndeks dosyası
 ```
 
-### 3.2 İş Bilgi Tabanı Başlatma
+### 6.2 İş Bilgi Tabanı Başlatma
 
-**Örnek Konuşma**:
+**Konuşma Örneği**:
 ```
 @speccrew-team-leader iş bilgi tabanını başlat
 ```
 
 **Dört Aşamalı Süreç**:
-1. Özellik Envanteri — Tüm özellikleri tanımlamak için kodu tara
-2. Özellik Analizi — Her özelliğin iş mantığını analiz et
-3. Modül Özeti — Özellikleri modüllere göre özetle
-4. Sistem Özeti — Sistem seviyesinde iş genel görünümü oluştur
+1. İşlev Envanteri — Tüm işlevleri tanımlamak için kodu tara
+2. İşlev Analizi — Her işlev için iş mantığını analiz et
+3. Modül Özeti — İşlevleri modüle göre özetle
+4. Sistem Özeti — Sistem seviyesi iş genel görünümü oluştur
 
 **Çıktı**:
 ```
@@ -140,16 +214,16 @@ speccrew-workspace/knowledges/bizs/
 
 ---
 
-## 4. Aşama Aşama Konuşma Kılavuzu
+## 7. Aşama Aşama Konuşma Kılavuzu
 
-### 4.1 Aşama 1: Gereksinim Analizi (Product Manager)
+### 7.1 Aşama 1: Gereksinim Analizi (Product Manager)
 
 **Nasıl Başlatılır**:
 ```
-@speccrew-product-manager yeni bir gereksinimim var: [gereksiniminizi açıklayın]
+@speccrew-product-manager Yeni bir gereksinimim var: [gereksiniminizi açıklayın]
 ```
 
-**Ajan İş Akışı**:
+**Agent İş Akışı**:
 1. Mevcut modülleri anlamak için sistem genel görünümünü oku
 2. Kullanıcı gereksinimlerini analiz et
 3. Yapılandırılmış PRD belgesi oluştur
@@ -157,8 +231,8 @@ speccrew-workspace/knowledges/bizs/
 **Çıktı**:
 ```
 iterations/{numara}-{tip}-{isim}/01.product-requirement/
-├── [feature-name]-prd.md           # Ürün Gereksinim Belgesi
-└── [feature-name]-bizs-modeling.md # İş modelleme (karmaşık gereksinimler için)
+├── [feature-name]-prd.md           # Ürün Gereksinimleri Belgesi
+└── [feature-name]-bizs-modeling.md # İş modellemesi (karmaşık gereksinimler için)
 ```
 
 **Onay Kontrol Listesi**:
@@ -169,23 +243,23 @@ iterations/{numara}-{tip}-{isim}/01.product-requirement/
 
 ---
 
-### 4.2 Aşama 2: Özellik Tasarımı (Feature Designer)
+### 7.2 Aşama 2: İşlev Tasarımı (Feature Designer)
 
 **Nasıl Başlatılır**:
 ```
-@speccrew-feature-designer özellik tasarımına başla
+@speccrew-feature-designer işlev tasarımını başlat
 ```
 
-**Ajan İş Akışı**:
+**Agent İş Akışı**:
 1. Onaylanmış PRD belgesini otomatik olarak bul
 2. İş bilgi tabanını yükle
-3. Özellik tasarımı oluştur (UI wireframe'leri, etkileşim akışları, veri tanımları, API sözleşmeleri dahil)
+3. İşlev tasarımı oluştur (UI wireframe'leri, etkileşim akışları, veri tanımları, API sözleşmeleri dahil)
 4. Birden fazla PRD için paralel tasarım için Task Worker kullan
 
 **Çıktı**:
 ```
 iterations/{iter}/02.feature-design/
-└── [feature-name]-feature-spec.md  # Özellik tasarım belgesi
+└── [feature-name]-feature-spec.md  # İşlev tasarım belgesi
 ```
 
 **Onay Kontrol Listesi**:
@@ -196,20 +270,20 @@ iterations/{iter}/02.feature-design/
 
 ---
 
-### 4.3 Aşama 3: Sistem Tasarımı (System Designer)
+### 7.3 Aşama 3: Sistem Tasarımı (System Designer)
 
 **Nasıl Başlatılır**:
 ```
-@speccrew-system-designer sistem tasarımına başla
+@speccrew-system-designer sistem tasarımını başlat
 ```
 
-**Ajan İş Akışı**:
+**Agent İş Akışı**:
 1. Feature Spec ve API Contract'ı bul
-2. Teknik bilgi tabanını yükle (teknoloji yığını, mimari, her platform için özellikler)
-3. **Kontrol Noktası A**: Çerçeve Değerlendirmesi — Teknik boşlukları analiz et, yeni çerçeveler öner (gerekirse), kullanıcı onayını bekle
+2. Teknik bilgi tabanını yükle (her platform için teknoloji yığını, mimari, spesifikasyonlar)
+3. **Checkpoint A**: Framework Değerlendirmesi — Teknik boşlukları analiz et, yeni framework'ler öner (gerekirse), kullanıcı onayını bekle
 4. DESIGN-OVERVIEW.md oluştur
-5. Her platform için paralel tasarım dağıtımı için Task Worker kullan (frontend/backend/mobil/masaüstü)
-6. **Kontrol Noktası B**: Ortak Onay — Tüm platform tasarımlarının özetini göster, kullanıcı onayını bekle
+5. Her platform için tasarımı paralel olarak dağıtmak için Task Worker kullan (frontend/backend/mobile/desktop)
+6. **Checkpoint B**: Ortak Onay — Tüm platform tasarımlarının özetini göster, kullanıcı onayını bekle
 
 **Çıktı**:
 ```
@@ -217,34 +291,34 @@ iterations/{iter}/03.system-design/
 ├── DESIGN-OVERVIEW.md              # Tasarım genel görünümü
 ├── {platform-id}/
 │   ├── INDEX.md                    # Platform tasarım indeksi
-│   └── {module}-design.md          # Sözde kod seviyesinde modül tasarımı
+│   └── {module}-design.md          # Sözde kod seviyesi modül tasarımı
 ```
 
 **Onay Kontrol Listesi**:
-- [ ] Sözde kod gerçek çerçeve sözdizimi kullanıyor mu?
+- [ ] Sözde kod gerçek framework sözdizimini kullanıyor mu?
 - [ ] Platformlar arası API sözleşmeleri tutarlı mı?
-- [ ] Hata işleme stratejisi birleşik mi?
+- [ ] Hata yönetimi stratejisi birleşik mi?
 
 ---
 
-### 4.4 Aşama 4: Geliştirme Uygulaması (System Developer)
+### 7.4 Aşama 4: Geliştirme (System Developer)
 
 **Nasıl Başlatılır**:
 ```
-@speccrew-system-developer geliştirmeye başla
+@speccrew-system-developer geliştirmeyi başlat
 ```
 
-**Ajan İş Akışı**:
+**Agent İş Akışı**:
 1. Sistem tasarım belgelerini oku
 2. Her platform için teknik bilgiyi yükle
-3. **Kontrol Noktası A**: Ortam Ön Doğrulaması — Runtime sürümlerini, bağımlılıkları, hizmet kullanılabilirliğini doğrula; başarısız olursa kullanıcı çözümünü bekle
-4. Her platform için paralel geliştirme dağıtımı için Task Worker kullan
-5. Entegrasyon doğrulaması: API sözleşme hizalaması, veri tutarlılığı
+3. **Checkpoint A**: Ortam Ön Kontrolü — Runtime sürümlerini, bağımlılıkları, hizmet kullanılabilirliğini kontrol et; başarısız olursa kullanıcı çözümünü bekle
+4. Her platform için geliştirmeyi paralel olarak dağıtmak için Task Worker kullan
+5. Entegrasyon kontrolü: API sözleşme hizalaması, veri tutarlılığı
 6. Teslim raporu oluştur
 
 **Çıktı**:
 ```
-# Kaynak kodu projenin gerçek kaynak kodu dizinine yazılır
+# Kaynak kod proje gerçek kaynak dizinine yazılır
 iterations/{iter}/04.development/
 ├── {platform-id}/
 │   └── tasks/                      # Geliştirme görev kayıtları
@@ -254,30 +328,30 @@ iterations/{iter}/04.development/
 **Onay Kontrol Listesi**:
 - [ ] Ortam hazır mı?
 - [ ] Entegrasyon sorunları kabul edilebilir aralıkta mı?
-- [ ] Kod geliştirme özelliklerine uygun mu?
+- [ ] Kod geliştirme spesifikasyonlarına uygun mu?
 
 ---
 
-### 4.5 Aşama 5: Sistem Testi (Test Manager)
+### 7.5 Aşama 5: Sistem Testi (Test Manager)
 
 **Nasıl Başlatılır**:
 ```
-@speccrew-test-manager teste başla
+@speccrew-test-manager testleri başlat
 ```
 
 **Üç Aşamalı Test Süreci**:
 
-| Aşama | Açıklama | Kontrol Noktası |
-|------|----------|-------------------|
-| Test Senaryosu Tasarımı | PRD ve Feature Spec'e dayalı test senaryoları oluştur | A: Senaryo kapsam istatistiklerini ve izlenebilirlik matrisini göster, yeterli kapsam için kullanıcı onayını bekle |
-| Test Kodu Üretimi | Yürütülebilir test kodu oluştur | B: Oluşturulan test dosyalarını ve senaryo eşlemesini göster, kullanıcı onayını bekle |
-| Test Yürütme ve Hata Raporu | Testleri otomatik olarak yürüt ve raporlar oluştur | Yok (otomatik yürütme) |
+| Aşama | Açıklama | Checkpoint |
+|-------|-------------|------------|
+| Test Vaka Tasarımı | PRD ve Feature Spec'e dayalı test vakaları oluştur | A: Vaka kapsam istatistiklerini ve izlenebilirlik matrisini göster, yeterli kapsam kullanıcı onayını bekle |
+| Test Kodu Oluşturma | Yürütülebilir test kodu oluştur | B: Oluşturulan test dosyalarını ve vaka eşlemesini göster, kullanıcı onayını bekle |
+| Test Yürütme ve Hata Raporlama | Testleri otomatik olarak yürüt ve raporlar oluştur | Yok (otomatik yürütme) |
 
 **Çıktı**:
 ```
 iterations/{iter}/05.system-test/
 ├── cases/
-│   └── {platform-id}/              # Test senaryosu belgeleri
+│   └── {platform-id}/              # Test vaka belgeleri
 ├── code/
 │   └── {platform-id}/              # Test kodu planı
 ├── reports/
@@ -287,15 +361,15 @@ iterations/{iter}/05.system-test/
 ```
 
 **Onay Kontrol Listesi**:
-- [ ] Senaryo kapsamı eksiksiz mi?
+- [ ] Vaka kapsamı eksiksiz mi?
 - [ ] Test kodu yürütülebilir mi?
-- [ ] Hata önem değerlendirmesi doğru mu?
+- [ ] Hata önem derecelendirmesi doğru mu?
 
 ---
 
-### 4.6 Aşama 6: Arşivleme
+### 7.6 Aşama 6: Arşivleme
 
-İterasyonlar tamamlandığında otomatik olarak arşivlenir:
+İterasyonlar tamamlandıktan sonra otomatik olarak arşivlenir:
 
 ```
 speccrew-workspace/iteration-archives/
@@ -309,11 +383,11 @@ speccrew-workspace/iteration-archives/
 
 ---
 
-## 5. Bilgi Tabanı Genel Bakış
+## 8. Bilgi Tabanı Genel Bakış
 
-### 5.1 İş Bilgi Tabanı (bizs)
+### 8.1 İş Bilgi Tabanı (bizs)
 
-**Amaç**: Projenin iş fonksiyon açıklamalarını, modül bölümlerini, API özelliklerini saklamak
+**Amaç**: Proje iş işlevi açıklamalarını, modül bölümlerini, API özelliklerini sakla
 
 **Dizin Yapısı**:
 ```
@@ -326,9 +400,9 @@ knowledges/bizs/
 
 **Kullanım Senaryoları**: Product Manager, Feature Designer
 
-### 5.2 Teknik Bilgi Tabanı (techs)
+### 8.2 Teknik Bilgi Tabanı (techs)
 
-**Amaç**: Projenin teknoloji yığınını, mimari kurallarını, geliştirme özelliklerini, test özelliklerini saklamak
+**Amaç**: Proje teknoloji yığınını, mimari kurallarını, geliştirme spesifikasyonlarını, test spesifikasyonlarını sakla
 
 **Dizin Yapısı**:
 ```
@@ -344,21 +418,21 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. İş Akışı İlerleme Yönetimi
+## 9. İş Akışı İlerleme Yönetimi
 
-SpecCrew sanal ekibi, bir sonraki aşamaya geçmeden önce her aşamanın kullanıcı tarafından onaylanması gereken katı bir aşama-geçit mekanizması izler. Ayrıca devam ettirilebilir yürütme desteği sunar — kesinti sonrası yeniden başlatıldığında, kaldığı yerden otomatik olarak devam eder.
+SpecCrew sanal takımı, her aşamanın bir sonrakine geçmeden önce kullanıcı tarafından onaylanması gereken sıkı bir aşama gate mekanizması izler. Ayrıca yeniden başlatılabilir yürütmeyi de destekler — kesinti sonrası yeniden başlatıldığında, kaldığı yerden otomatik olarak devam eder.
 
-### 6.1 Üç Katmanlı İlerleme Dosyaları
+### 9.1 Üç Katmanlı İlerleme Dosyaları
 
-İş akışı, iterasyon dizininde bulunan üç tür JSON ilerleme dosyasını otomatik olarak yönetir:
+İş akışı, iterasyon dizininde bulunan üç tür JSON ilerleme dosyasını otomatik olarak sürdürür:
 
 | Dosya | Konum | Amaç |
-|-------|-------|------|
-| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Her boru hattı aşamasının durumunu kaydeder |
-| `.checkpoints.json` | Her aşama dizini altında | Kullanıcı kontrol noktası onay durumunu kaydeder |
-| `DISPATCH-PROGRESS.json` | Her aşama dizini altında | Paralel görevler için öğe bazında ilerlemeyi kaydeder (çoklu platform/çoklu modül) |
+|------|----------|---------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Her pipeline aşamasının durumunu kaydeder |
+| `.checkpoints.json` | Her aşama dizini altında | Kullanıcı checkpoint onay durumunu kaydeder |
+| `DISPATCH-PROGRESS.json` | Her aşama dizini altında | Paralel görevler için öğe öğe ilerlemeyi kaydeder (çoklu platform/çoklu modül) |
 
-### 6.2 Aşama Durum Akışı
+### 9.2 Aşama Durum Akışı
 
 Her aşama bu durum akışını izler:
 
@@ -366,28 +440,28 @@ Her aşama bu durum akışını izler:
 pending → in_progress → completed → confirmed
 ```
 
-- **pending**: Henüz başlamadı
-- **in_progress**: Şu anda yürütülüyor
-- **completed**: Ajan yürütmesi tamamlandı, kullanıcı onayı bekleniyor
-- **confirmed**: Kullanıcı son kontrol noktası üzerinden onayladı, bir sonraki aşama başlayabilir
+- **pending**: Henüz başlatılmadı
+- **in_progress**: Yürütülüyor
+- **completed**: Agent yürütmesi tamamlandı, kullanıcı onayı bekleniyor
+- **confirmed**: Kullanıcı son checkpoint üzerinden onayladı, sonraki aşama başlayabilir
 
-### 6.3 Devam Ettirilebilir Yürütme
+### 9.3 Yeniden Başlatılabilir Yürütme
 
-Bir aşama için Ajan yeniden başlatıldığında:
+Bir aşama için Agent'ı yeniden başlatırken:
 
-1. **Otomatik yukarı akış kontrolü**: Önceki aşamanın onaylanıp onaylanmadığını doğrular, değilse engeller ve uyarır
-2. **Kontrol noktası kurtarma**: `.checkpoints.json` dosyasını okur, geçilen kontrol noktalarını atlar, son kesinti noktasından devam eder
-3. **Paralel görev kurtarma**: `DISPATCH-PROGRESS.json` dosyasını okur, yalnızca `pending` veya `failed` durumundaki görevleri yeniden yürütür, `completed` görevleri atlar
+1. **Otomatik upstream kontrolü**: Önceki aşamanın onaylanıp onaylanmadığını doğrular, onaylanmadıysa engeller ve ister
+2. **Checkpoint kurtarma**: `.checkpoints.json` okur, geçen checkpoint'leri atlar, son kesinti noktasından devam eder
+3. **Paralel görev kurtarma**: `DISPATCH-PROGRESS.json` okur, sadece `pending` veya `failed` durumundaki görevleri yeniden yürütür, `completed` görevleri atlar
 
-### 6.4 Mevcut İlerlemeyi Görüntüleme
+### 9.4 Mevcut İlerlemeyi Görüntüle
 
-Takım Lideri Ajanı üzerinden boru hattı panoramik durumunu görüntüleyin:
+Team Leader Agent üzerinden pipeline panorama durumunu görüntüle:
 
 ```
 @speccrew-team-leader mevcut iterasyon ilerlemesini görüntüle
 ```
 
-Takım Lideri ilerleme dosyalarını okuyacak ve aşağıdakine benzer bir durum özeti görüntüleyecektir:
+Team Leader ilerleme dosyalarını okuyacak ve şuna benzer bir durum genel görünümü gösterecek:
 
 ```
 Pipeline Status: i001-user-management
@@ -398,25 +472,25 @@ Pipeline Status: i001-user-management
   05 System Test:    ⏳ Pending
 ```
 
-### 6.5 Geriye Dönük Uyumluluk
+### 9.5 Geriye Dönük Uyumluluk
 
-İlerleme dosyası mekanizması tamamen geriye dönük uyumludur — ilerleme dosyaları mevcut değilse (örneğin, eski projelerde veya yeni iterasyonlarda), tüm Ajanlar orijinal mantığa göre normal şekilde yürütülecektir.
+İlerleme dosyası mekanizması tamamen geriye dönük uyumludur — ilerleme dosyaları yoksa (örn. eski projelerde veya yeni iterasyonlarda), tüm Agent'lar orijinal mantığa göre normal şekilde yürütülecektir.
 
 ---
 
-## 7. Sıkça Sorulan Sorular (SSS)
+## 10. Sıkça Sorulan Sorular (SSS)
 
-### S1: Ajan beklendiği gibi çalışmazsa ne yapmalıyım?
+### S1: Agent beklenildiği gibi çalışmazsa ne yapmalıyım?
 
-1. Kurulum bütünlüğünü kontrol etmek için `speccrew doctor` çalıştırın
-2. Bilgi tabanının başlatıldığını onaylayın
-3. Önceki aşamanın çıktısının mevcut iterasyon dizininde olduğunu onaylayın
+1. Yükleme bütünlüğünü kontrol etmek için `speccrew doctor` çalıştır
+2. Bilgi tabanının başlatıldığını onayla
+3. Önceki aşamanın çıktısının mevcut iterasyon dizininde olduğunu onayla
 
 ### S2: Bir aşamayı nasıl atlarım?
 
 **Önerilmez** — Her aşamanın çıktısı bir sonraki aşamanın girdisidir.
 
-Atlamanız gerekirse, ilgili aşamanın giriş belgesini manuel olarak hazırlayın ve format özelliklerine uygun olduğundan emin olun.
+Atlamanız gerekirse, ilgili aşamanın giriş belgesini manuel olarak hazırlayın ve format spesifikasyonlarına uygun olduğundan emin olun.
 
 ### S3: Birden fazla paralel gereksinimi nasıl yönetirim?
 
@@ -438,81 +512,86 @@ Güncelleme iki adım gerektirir:
 # Adım 1: Global CLI aracını güncelle
 npm install -g speccrew@latest
 
-# Adım 2: Proje dizininizdeki Ajan ve Becerileri senkronize et
+# Adım 2: Proje dizininde Agent'ları ve Skill'leri senkronize et
 cd /path/to/your-project
 speccrew update
 ```
 
-- `npm install -g speccrew@latest`: CLI aracının kendisini günceller (yeni sürümler yeni Ajan/Beceri tanımları, hata düzeltmeleri vb. içerebilir)
-- `speccrew update`: Projenizdeki Ajan ve Beceri tanım dosyalarını en son sürüme senkronize eder
-- `speccrew update --ide cursor`: Yalnızca belirli bir IDE için yapılandırmayı günceller
+- `npm install -g speccrew@latest`: CLI aracının kendisini günceller (yeni sürümler yeni Agent/Skill tanımları, hata düzeltmeleri vb. içerebilir)
+- `speccrew update`: Projenizdeki Agent ve Skill tanım dosyalarını en son sürüme senkronize eder
+- `speccrew update --ide cursor`: Sadece belirli IDE için yapılandırmayı günceller
+
+> **Not**: Her iki adım da gereklidir. Sadece `speccrew update` çalıştırmak CLI aracının kendisini güncellemez; sadece `npm install` çalıştırmak proje dosyalarını güncellemez.
 
-> **Not**: Her iki adım da gereklidir. Yalnızca `speccrew update` çalıştırmak CLI aracının kendisini güncellemez; yalnızca `npm install` çalıştırmak proje dosyalarını güncellemez.
+### S5: `speccrew update` yeni sürüm mevcut olduğunu gösteriyor ama `npm install -g speccrew@latest` hala eski sürümü yüklüyor?
 
-### S5: `speccrew update` yeni sürüm gösteriyor ancak kurulumdan sonra hala eski sürüm?
+Bu genellikle npm önbelleğinden kaynaklanır. Çözüm:
 
-Genellikle npm önbelleğinden kaynaklanır. Çözüm:
 ```bash
+# npm önbelleğini temizle ve yeniden yükle
 npm cache clean --force
 npm install -g speccrew@latest
+
+# Sürümü doğrula
 npm list -g speccrew
 ```
-Hala çalışmazsa, belirli bir sürüm yükleyin:
+
+Hala çalışmıyorsa, belirli bir sürüm numarası ile yüklemeyi deneyin:
 ```bash
 npm install -g speccrew@0.5.6
 ```
 
 ### S6: Geçmiş iterasyonları nasıl görüntülerim?
 
-Arşivledikten sonra `speccrew-workspace/iteration-archives/` içinde inceleyin, `{numara}-{tip}-{isim}-{tarih}/` formatında düzenlenmiştir.
+Arşivlemeden sonra, `speccrew-workspace/iteration-archives/` içinde görüntüleyin, `{numara}-{tip}-{isim}-{tarih}/` formatına göre düzenlenmiş.
 
-### S7: Bilgi tabanının düzenli olarak güncellenmesi gerekiyor mu?
+### S7: Bilgi tabanının düzenli olarak güncellenmesi gerekir mi?
 
-Aşağıdaki durumlarda yeniden başlatma gerekir:
-- Proje yapısında önemli değişiklikler
-- Teknoloji yığını güncellemesi veya değişimi
-- İş modülü ekleme/kaldırma
+Aşağıdaki durumlarda yeniden başlatma gereklidir:
+- Proje yapısında büyük değişiklikler
+- Teknoloji yığını yükseltmesi veya değişimi
+- İş modüllerinin eklenmesi/kaldırılması
 
 ---
 
-## 8. Hızlı Referans
+## 11. Hızlı Başvuru
 
-### Ajan Başlatma Hızlı Referansı
+### Agent Başlatma Hızlı Başvurusu
 
-| Aşama | Ajan | Başlangıç Konuşması |
-|------|-------|-------------------|
+| Aşama | Agent | Başlatma Konuşması |
+|-------|-------|-------------------|
 | Başlatma | Team Leader | `@speccrew-team-leader teknik bilgi tabanını başlat` |
-| Gereksinim Analizi | Product Manager | `@speccrew-product-manager yeni bir gereksinimim var: [açıklama]` |
-| Özellik Tasarımı | Feature Designer | `@speccrew-feature-designer özellik tasarımına başla` |
-| Sistem Tasarımı | System Designer | `@speccrew-system-designer sistem tasarımına başla` |
-| Geliştirme | System Developer | `@speccrew-system-developer geliştirmeye başla` |
-| Sistem Testi | Test Manager | `@speccrew-test-manager teste başla` |
+| Gereksinim Analizi | Product Manager | `@speccrew-product-manager Yeni bir gereksinimim var: [açıklama]` |
+| İşlev Tasarımı | Feature Designer | `@speccrew-feature-designer işlev tasarımını başlat` |
+| Sistem Tasarımı | System Designer | `@speccrew-system-designer sistem tasarımını başlat` |
+| Geliştirme | System Developer | `@speccrew-system-developer geliştirmeyi başlat` |
+| Sistem Testi | Test Manager | `@speccrew-test-manager testleri başlat` |
 
-### Kontrol Noktaları Kontrol Listesi
+### Checkpoint Kontrol Listesi
 
-| Aşama | Kontrol Noktası Sayısı | Temel Doğrulama Öğeleri |
-|------|------------------------|------------------------|
-| Gereksinim Analizi | 1 | Gereksinim doğruluğu, iş kuralları eksiksizliği, kabul kriterleri ölçülebilirliği |
-| Özellik Tasarımı | 1 | Senaryo kapsamı, etkileşim netliği, veri eksiksizliği, istisna yönetimi |
-| Sistem Tasarımı | 2 | A: Çerçeve değerlendirmesi; B: Sözde kod sözdizimi, platformlar arası tutarlılık, hata işleme |
-| Geliştirme | 1 | A: Ortam hazırlığı, entegrasyon sorunları, kod özellikleri |
-| Sistem Testi | 2 | A: Senaryo kapsamı; B: Test kodu yürütülebilirliği |
+| Aşama | Checkpoint Sayısı | Ana Kontrol Öğeleri |
+|-------|----------------------|-----------------|
+| Gereksinim Analizi | 1 | Gereksinim doğruluğu, iş kuralı bütünlüğü, kabul kriteri ölçülebilirliği |
+| İşlev Tasarımı | 1 | Senaryo kapsamı, etkileşim netliği, veri bütünlüğü, istisna yönetimi |
+| Sistem Tasarımı | 2 | A: Framework değerlendirmesi; B: Sözde kod sözdizimi, platformlar arası tutarlılık, hata yönetimi |
+| Geliştirme | 1 | A: Ortam hazır olması, entegrasyon sorunları, kod spesifikasyonları |
+| Sistem Testi | 2 | A: Vaka kapsamı; B: Test kodu yürütülebilirliği |
 
-### Çıktı Yolları Hızlı Referansı
+### Çıktı Yolu Hızlı Başvurusu
 
 | Aşama | Çıktı Dizini | Dosya Formatı |
-|------|------------------|-------------|
+|-------|-----------------|-------------|
 | Gereksinim Analizi | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
-| Özellik Tasarımı | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
+| İşlev Tasarımı | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
 | Sistem Tasarımı | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
 | Geliştirme | `iterations/{iter}/04.development/` | Kaynak kod + `delivery-report.md` |
 | Sistem Testi | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
-| Arşivleme | `iteration-archives/{iter}-{tarih}/` | İterasyonun tam kopyası |
+| Arşivleme | `iteration-archives/{iter}-{date}/` | Tam iterasyon kopyası |
 
 ---
 
 ## Sonraki Adımlar
 
 1. Projenizi başlatmak için `speccrew init --ide qoder` çalıştırın
-2. Sıfırıncı Adımı uygulayın: Bilgi Tabanı Başlatma
-3. İş akışını takip ederek her aşamada ilerleyin, şart odaklı geliştirme deneyiminin keyfini çıkarın!
+2. Adım Sıfır'ı yürütün: Bilgi Tabanı Başlatma
+3. İş akışına göre aşama aşama ilerleyin, spesifikasyon destekli geliştirme deneyiminin keyfini çıkarın!