speccrew 0.5.6 → 0.5.7

package/docs/GETTING-STARTED.tr.md

@@ -90,28 +90,11 @@ flowchart LR
 
 ---
 
-## 3. Sıfırıncı Adım: Proje Teşhisi ve Bilgi Tabanı Başlatma
+## 3. Sıfırıncı Adım: Bilgi Tabanı Başlatma
 
 Resmi mühendislik sürecini başlatmadan önce proje bilgi tabanını başlatmanız gerekir.
 
-### 3.1 Proje Teşhisi
-
-**Örnek Konuşma**:
-```
-@speccrew-team-leader projeyi teşhis et
-```
-
-**Ajan Ne Yapacak**:
-- Proje yapısını tara
-- Teknoloji yığınını tespit et
-- İş modüllerini tanımla
-
-**Çıktı**:
-```
-speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
-```
-
-### 3.2 Teknik Bilgi Tabanı Başlatma
+### 3.1 Teknik Bilgi Tabanı Başlatma
 
 **Örnek Konuşma**:
 ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # İndeks dosyası
 ```
 
-### 3.3 İş Bilgi Tabanı Başlatma
+### 3.2 İş Bilgi Tabanı Başlatma
 
 **Örnek Konuşma**:
 ```
@@ -466,11 +449,24 @@ speccrew update
 
 > **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: Geçmiş iterasyonları nasıl görüntülerim?
+### S5: `speccrew update` yeni sürüm gösteriyor ancak kurulumdan sonra hala eski sürüm?
+
+Genellikle npm önbelleğinden kaynaklanır. Çözüm:
+```bash
+npm cache clean --force
+npm install -g speccrew@latest
+npm list -g speccrew
+```
+Hala çalışmazsa, belirli bir sürüm yükleyin:
+```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.
 
-### S6: Bilgi tabanının düzenli olarak güncellenmesi gerekiyor mu?
+### S7: Bilgi tabanının düzenli olarak güncellenmesi gerekiyor mu?
 
 Aşağıdaki durumlarda yeniden başlatma gerekir:
 - Proje yapısında önemli değişiklikler
@@ -485,7 +481,6 @@ Aşağıdaki durumlarda yeniden başlatma gerekir:
 
 | Aşama | Ajan | Başlangıç Konuşması |
 |------|-------|-------------------|
-| Teşhis | Team Leader | `@speccrew-team-leader projeyi teşhis et` |
 | 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` |
@@ -519,5 +514,5 @@ Aşağıdaki durumlarda yeniden başlatma gerekir:
 ## 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: Proje Teşhisi ve Bilgi Tabanı Başlatma
+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!

package/docs/GETTING-STARTED.uk.md

@@ -90,28 +90,11 @@ flowchart LR
 
 ---
 
-## 3. Нульовий Крок: Діагностика Проекту та Ініціалізація Бази Знань
+## 3. Нульовий Крок: Ініціалізація Бази Знань
 
 Перед початком формального інженерного процесу необхідно ініціалізувати базу знань проекту.
 
-### 3.1 Діагностика Проекту
-
-**Приклад Діалогу**:
-```
-@speccrew-team-leader діагностувати проект
-```
-
-**Що Зробить Агент**:
-- Сканування структури проекту
-- Виявлення технологічного стеку
-- Ідентифікація бізнес-модулів
-
-**Результат**:
-```
-speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
-```
-
-### 3.2 Ініціалізація Технічної Бази Знань
+### 3.1 Ініціалізація Технічної Бази Знань
 
 **Приклад Діалогу**:
 ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # Файл індексу
 ```
 
-### 3.3 Ініціалізація Бізнес-Бази Знань
+### 3.2 Ініціалізація Бізнес-Бази Знань
 
 **Приклад Діалогу**:
 ```
@@ -466,11 +449,24 @@ speccrew update
 
 > **Примітка**: Обидва етапи обов'язкові. Виконання тільки `speccrew update` не оновить сам CLI-інструмент; виконання тільки `npm install` не оновить файли проекту.
 
-### П5: Як переглянути історичні ітерації?
+### П5: `speccrew update` показує нову версію, але після встановлення все ще стара?
+
+Зазвичай це викликано кешем npm. Рішення:
+```bash
+npm cache clean --force
+npm install -g speccrew@latest
+npm list -g speccrew
+```
+Якщо все ще не працює, встановіть конкретну версію:
+```bash
+npm install -g speccrew@0.5.6
+```
+
+### П6: Як переглянути історичні ітерації?
 
 Після архівування перегляньте в `speccrew-workspace/iteration-archives/`, організовано у форматі `{номер}-{тип}-{ім'я}-{дата}/`.
 
-### П6: Чи база знань потребує регулярного оновлення?
+### П7: Чи база знань потребує регулярного оновлення?
 
 Реініціалізація потрібна в наступних ситуаціях:
 - Значні зміни структури проекту
@@ -485,7 +481,6 @@ speccrew update
 
 | Етап | Агент | Початковий Діалог |
 |------|-------|-------------------|
-| Діагностика | Team Leader | `@speccrew-team-leader діагностувати проект` |
 | Ініціалізація | Team Leader | `@speccrew-team-leader ініціалізувати технічну базу знань` |
 | Аналіз Вимог | Product Manager | `@speccrew-product-manager у мене нова вимога: [опис]` |
 | Проектування Функцій | Feature Designer | `@speccrew-feature-designer розпочати проектування функцій` |
@@ -519,5 +514,5 @@ speccrew update
 ## Наступні Кроки
 
 1. Виконайте `speccrew init --ide qoder` для ініціалізації вашого проекту
-2. Виконайте Нульовий Крок: Діагностика Проекту та Ініціалізація Бази Знань
+2. Виконайте Нульовий Крок: Ініціалізація Бази Знань
 3. Просувайтесь через кожен етап слідуючи робочому процесу, насолоджуйтесь досвідом розробки на основі специфікацій!

package/docs/GETTING-STARTED.vi.md

@@ -90,28 +90,11 @@ flowchart LR
 
 ---
 
-## 3. Bước Không: Chẩn Đoán Dự Án và Khởi Tạo Cơ Sở Kiến Thức
+## 3. Bước Không: Khởi Tạo Cơ Sở Kiến Thức
 
 Trước khi bắt đầu quy trình kỹ thuật chính thức, bạn cần khởi tạo cơ sở kiến thức của dự án.
 
-### 3.1 Chẩn Đoán Dự Án
-
-**Ví Dụ Hội Thoại**:
-```
-@speccrew-team-leader chẩn đoán dự án
-```
-
-**Agent Sẽ Làm Gì**:
-- Quét cấu trúc dự án
-- Phát hiện công nghệ stack
-- Xác định các module nghiệp vụ
-
-**Kết Quả**:
-```
-speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
-```
-
-### 3.2 Khởi Tạo Cơ Sở Kiến Thức Kỹ Thuật
+### 3.1 Khởi Tạo Cơ Sở Kiến Thức Kỹ Thuật
 
 **Ví Dụ Hội Thoại**:
 ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # Tệp chỉ mục
 ```
 
-### 3.3 Khởi Tạo Cơ Sở Kiến Thức Nghiệp Vụ
+### 3.2 Khởi Tạo Cơ Sở Kiến Thức Nghiệp Vụ
 
 **Ví Dụ Hội Thoại**:
 ```
@@ -466,11 +449,24 @@ speccrew update
 
 > **Lưu ý**: Cả hai bước đều cần thiết. Chỉ chạy `speccrew update` sẽ không cập nhật chính công cụ CLI; chỉ chạy `npm install` sẽ không cập nhật các tệp dự án.
 
-### H5: Làm thế nào để xem các iteration lịch sử?
+### H5: `speccrew update` hiển thị phiên bản mới nhưng sau cài đặt vẫn là phiên bản cũ?
+
+Thường do bộ nhớ cache npm. Cách giải quyết:
+```bash
+npm cache clean --force
+npm install -g speccrew@latest
+npm list -g speccrew
+```
+Nếu vẫn không được, hãy cài đặt phiên bản cụ thể:
+```bash
+npm install -g speccrew@0.5.6
+```
+
+### H6: Làm thế nào để xem các iteration lịch sử?
 
 Sau khi lưu trữ, xem trong `speccrew-workspace/iteration-archives/`, được tổ chức theo định dạng `{số}-{loại}-{tên}-{ngày}/`.
 
-### H6: Cơ sở kiến thức có cần cập nhật thường xuyên không?
+### H7: Cơ sở kiến thức có cần cập nhật thường xuyên không?
 
 Cần khởi tạo lại trong các tình huống sau:
 - Thay đổi đáng kể về cấu trúc dự án
@@ -485,7 +481,6 @@ Cần khởi tạo lại trong các tình huống sau:
 
 | Giai Đoạn | Agent | Hội Thoại Bắt Đầu |
 |------|-------|-------------------|
-| Chẩn Đoán | Team Leader | `@speccrew-team-leader chẩn đoán dự án` |
 | Khởi Tạo | Team Leader | `@speccrew-team-leader khởi tạo cơ sở kiến thức kỹ thuật` |
 | Phân Tích Yêu Cầu | Product Manager | `@speccrew-product-manager tôi có yêu cầu mới: [mô tả]` |
 | Thiết Kế Tính Năng | Feature Designer | `@speccrew-feature-designer bắt đầu thiết kế tính năng` |
@@ -519,5 +514,5 @@ Cần khởi tạo lại trong các tình huống sau:
 ## 9. Bước Tiếp Theo
 
 1. Chạy `speccrew init --ide qoder` để khởi tạo dự án của bạn
-2. Thực hiện Bước Không: Chẩn Đoán Dự Án và Khởi Tạo Cơ Sở Kiến Thức
+2. Thực hiện Bước Không: Khởi Tạo Cơ Sở Kiến Thức
 3. Tiến bộ qua từng giai đoạn theo quy trình làm việc, tận hưởng trải nghiệm phát triển dựa trên đặc tả!

package/docs/GETTING-STARTED.zh-TW.md

@@ -89,28 +89,11 @@ flowchart LR
 
 ---
 
-## 3. 第零步：專案診斷與知識庫初始化
+## 3. 第零步：知識庫初始化
 
 在開始正式工程流程前，需要先初始化專案知識庫。
 
-### 3.1 專案診斷
-
-**對話範例**：
-```
-@speccrew-team-leader 診斷專案
-```
-
-**Agent 會做什麼**：
-- 掃描專案結構
-- 偵測技術棧
-- 識別業務模組
-
-**產出物**：
-```
-speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
-```
-
-### 3.2 技術知識庫初始化
+### 3.1 技術知識庫初始化
 
 **對話範例**：
 ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # 索引檔案
 ```
 
-### 3.3 業務知識庫初始化
+### 3.2 業務知識庫初始化
 
 **對話範例**：
 ```
@@ -465,11 +448,29 @@ speccrew update
 
 > **注意**：兩個步驟都需要執行。只執行 `speccrew update` 不會更新 CLI 工具本身；只執行 `npm install` 不會更新專案檔案。
 
-### Q5: 如何查看歷史迭代？
+### Q5: `speccrew update` 顯示有新版本可用，但 `npm install -g speccrew@latest` 仍然安裝舊版本？
+
+這通常是 npm 緩存造成的。解決方法：
+
+```bash
+# 清除 npm 緩存並重新安裝
+npm cache clean --force
+npm install -g speccrew@latest
+
+# 驗證版本
+npm list -g speccrew
+```
+
+如果仍然無效，嘗試使用特定版本號安裝：
+```bash
+npm install -g speccrew@0.5.6
+```
+
+### Q6: 如何查看歷史迭代？
 
 歸檔後在 `speccrew-workspace/iteration-archives/` 中查看，按 `{序號}-{類型}-{名稱}-{日期}/` 格式組織。
 
-### Q6: 知識庫需要定期更新嗎？
+### Q7: 知識庫需要定期更新嗎？
 
 以下情況需要重新初始化：
 - 專案結構發生重大變化
@@ -484,7 +485,6 @@ speccrew update
 
 | 階段 | Agent | 啟動對話 |
 |------|-------|----------|
-| 診斷 | Team Leader | `@speccrew-team-leader 診斷專案` |
 | 初始化 | Team Leader | `@speccrew-team-leader 初始化技術知識庫` |
 | 需求分析 | Product Manager | `@speccrew-product-manager 我有一個新需求：[描述]` |
 | 功能設計 | Feature Designer | `@speccrew-feature-designer 開始功能設計` |
@@ -518,5 +518,5 @@ speccrew update
 ## 9. 下一步
 
 1. 執行 `speccrew init --ide qoder` 初始化您的專案
-2. 執行第零步：專案診斷與知識庫初始化
+2. 執行第零步：知識庫初始化
 3. 按照工作流程逐階段推進，享受規範驅動的開發體驗！

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {