speccrew 0.7.44 → 0.7.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/.speccrew/agents/speccrew-team-leader.md +6 -6
  2. package/README.ar.md +5 -17
  3. package/README.de.md +5 -17
  4. package/README.en.md +5 -17
  5. package/README.es.md +5 -17
  6. package/README.fr.md +5 -17
  7. package/README.hi.md +384 -0
  8. package/README.ja.md +5 -17
  9. package/README.md +5 -17
  10. package/README.pt-BR.md +5 -17
  11. package/README.ru.md +5 -17
  12. package/docs/GETTING-STARTED.ar.md +39 -40
  13. package/docs/GETTING-STARTED.de.md +39 -40
  14. package/docs/GETTING-STARTED.en.md +39 -40
  15. package/docs/GETTING-STARTED.es.md +39 -40
  16. package/docs/GETTING-STARTED.fr.md +39 -40
  17. package/docs/GETTING-STARTED.hi.md +636 -0
  18. package/docs/GETTING-STARTED.ja.md +39 -40
  19. package/docs/GETTING-STARTED.md +39 -40
  20. package/docs/GETTING-STARTED.pt-BR.md +25 -26
  21. package/docs/GETTING-STARTED.ru.md +37 -38
  22. package/lib/commands/init.js +3 -3
  23. package/package.json +1 -1
  24. package/workspace-template/scripts/update-progress.js +5 -1
  25. package/README.bn.md +0 -174
  26. package/README.bs.md +0 -394
  27. package/README.da.md +0 -394
  28. package/README.el.md +0 -174
  29. package/README.it.md +0 -394
  30. package/README.ko.md +0 -394
  31. package/README.no.md +0 -394
  32. package/README.pl.md +0 -394
  33. package/README.th.md +0 -311
  34. package/README.tr.md +0 -306
  35. package/README.uk.md +0 -306
  36. package/README.vi.md +0 -174
  37. package/README.zh-TW.md +0 -394
  38. package/docs/GETTING-STARTED.bn.md +0 -219
  39. package/docs/GETTING-STARTED.bs.md +0 -219
  40. package/docs/GETTING-STARTED.da.md +0 -637
  41. package/docs/GETTING-STARTED.el.md +0 -633
  42. package/docs/GETTING-STARTED.it.md +0 -639
  43. package/docs/GETTING-STARTED.ko.md +0 -639
  44. package/docs/GETTING-STARTED.no.md +0 -563
  45. package/docs/GETTING-STARTED.pl.md +0 -597
  46. package/docs/GETTING-STARTED.th.md +0 -219
  47. package/docs/GETTING-STARTED.tr.md +0 -597
  48. package/docs/GETTING-STARTED.uk.md +0 -597
  49. package/docs/GETTING-STARTED.vi.md +0 -217
  50. package/docs/GETTING-STARTED.zh-TW.md +0 -639
@@ -1,597 +0,0 @@
1
- # SpecCrew Hızlı Başlangıç Kılavuzu
2
-
3
- <p align="center">
4
- <a href="./GETTING-STARTED.md">简体中文</a> |
5
- <a href="./GETTING-STARTED.zh-TW.md">繁體中文</a> |
6
- <a href="./GETTING-STARTED.en.md">English</a> |
7
- <a href="./GETTING-STARTED.ko.md">한국어</a> |
8
- <a href="./GETTING-STARTED.de.md">Deutsch</a> |
9
- <a href="./GETTING-STARTED.es.md">Español</a> |
10
- <a href="./GETTING-STARTED.fr.md">Français</a> |
11
- <a href="./GETTING-STARTED.it.md">Italiano</a> |
12
- <a href="./GETTING-STARTED.da.md">Dansk</a> |
13
- <a href="./GETTING-STARTED.ja.md">日本語</a> |
14
- <a href="./GETTING-STARTED.ar.md">العربية</a>
15
- </p>
16
-
17
- 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.
18
-
19
- ---
20
-
21
- ## 1. Ön Koşullar
22
-
23
- ### SpecCrew'ı Yükle
24
-
25
- ```bash
26
- npm install -g speccrew
27
- ```
28
-
29
- ### Projeyi Başlat
30
-
31
- ```bash
32
- speccrew init --ide qoder
33
- ```
34
-
35
- Desteklenen IDE'ler: `qoder`, `cursor`, `claude`, `codex`
36
-
37
- ### Başlatma Sonrası Dizin Yapısı
38
-
39
- ```
40
- .
41
- ├── .qoder/
42
- │ ├── agents/ # Agent tanım dosyaları
43
- │ └── skills/ # Skill tanım dosyaları
44
- ├── speccrew-workspace/ # Workspace
45
- │ ├── docs/ # Yapılandırmalar, kurallar, şablonlar, çözümler
46
- │ ├── iterations/ # Devam eden iterasyonlar
47
- │ ├── iteration-archives/ # Arşivlenmiş iterasyonlar
48
- │ └── knowledges/ # Bilgi tabanı
49
- │ ├── base/ # Temel bilgiler (teşhis raporları, teknik borçlar)
50
- │ ├── bizs/ # İş bilgi tabanı
51
- │ └── techs/ # Teknik bilgi tabanı
52
- ```
53
-
54
- ### CLI Komut Hızlı Başvurusu
55
-
56
- | Komut | Açıklama |
57
- |------|------|
58
- | `speccrew list` | Tüm mevcut Agent'ları ve Skill'leri listele |
59
- | `speccrew doctor` | Yükleme bütünlüğünü kontrol et |
60
- | `speccrew update` | Proje yapılandırmasını en son sürüme güncelle |
61
- | `speccrew uninstall` | SpecCrew'ı kaldır |
62
-
63
- ---
64
-
65
- ## 2. Kurulumdan Sonra 5 Dakikada Hızlı Başlangıç
66
-
67
- `speccrew init` çalıştırdıktan sonra, hızlıca çalışma durumuna girmek için şu adımları izleyin:
68
-
69
- ### Adım 1: IDE'nizi Seçin
70
-
71
- | IDE | Başlatma Komutu | Uygulama Senaryosu |
72
- |-----|-----------|----------|
73
- | **Qoder** (Önerilen) | `speccrew init --ide qoder` | Tam agent orkestrasyonu, paralel worker'lar |
74
- | **Cursor** | `speccrew init --ide cursor` | Composer tabanlı iş akışları |
75
- | **Claude Code** | `speccrew init --ide claude` | CLI-first geliştirme |
76
- | **Codex** | `speccrew init --ide codex` | OpenAI ekosistem entegrasyonu |
77
-
78
- ### Adım 2: Bilgi Tabanını Başlat (Önerilen)
79
-
80
- 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:
81
-
82
- ```
83
- @speccrew-team-leader teknik bilgi tabanını başlat
84
- ```
85
-
86
- Sonra:
87
-
88
- ```
89
- @speccrew-team-leader iş bilgi tabanını başlat
90
- ```
91
-
92
- ### Adım 3: İlk Görevinizi Başlatın
93
-
94
- ```
95
- @speccrew-product-manager Yeni bir gereksinimim var: [işlevsel gereksiniminizi açıklayın]
96
- ```
97
-
98
- > **İ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.
99
-
100
- ---
101
-
102
- ## 3. Hızlı Karar Ağacı
103
-
104
- Ne yapacağınızdan emin değil misiniz? Senaryonuzu aşağıda bulun:
105
-
106
- - **Yeni bir işlevsel gereksinimim var**
107
- → `@speccrew-product-manager Yeni bir gereksinimim var: [işlevsel gereksiniminizi açıklayın]`
108
-
109
- - **Mevcut proje bilgisini taramak istiyorum**
110
- → `@speccrew-team-leader teknik bilgi tabanını başlat`
111
- → Sonra: `@speccrew-team-leader iş bilgi tabanını başlat`
112
-
113
- - **Önceki çalışmaya devam etmek istiyorum**
114
- → `@speccrew-team-leader mevcut ilerleme nedir?`
115
-
116
- - **Sistem sağlık durumunu kontrol etmek istiyorum**
117
- → Terminalde çalıştır: `speccrew doctor`
118
-
119
- - **Ne yapacağımdan emin değilim**
120
- → `@speccrew-team-leader başlamama yardım et`
121
- → Team Leader proje durumunuzu otomatik olarak algılayacak ve size rehberlik edecektir
122
-
123
- ---
124
-
125
- ## 4. Agent Hızlı Başvurusu
126
-
127
- | Rol | Agent | Sorumluluklar | Komut Örneği |
128
- |------|-------|-----------------|-----------------|
129
- | Takım Lideri | `@speccrew-team-leader` | Proje navigasyonu, bilgi tabanı başlatma, durum kontrolü | "Başlamama yardım et" |
130
- | Ürün Yöneticisi | `@speccrew-product-manager` | Gereksinim analizi, PRD oluşturma | "Yeni bir gereksinimim var: ..." |
131
- | İş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" |
132
- | 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" |
133
- | Sistem Geliştirici | `@speccrew-system-developer` | Geliştirme koordinasyonu, kod oluşturma | "X iterasyonu için geliştirmeyi başlat" |
134
- | Test Yöneticisi | `@speccrew-test-manager` | Test planlaması, vaka tasarımı, yürütme | "X iterasyonu için testleri başlat" |
135
-
136
- > **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.
137
-
138
- ---
139
-
140
- ## 5. İş Akışı Genel Bakış
141
-
142
- ### Tam Akış Diyagramı
143
-
144
- ```mermaid
145
- flowchart LR
146
- PRD[Aşama 1<br/>Gereksinim Analizi<br/>Product Manager] --> FD[Aşama 2<br/>İşlev Tasarımı<br/>Feature Designer]
147
- FD --> SD[Aşama 3<br/>Sistem Tasarımı<br/>System Designer]
148
- SD --> DEV[Aşama 4<br/>Geliştirme<br/>System Developer]
149
- DEV --> TEST[Aşama 5<br/>Sistem Testi<br/>Test Manager]
150
- TEST --> ARCHIVE[Aşama 6<br/>Arşivleme]
151
-
152
- KB[(Bilgi Tabanı<br/>Tüm Süreç Boyunca)] -.-> PRD
153
- KB -.-> FD
154
- KB -.-> SD
155
- KB -.-> DEV
156
- KB -.-> TEST
157
- ```
158
-
159
- ### Temel İlkeler
160
-
161
- 1. **Aşama Bağımlılıkları**: Her aşamanın çıktısı bir sonraki aşamanın girdisidir
162
- 2. **Checkpoint Onayı**: Her aşamanın, bir sonraki aşamaya geçmeden önce kullanıcı onayı gerektiren bir onay noktası vardır
163
- 3. **Bilgi Tabanı Destekli**: Bilgi tabanı tüm süreç boyunca çalışır, tüm aşamalar için bağlam sağlar
164
-
165
- ---
166
-
167
- ## 6. Adım Sıfır: Bilgi Tabanı Başlatma
168
-
169
- Resmi mühendislik sürecini başlatmadan önce, proje bilgi tabanını başlatmanız gerekir.
170
-
171
- ### 6.1 Teknik Bilgi Tabanı Başlatma
172
-
173
- **Konuşma Örneği**:
174
- ```
175
- @speccrew-team-leader teknik bilgi tabanını başlat
176
- ```
177
-
178
- **Üç Aşamalı Süreç**:
179
- 1. Platform Algılama — Projedeki teknik platformları tanımla
180
- 2. Teknik Doküman Oluşturma — Her platform için teknik spesifikasyon belgeleri oluştur
181
- 3. İndeks Oluşturma — Bilgi tabanı indeksini oluştur
182
-
183
- **Çıktı**:
184
- ```
185
- speccrew-workspace/knowledges/techs/{platform-id}/
186
- ├── tech-stack.md # Teknoloji yığını tanımı
187
- ├── architecture.md # Mimari kurallar
188
- ├── dev-spec.md # Geliştirme spesifikasyonları
189
- ├── test-spec.md # Test spesifikasyonları
190
- └── INDEX.md # İndeks dosyası
191
- ```
192
-
193
- ### 6.2 İş Bilgi Tabanı Başlatma
194
-
195
- **Konuşma Örneği**:
196
- ```
197
- @speccrew-team-leader iş bilgi tabanını başlat
198
- ```
199
-
200
- **Dört Aşamalı Süreç**:
201
- 1. İşlev Envanteri — Tüm işlevleri tanımlamak için kodu tara
202
- 2. İşlev Analizi — Her işlev için iş mantığını analiz et
203
- 3. Modül Özeti — İşlevleri modüle göre özetle
204
- 4. Sistem Özeti — Sistem seviyesi iş genel görünümü oluştur
205
-
206
- **Çıktı**:
207
- ```
208
- speccrew-workspace/knowledges/bizs/
209
- ├── {platform-type}/
210
- │ └── {module-name}/
211
- │ └── feature-spec.md
212
- └── system-overview.md
213
- ```
214
-
215
- ---
216
-
217
- ## 7. Aşama Aşama Konuşma Kılavuzu
218
-
219
- ### 7.1 Aşama 1: Gereksinim Analizi (Product Manager)
220
-
221
- **Nasıl Başlatılır**:
222
- ```
223
- @speccrew-product-manager Yeni bir gereksinimim var: [gereksiniminizi açıklayın]
224
- ```
225
-
226
- **Agent İş Akışı**:
227
- 1. Mevcut modülleri anlamak için sistem genel görünümünü oku
228
- 2. Kullanıcı gereksinimlerini analiz et
229
- 3. Yapılandırılmış PRD belgesi oluştur
230
-
231
- **Çıktı**:
232
- ```
233
- iterations/{numara}-{tip}-{isim}/01.product-requirement/
234
- ├── [feature-name]-prd.md # Ürün Gereksinimleri Belgesi
235
- └── [feature-name]-bizs-modeling.md # İş modellemesi (karmaşık gereksinimler için)
236
- ```
237
-
238
- **Onay Kontrol Listesi**:
239
- - [ ] Gereksinim açıklaması kullanıcı niyetini doğru şekilde yansıtıyor mu?
240
- - [ ] İş kuralları eksiksiz mi?
241
- - [ ] Mevcut sistemlerle entegrasyon noktaları net mi?
242
- - [ ] Kabul kriterleri ölçülebilir mi?
243
-
244
- ---
245
-
246
- ### 7.2 Aşama 2: İşlev Tasarımı (Feature Designer)
247
-
248
- **Nasıl Başlatılır**:
249
- ```
250
- @speccrew-feature-designer işlev tasarımını başlat
251
- ```
252
-
253
- **Agent İş Akışı**:
254
- 1. Onaylanmış PRD belgesini otomatik olarak bul
255
- 2. İş bilgi tabanını yükle
256
- 3. İşlev tasarımı oluştur (UI wireframe'leri, etkileşim akışları, veri tanımları, API sözleşmeleri dahil)
257
- 4. Birden fazla PRD için paralel tasarım için Task Worker kullan
258
-
259
- **Çıktı**:
260
- ```
261
- iterations/{iter}/02.feature-design/
262
- └── [feature-name]-feature-spec.md # İşlev tasarım belgesi
263
- ```
264
-
265
- **Onay Kontrol Listesi**:
266
- - [ ] Tüm kullanıcı senaryoları kapsanıyor mu?
267
- - [ ] Etkileşim akışları net mi?
268
- - [ ] Veri alanı tanımları eksiksiz mi?
269
- - [ ] İstisna yönetimi kapsamlı mı?
270
-
271
- ---
272
-
273
- ### 7.3 Aşama 3: Sistem Tasarımı (System Designer)
274
-
275
- **Nasıl Başlatılır**:
276
- ```
277
- @speccrew-system-designer sistem tasarımını başlat
278
- ```
279
-
280
- **Agent İş Akışı**:
281
- 1. Feature Spec ve API Contract'ı bul
282
- 2. Teknik bilgi tabanını yükle (her platform için teknoloji yığını, mimari, spesifikasyonlar)
283
- 3. **Checkpoint A**: Framework Değerlendirmesi — Teknik boşlukları analiz et, yeni framework'ler öner (gerekirse), kullanıcı onayını bekle
284
- 4. DESIGN-OVERVIEW.md oluştur
285
- 5. Her platform için tasarımı paralel olarak dağıtmak için Task Worker kullan (frontend/backend/mobile/desktop)
286
- 6. **Checkpoint B**: Ortak Onay — Tüm platform tasarımlarının özetini göster, kullanıcı onayını bekle
287
-
288
- **Çıktı**:
289
- ```
290
- iterations/{iter}/03.system-design/
291
- ├── DESIGN-OVERVIEW.md # Tasarım genel görünümü
292
- ├── {platform-id}/
293
- │ ├── INDEX.md # Platform tasarım indeksi
294
- │ └── {module}-design.md # Sözde kod seviyesi modül tasarımı
295
- ```
296
-
297
- **Onay Kontrol Listesi**:
298
- - [ ] Sözde kod gerçek framework sözdizimini kullanıyor mu?
299
- - [ ] Platformlar arası API sözleşmeleri tutarlı mı?
300
- - [ ] Hata yönetimi stratejisi birleşik mi?
301
-
302
- ---
303
-
304
- ### 7.4 Aşama 4: Geliştirme (System Developer)
305
-
306
- **Nasıl Başlatılır**:
307
- ```
308
- @speccrew-system-developer geliştirmeyi başlat
309
- ```
310
-
311
- **Agent İş Akışı**:
312
- 1. Sistem tasarım belgelerini oku
313
- 2. Her platform için teknik bilgiyi yükle
314
- 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
315
- 4. Her platform için geliştirmeyi paralel olarak dağıtmak için Task Worker kullan
316
- 5. Entegrasyon kontrolü: API sözleşme hizalaması, veri tutarlılığı
317
- 6. Teslim raporu oluştur
318
-
319
- **Çıktı**:
320
- ```
321
- # Kaynak kod proje gerçek kaynak dizinine yazılır
322
- iterations/{iter}/04.development/
323
- ├── {platform-id}/
324
- │ └── tasks/ # Geliştirme görev kayıtları
325
- └── delivery-report.md
326
- ```
327
-
328
- **Onay Kontrol Listesi**:
329
- - [ ] Ortam hazır mı?
330
- - [ ] Entegrasyon sorunları kabul edilebilir aralıkta mı?
331
- - [ ] Kod geliştirme spesifikasyonlarına uygun mu?
332
-
333
- ---
334
-
335
- ### 7.5 Aşama 5: Sistem Testi (Test Manager)
336
-
337
- **Nasıl Başlatılır**:
338
- ```
339
- @speccrew-test-manager testleri başlat
340
- ```
341
-
342
- **Üç Aşamalı Test Süreci**:
343
-
344
- | Aşama | Açıklama | Checkpoint |
345
- |-------|-------------|------------|
346
- | 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 |
347
- | 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 |
348
- | Test Yürütme ve Hata Raporlama | Testleri otomatik olarak yürüt ve raporlar oluştur | Yok (otomatik yürütme) |
349
-
350
- **Çıktı**:
351
- ```
352
- iterations/{iter}/05.system-test/
353
- ├── cases/
354
- │ └── {platform-id}/ # Test vaka belgeleri
355
- ├── code/
356
- │ └── {platform-id}/ # Test kodu planı
357
- ├── reports/
358
- │ └── test-report-{date}.md # Test raporu
359
- └── bugs/
360
- └── BUG-{id}-{title}.md # Hata raporları (hata başına bir dosya)
361
- ```
362
-
363
- **Onay Kontrol Listesi**:
364
- - [ ] Vaka kapsamı eksiksiz mi?
365
- - [ ] Test kodu yürütülebilir mi?
366
- - [ ] Hata önem derecelendirmesi doğru mu?
367
-
368
- ---
369
-
370
- ### 7.6 Aşama 6: Arşivleme
371
-
372
- İterasyonlar tamamlandıktan sonra otomatik olarak arşivlenir:
373
-
374
- ```
375
- speccrew-workspace/iteration-archives/
376
- └── {numara}-{tip}-{isim}-{tarih}/
377
- ├── 01.product-requirement/
378
- ├── 02.feature-design/
379
- ├── 03.system-design/
380
- ├── 04.development/
381
- └── 05.system-test/
382
- ```
383
-
384
- ---
385
-
386
- ## 8. Bilgi Tabanı Genel Bakış
387
-
388
- ### 8.1 İş Bilgi Tabanı (bizs)
389
-
390
- **Amaç**: Proje iş işlevi açıklamalarını, modül bölümlerini, API özelliklerini sakla
391
-
392
- **Dizin Yapısı**:
393
- ```
394
- knowledges/bizs/
395
- ├── {platform-type}/
396
- │ └── {module-name}/
397
- │ └── feature-spec.md
398
- └── system-overview.md
399
- ```
400
-
401
- **Kullanım Senaryoları**: Product Manager, Feature Designer
402
-
403
- ### 8.2 Teknik Bilgi Tabanı (techs)
404
-
405
- **Amaç**: Proje teknoloji yığınını, mimari kurallarını, geliştirme spesifikasyonlarını, test spesifikasyonlarını sakla
406
-
407
- **Dizin Yapısı**:
408
- ```
409
- knowledges/techs/{platform-id}/
410
- ├── tech-stack.md
411
- ├── architecture.md
412
- ├── dev-spec.md
413
- ├── test-spec.md
414
- └── INDEX.md
415
- ```
416
-
417
- **Kullanım Senaryoları**: System Designer, System Developer, Test Manager
418
-
419
- ---
420
-
421
- ## 9. İş Akışı İlerleme Yönetimi
422
-
423
- 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.
424
-
425
- ### 9.1 Üç Katmanlı İlerleme Dosyaları
426
-
427
- İş akışı, iterasyon dizininde bulunan üç tür JSON ilerleme dosyasını otomatik olarak sürdürür:
428
-
429
- | Dosya | Konum | Amaç |
430
- |------|----------|---------|
431
- | `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Her pipeline aşamasının durumunu kaydeder |
432
- | `.checkpoints.json` | Her aşama dizini altında | Kullanıcı checkpoint onay durumunu kaydeder |
433
- | `DISPATCH-PROGRESS.json` | Her aşama dizini altında | Paralel görevler için öğe öğe ilerlemeyi kaydeder (çoklu platform/çoklu modül) |
434
-
435
- ### 9.2 Aşama Durum Akışı
436
-
437
- Her aşama bu durum akışını izler:
438
-
439
- ```
440
- pending → in_progress → completed → confirmed
441
- ```
442
-
443
- - **pending**: Henüz başlatılmadı
444
- - **in_progress**: Yürütülüyor
445
- - **completed**: Agent yürütmesi tamamlandı, kullanıcı onayı bekleniyor
446
- - **confirmed**: Kullanıcı son checkpoint üzerinden onayladı, sonraki aşama başlayabilir
447
-
448
- ### 9.3 Yeniden Başlatılabilir Yürütme
449
-
450
- Bir aşama için Agent'ı yeniden başlatırken:
451
-
452
- 1. **Otomatik upstream kontrolü**: Önceki aşamanın onaylanıp onaylanmadığını doğrular, onaylanmadıysa engeller ve ister
453
- 2. **Checkpoint kurtarma**: `.checkpoints.json` okur, geçen checkpoint'leri atlar, son kesinti noktasından devam eder
454
- 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
455
-
456
- ### 9.4 Mevcut İlerlemeyi Görüntüle
457
-
458
- Team Leader Agent üzerinden pipeline panorama durumunu görüntüle:
459
-
460
- ```
461
- @speccrew-team-leader mevcut iterasyon ilerlemesini görüntüle
462
- ```
463
-
464
- Team Leader ilerleme dosyalarını okuyacak ve şuna benzer bir durum genel görünümü gösterecek:
465
-
466
- ```
467
- Pipeline Status: i001-user-management
468
- 01 PRD: ✅ Confirmed
469
- 02 Feature Design: 🔄 In Progress (Checkpoint A passed)
470
- 03 System Design: ⏳ Pending
471
- 04 Development: ⏳ Pending
472
- 05 System Test: ⏳ Pending
473
- ```
474
-
475
- ### 9.5 Geriye Dönük Uyumluluk
476
-
477
- İ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.
478
-
479
- ---
480
-
481
- ## 10. Sıkça Sorulan Sorular (SSS)
482
-
483
- ### S1: Agent beklenildiği gibi çalışmazsa ne yapmalıyım?
484
-
485
- 1. Yükleme bütünlüğünü kontrol etmek için `speccrew doctor` çalıştır
486
- 2. Bilgi tabanının başlatıldığını onayla
487
- 3. Önceki aşamanın çıktısının mevcut iterasyon dizininde olduğunu onayla
488
-
489
- ### S2: Bir aşamayı nasıl atlarım?
490
-
491
- **Önerilmez** — Her aşamanın çıktısı bir sonraki aşamanın girdisidir.
492
-
493
- Atlamanız gerekirse, ilgili aşamanın giriş belgesini manuel olarak hazırlayın ve format spesifikasyonlarına uygun olduğundan emin olun.
494
-
495
- ### S3: Birden fazla paralel gereksinimi nasıl yönetirim?
496
-
497
- Her gereksinim için bağımsız iterasyon dizinleri oluşturun:
498
- ```
499
- iterations/
500
- ├── 001-feature-xxx/
501
- ├── 002-feature-yyy/
502
- └── 003-feature-zzz/
503
- ```
504
-
505
- Her iterasyon tamamen izole edilmiştir ve diğerlerini etkilemez.
506
-
507
- ### S4: SpecCrew sürümünü nasıl güncellerim?
508
-
509
- Güncelleme iki adım gerektirir:
510
-
511
- ```bash
512
- # Adım 1: Global CLI aracını güncelle
513
- npm install -g speccrew@latest
514
-
515
- # Adım 2: Proje dizininde Agent'ları ve Skill'leri senkronize et
516
- cd /path/to/your-project
517
- speccrew update
518
- ```
519
-
520
- - `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)
521
- - `speccrew update`: Projenizdeki Agent ve Skill tanım dosyalarını en son sürüme senkronize eder
522
- - `speccrew update --ide cursor`: Sadece belirli IDE için yapılandırmayı günceller
523
-
524
- > **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.
525
-
526
- ### 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?
527
-
528
- Bu genellikle npm önbelleğinden kaynaklanır. Çözüm:
529
-
530
- ```bash
531
- # npm önbelleğini temizle ve yeniden yükle
532
- npm cache clean --force
533
- npm install -g speccrew@latest
534
-
535
- # Sürümü doğrula
536
- npm list -g speccrew
537
- ```
538
-
539
- Hala çalışmıyorsa, belirli bir sürüm numarası ile yüklemeyi deneyin:
540
- ```bash
541
- npm install -g speccrew@0.5.6
542
- ```
543
-
544
- ### S6: Geçmiş iterasyonları nasıl görüntülerim?
545
-
546
- Arşivlemeden sonra, `speccrew-workspace/iteration-archives/` içinde görüntüleyin, `{numara}-{tip}-{isim}-{tarih}/` formatına göre düzenlenmiş.
547
-
548
- ### S7: Bilgi tabanının düzenli olarak güncellenmesi gerekir mi?
549
-
550
- Aşağıdaki durumlarda yeniden başlatma gereklidir:
551
- - Proje yapısında büyük değişiklikler
552
- - Teknoloji yığını yükseltmesi veya değişimi
553
- - İş modüllerinin eklenmesi/kaldırılması
554
-
555
- ---
556
-
557
- ## 11. Hızlı Başvuru
558
-
559
- ### Agent Başlatma Hızlı Başvurusu
560
-
561
- | Aşama | Agent | Başlatma Konuşması |
562
- |-------|-------|-------------------|
563
- | Başlatma | Team Leader | `@speccrew-team-leader teknik bilgi tabanını başlat` |
564
- | Gereksinim Analizi | Product Manager | `@speccrew-product-manager Yeni bir gereksinimim var: [açıklama]` |
565
- | İşlev Tasarımı | Feature Designer | `@speccrew-feature-designer işlev tasarımını başlat` |
566
- | Sistem Tasarımı | System Designer | `@speccrew-system-designer sistem tasarımını başlat` |
567
- | Geliştirme | System Developer | `@speccrew-system-developer geliştirmeyi başlat` |
568
- | Sistem Testi | Test Manager | `@speccrew-test-manager testleri başlat` |
569
-
570
- ### Checkpoint Kontrol Listesi
571
-
572
- | Aşama | Checkpoint Sayısı | Ana Kontrol Öğeleri |
573
- |-------|----------------------|-----------------|
574
- | Gereksinim Analizi | 1 | Gereksinim doğruluğu, iş kuralı bütünlüğü, kabul kriteri ölçülebilirliği |
575
- | İşlev Tasarımı | 1 | Senaryo kapsamı, etkileşim netliği, veri bütünlüğü, istisna yönetimi |
576
- | Sistem Tasarımı | 2 | A: Framework değerlendirmesi; B: Sözde kod sözdizimi, platformlar arası tutarlılık, hata yönetimi |
577
- | Geliştirme | 1 | A: Ortam hazır olması, entegrasyon sorunları, kod spesifikasyonları |
578
- | Sistem Testi | 2 | A: Vaka kapsamı; B: Test kodu yürütülebilirliği |
579
-
580
- ### Çıktı Yolu Hızlı Başvurusu
581
-
582
- | Aşama | Çıktı Dizini | Dosya Formatı |
583
- |-------|-----------------|-------------|
584
- | Gereksinim Analizi | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
585
- | İşlev Tasarımı | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
586
- | Sistem Tasarımı | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
587
- | Geliştirme | `iterations/{iter}/04.development/` | Kaynak kod + `delivery-report.md` |
588
- | Sistem Testi | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
589
- | Arşivleme | `iteration-archives/{iter}-{date}/` | Tam iterasyon kopyası |
590
-
591
- ---
592
-
593
- ## Sonraki Adımlar
594
-
595
- 1. Projenizi başlatmak için `speccrew init --ide qoder` çalıştırın
596
- 2. Adım Sıfır'ı yürütün: Bilgi Tabanı Başlatma
597
- 3. İş akışına göre aşama aşama ilerleyin, spesifikasyon destekli geliştirme deneyiminin keyfini çıkarın!