speccrew 0.5.5 → 0.5.7

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.
@@ -89,28 +89,11 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. Fase Zero: Diagnostica Progetto e Inizializzazione Base Conoscenza
92
+ ## 3. Inizializzazione Base Conoscenza
93
93
 
94
94
  Prima di iniziare il processo di ingegneria formale, devi inizializzare la base di conoscenza del progetto.
95
95
 
96
- ### 3.1 Diagnostica Progetto
97
-
98
- **Esempio Conversazione**:
99
- ```
100
- @speccrew-team-leader diagnosticare il progetto
101
- ```
102
-
103
- **Cosa farà l'Agent**:
104
- - Scansionare la struttura del progetto
105
- - Rilevare lo stack tecnologico
106
- - Identificare i moduli business
107
-
108
- **Deliverable**:
109
- ```
110
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
111
- ```
112
-
113
- ### 3.2 Inizializzazione Base Conoscenza Tecnica
96
+ ### 3.1 Inizializzazione Base Conoscenza Tecnica
114
97
 
115
98
  **Esempio Conversazione**:
116
99
  ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
115
  └── INDEX.md # File indice
133
116
  ```
134
117
 
135
- ### 3.3 Inizializzazione Base Conoscenza Business
118
+ ### 3.2 Inizializzazione Base Conoscenza Business
136
119
 
137
120
  **Esempio Conversazione**:
138
121
  ```
@@ -465,11 +448,26 @@ speccrew update
465
448
 
466
449
  > **Nota**: Entrambi i passaggi devono essere eseguiti. Eseguire solo `speccrew update` non aggiornerà lo strumento CLI stesso; eseguire solo `npm install` non aggiornerà i file nel progetto.
467
450
 
468
- ### Q5: Come visualizzare le iterazioni storiche?
451
+ ### Q5: `speccrew update` mostra una nuova versione ma dopo l'installazione è ancora la vecchia?
452
+
453
+ Solitamente è causato dalla cache npm. Soluzione:
454
+
455
+ ```bash
456
+ npm cache clean --force
457
+ npm install -g speccrew@latest
458
+ npm list -g speccrew
459
+ ```
460
+
461
+ Se ancora non funziona, specifica il numero di versione:
462
+ ```bash
463
+ npm install -g speccrew@0.5.6
464
+ ```
465
+
466
+ ### Q6: Come visualizzare le iterazioni storiche?
469
467
 
470
468
  Dopo l'archiviazione, visualizzare in `speccrew-workspace/iteration-archives/`, organizzate per formato `{numero}-{tipo}-{nome}-{date}/`.
471
469
 
472
- ### Q6: La base di conoscenza necessita di aggiornamenti regolari?
470
+ ### Q7: La base di conoscenza necessita di aggiornamenti regolari?
473
471
 
474
472
  La re-inizializzazione è necessaria nelle seguenti situazioni:
475
473
  - Cambiamenti importanti nella struttura del progetto
@@ -484,7 +482,7 @@ La re-inizializzazione è necessaria nelle seguenti situazioni:
484
482
 
485
483
  | Fase | Agent | Conversazione di Avvio |
486
484
  |------|-------|------------------------|
487
- | Diagnostica | Team Leader | `@speccrew-team-leader diagnosticare il progetto` |
485
+
488
486
  | Inizializzazione | Team Leader | `@speccrew-team-leader inizializzare la base conoscenza tecnica` |
489
487
  | Analisi Requisiti | Product Manager | `@speccrew-product-manager Ho un nuovo requisito: [descrizione]` |
490
488
  | Feature Design | Feature Designer | `@speccrew-feature-designer iniziare il feature design` |
@@ -518,5 +516,5 @@ La re-inizializzazione è necessaria nelle seguenti situazioni:
518
516
  ## Prossimi Passi
519
517
 
520
518
  1. Eseguire `speccrew init --ide qoder` per inizializzare il tuo progetto
521
- 2. Eseguire la Fase Zero: Diagnostica Progetto e Inizializzazione Base Conoscenza
519
+ 2. Eseguire l'inizializzazione della Base Conoscenza
522
520
  3. Procedere attraverso ogni fase seguendo il workflow, godendoti l'esperienza di sviluppo specification-driven!
@@ -89,28 +89,11 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. ステップ0:プロジェクト診断とナレッジベース初期化
92
+ ## 3. ステップ0:ナレッジベース初期化
93
93
 
94
94
  正式なエンジニアリングフローを開始する前に、プロジェクトナレッジベースを初期化する必要があります。
95
95
 
96
- ### 3.1 プロジェクト診断
97
-
98
- **会話例**:
99
- ```
100
- @speccrew-team-leader プロジェクトを診断
101
- ```
102
-
103
- **エージェントの動作**:
104
- - プロジェクト構造をスキャン
105
- - テクノロジースタックを検出
106
- - ビジネスモジュールを識別
107
-
108
- **成果物**:
109
- ```
110
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
111
- ```
112
-
113
- ### 3.2 テクニカルナレッジベース初期化
96
+ ### 3.1 テクニカルナレッジベース初期化
114
97
 
115
98
  **会話例**:
116
99
  ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
115
  └── INDEX.md # インデックスファイル
133
116
  ```
134
117
 
135
- ### 3.3 ビジネスナレッジベース初期化
118
+ ### 3.2 ビジネスナレッジベース初期化
136
119
 
137
120
  **会話例**:
138
121
  ```
@@ -465,11 +448,29 @@ speccrew update
465
448
 
466
449
  > **注意**:両方のステップを実行する必要があります。`speccrew update`のみを実行してもCLIツール自体は更新されません;`npm install`のみを実行してもプロジェクト内のファイルは更新されません。
467
450
 
468
- ### Q5: 過去のイテレーションを表示するには?
451
+ ### Q5: `speccrew update` で新バージョンが利用可能と表示されるが、`npm install -g speccrew@latest` でも古いバージョンがインストールされる?
452
+
453
+ これは通常npmキャッシュが原因です。解決方法:
454
+
455
+ ```bash
456
+ # npmキャッシュをクリアして再インストール
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+
460
+ # バージョンを確認
461
+ npm list -g speccrew
462
+ ```
463
+
464
+ それでも解決しない場合は、特定のバージョン番号を指定してインストールしてみてください:
465
+ ```bash
466
+ npm install -g speccrew@0.5.6
467
+ ```
468
+
469
+ ### Q6: 過去のイテレーションを表示するには?
469
470
 
470
471
  アーカイブ後、`speccrew-workspace/iteration-archives/`で表示、`{シーケンス}-{タイプ}-{名前}-{日付}/`形式で整理。
471
472
 
472
- ### Q6: ナレッジベースは定期的に更新が必要ですか?
473
+ ### Q7: ナレッジベースは定期的に更新が必要ですか?
473
474
 
474
475
  以下の場合は再初期化が必要です:
475
476
  - プロジェクト構造が大幅に変更
@@ -484,7 +485,6 @@ speccrew update
484
485
 
485
486
  | フェーズ | エージェント | 起動会話 |
486
487
  |------|-------|----------|
487
- | 診断 | Team Leader | `@speccrew-team-leader プロジェクトを診断` |
488
488
  | 初期化 | Team Leader | `@speccrew-team-leader テクニカルナレッジベースを初期化` |
489
489
  | 要件分析 | Product Manager | `@speccrew-product-manager 新しい要件があります:[説明]` |
490
490
  | 機能設計 | Feature Designer | `@speccrew-feature-designer 機能設計を開始` |
@@ -518,5 +518,5 @@ speccrew update
518
518
  ## 9. 次のステップ
519
519
 
520
520
  1. `speccrew init --ide qoder`を実行してプロジェクトを初期化
521
- 2. ステップ0を実行:プロジェクト診断とナレッジベース初期化
521
+ 2. ステップ0を実行:ナレッジベース初期化
522
522
  3. ワークフローに従ってフェーズごとに進め、仕様駆動の開発体験を楽しんでください!
@@ -89,7 +89,7 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. 0단계: 프로젝트 진단 및 지식 기반 초기화
92
+ ## 3. 0단계: 지식 기반 초기화
93
93
 
94
94
  공식 엔지니어링 프로세스를 시작하기 전에 프로젝트 지식 기반을 초기화해야 합니다.
95
95
 
@@ -132,7 +132,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
132
  └── INDEX.md # 인덱스 파일
133
133
  ```
134
134
 
135
- ### 3.3 비즈니스 지식 기반 초기화
135
+ ### 3.2 비즈니스 지식 기반 초기화
136
136
 
137
137
  **대화 예시**:
138
138
  ```
@@ -469,7 +469,7 @@ speccrew update
469
469
 
470
470
  보관 후 `speccrew-workspace/iteration-archives/`에서 `{번호}-{유형}-{이름}-{날짜}/` 형식으로 확인할 수 있습니다.
471
471
 
472
- ### Q6: 지식 기반을 정기적으로 업데이트해야 하나요?
472
+ ### Q7: 지식 기반을 정기적으로 업데이트해야 하나요?
473
473
 
474
474
  다음 상황에서 재초기화가 필요합니다:
475
475
  - 프로젝트 구조의 주요 변경
@@ -518,5 +518,5 @@ speccrew update
518
518
  ## 9. 다음 단계
519
519
 
520
520
  1. `speccrew init --ide qoder`를 실행하여 프로젝트 초기화
521
- 2. 0단계 실행: 프로젝트 진단 및 지식 기반 초기화
521
+ 2. 0단계 실행: 지식 기반 초기화
522
522
  3. 워크플로우에 따라 각 단계를 진행하며 명세 기반 개발 경험을 즐기세요!
@@ -89,28 +89,11 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. 第零步:项目诊断与知识库初始化
92
+ ## 3. 第零步:知识库初始化
93
93
 
94
94
  在开始正式工程流程前,需要先初始化项目知识库。
95
95
 
96
- ### 3.1 项目诊断
97
-
98
- **对话示例**:
99
- ```
100
- @speccrew-team-leader 诊断项目
101
- ```
102
-
103
- **Agent 会做什么**:
104
- - 扫描项目结构
105
- - 检测技术栈
106
- - 识别业务模块
107
-
108
- **产出物**:
109
- ```
110
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
111
- ```
112
-
113
- ### 3.2 技术知识库初始化
96
+ ### 3.1 技术知识库初始化
114
97
 
115
98
  **对话示例**:
116
99
  ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
115
  └── INDEX.md # 索引文件
133
116
  ```
134
117
 
135
- ### 3.3 业务知识库初始化
118
+ ### 3.2 业务知识库初始化
136
119
 
137
120
  **对话示例**:
138
121
  ```
@@ -465,11 +448,29 @@ speccrew update
465
448
 
466
449
  > **注意**:两步都需要执行。仅执行 `speccrew update` 不会更新 CLI 工具本身;仅执行 `npm install` 不会更新项目中的文件。
467
450
 
468
- ### Q5: 如何查看历史迭代?
451
+ ### Q5: `speccrew update` 提示有新版本但 `npm install -g speccrew@latest` 安装后仍是旧版本?
452
+
453
+ 这通常是 npm 缓存问题。解决方法:
454
+
455
+ ```bash
456
+ # 清除 npm 缓存后重新安装
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+
460
+ # 验证版本
461
+ npm list -g speccrew
462
+ ```
463
+
464
+ 如果仍然不行,尝试指定具体版本号安装:
465
+ ```bash
466
+ npm install -g speccrew@0.5.6
467
+ ```
468
+
469
+ ### Q6: 如何查看历史迭代?
469
470
 
470
471
  归档后在 `speccrew-workspace/iteration-archives/` 中查看,按 `{序号}-{类型}-{名称}-{日期}/` 格式组织。
471
472
 
472
- ### Q6: 知识库需要定期更新吗?
473
+ ### Q7: 知识库需要定期更新吗?
473
474
 
474
475
  以下情况需要重新初始化:
475
476
  - 项目结构发生重大变化
@@ -484,7 +485,6 @@ speccrew update
484
485
 
485
486
  | 阶段 | Agent | 启动对话 |
486
487
  |------|-------|----------|
487
- | 诊断 | Team Leader | `@speccrew-team-leader 诊断项目` |
488
488
  | 初始化 | Team Leader | `@speccrew-team-leader 初始化技术知识库` |
489
489
  | 需求分析 | Product Manager | `@speccrew-product-manager 我有一个新需求:[描述]` |
490
490
  | 功能设计 | Feature Designer | `@speccrew-feature-designer 开始功能设计` |
@@ -518,5 +518,5 @@ speccrew update
518
518
  ## 下一步
519
519
 
520
520
  1. 运行 `speccrew init --ide qoder` 初始化您的项目
521
- 2. 执行第零步:项目诊断与知识库初始化
521
+ 2. 执行第零步:知识库初始化
522
522
  3. 按照工作流程逐阶段推进,享受规范驱动的开发体验!
@@ -90,28 +90,11 @@ flowchart LR
90
90
 
91
91
  ---
92
92
 
93
- ## 3. Null Steg: Prosjektdiagnose og Kunnskapsbase-initialisering
93
+ ## 3. Kunnskapsbase-initialisering
94
94
 
95
95
  Før du starter den formelle ingeniørprosessen, må du initialisere prosjektets kunnskapsbase.
96
96
 
97
- ### 3.1 Prosjektdiagnose
98
-
99
- **Eksempel på Dialog**:
100
- ```
101
- @speccrew-team-leader diagnostiser prosjekt
102
- ```
103
-
104
- **Hva Agenten Vil Gjøre**:
105
- - Skann prosjektstruktur
106
- - Oppdag teknologistabel
107
- - Identifiser forretningsmoduler
108
-
109
- **Leveranse**:
110
- ```
111
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
112
- ```
113
-
114
- ### 3.2 Initialiser Teknisk Kunnskapsbase
97
+ ### 3.1 Initialiser Teknisk Kunnskapsbase
115
98
 
116
99
  **Eksempel på Dialog**:
117
100
  ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
133
116
  └── INDEX.md # Indeksfil
134
117
  ```
135
118
 
136
- ### 3.3 Initialiser Forretningskunnskapsbase
119
+ ### 3.2 Initialiser Forretningskunnskapsbase
137
120
 
138
121
  **Eksempel på Dialog**:
139
122
  ```
@@ -466,11 +449,26 @@ speccrew update
466
449
 
467
450
  > **Merk**: Begge trinnene er nødvendige. Hvis du bare kjører `speccrew update`, oppdateres ikke selve CLI-verktøyet; hvis du bare kjører `npm install`, oppdateres ikke prosjektfilene.
468
451
 
469
- ### S5: Hvordan se historiske iterasjoner?
452
+ ### S5: `speccrew update` viser ny versjon men etter installasjon er det fortsatt den gamle?
453
+
454
+ Vanligvis forårsaket av npm-hurtigbuffer. Løsning:
455
+
456
+ ```bash
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+ npm list -g speccrew
460
+ ```
461
+
462
+ Hvis det fortsatt ikke fungerer, spesifiser versjonsnummeret:
463
+ ```bash
464
+ npm install -g speccrew@0.5.6
465
+ ```
466
+
467
+ ### S6: Hvordan se historiske iterasjoner?
470
468
 
471
469
  Etter arkivering, se i `speccrew-workspace/iteration-archives/`, organisert i formatet `{nummer}-{type}-{navn}-{dato}/`.
472
470
 
473
- ### S6: Trenger kunnskapsbasen regelmessig oppdatering?
471
+ ### S7: Trenger kunnskapsbasen regelmessig oppdatering?
474
472
 
475
473
  Re-initialisering kreves i følgende situasjoner:
476
474
  - Betydelige endringer i prosjektstruktur
@@ -485,7 +483,7 @@ Re-initialisering kreves i følgende situasjoner:
485
483
 
486
484
  | Fase | Agent | Startdialog |
487
485
  |------|-------|-------------------|
488
- | Diagnose | Team Leader | `@speccrew-team-leader diagnostiser prosjekt` |
486
+
489
487
  | Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk kunnskapsbase` |
490
488
  | Kravanalyse | Product Manager | `@speccrew-product-manager jeg har et nytt krav: [beskrivelse]` |
491
489
  | Funksjonsdesign | Feature Designer | `@speccrew-feature-designer start funksjonsdesign` |
@@ -519,5 +517,5 @@ Re-initialisering kreves i følgende situasjoner:
519
517
  ## Neste Steg
520
518
 
521
519
  1. Kjør `speccrew init --ide qoder` for å initialisere prosjektet ditt
522
- 2. Utfør Null Steg: Prosjektdiagnose og Kunnskapsbase-initialisering
520
+ 2. Utfør Kunnskapsbase-initialisering
523
521
  3. Beveg deg gjennom hver fase etter arbeidsflyten, nyt spesifikasjonsdrevet utviklingserfaring!
@@ -90,28 +90,11 @@ flowchart LR
90
90
 
91
91
  ---
92
92
 
93
- ## 3. Krok zerowy: Diagnostyka projektu i inicjalizacja bazy wiedzy
93
+ ## 3. Krok zerowy: Inicjalizacja bazy wiedzy
94
94
 
95
95
  Przed rozpoczęciem formalnego procesu inżynieryjnego musisz zainicjować bazę wiedzy projektu.
96
96
 
97
- ### 3.1 Diagnostyka projektu
98
-
99
- **Przykład rozmowy**:
100
- ```
101
- @speccrew-team-leader zdiagnozuj projekt
102
- ```
103
-
104
- **Co zrobi Agent**:
105
- - Skanowanie struktury projektu
106
- - Wykrywanie stosu technologicznego
107
- - Identyfikacja modułów biznesowych
108
-
109
- **Dostarczalny**:
110
- ```
111
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
112
- ```
113
-
114
- ### 3.2 Inicjalizacja bazy wiedzy technicznej
97
+ ### 3.1 Inicjalizacja bazy wiedzy technicznej
115
98
 
116
99
  **Przykład rozmowy**:
117
100
  ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
133
116
  └── INDEX.md # Plik indeksu
134
117
  ```
135
118
 
136
- ### 3.3 Inicjalizacja bazy wiedzy biznesowej
119
+ ### 3.2 Inicjalizacja bazy wiedzy biznesowej
137
120
 
138
121
  **Przykład rozmowy**:
139
122
  ```
@@ -466,11 +449,24 @@ speccrew update
466
449
 
467
450
  > **Uwaga**: Oba kroki są wymagane. Uruchomienie tylko `speccrew update` nie zaktualizuje samego narzędzia CLI; uruchomienie tylko `npm install` nie zaktualizuje plików projektu.
468
451
 
469
- ### P5: Jak wyświetlić historyczne iteracje?
452
+ ### P5: `speccrew update` pokazuje nową wersję, ale po instalacji nadal jest stara?
453
+
454
+ Zazwyczaj jest to spowodowane pamięcią podręczną npm. Rozwiązanie:
455
+ ```bash
456
+ npm cache clean --force
457
+ npm install -g speccrew@latest
458
+ npm list -g speccrew
459
+ ```
460
+ Jeśli nadal nie działa, zainstaluj określoną wersję:
461
+ ```bash
462
+ npm install -g speccrew@0.5.6
463
+ ```
464
+
465
+ ### P6: Jak wyświetlić historyczne iteracje?
470
466
 
471
467
  Po zarchiwizowaniu przejrzyj w `speccrew-workspace/iteration-archives/`, zorganizowane w formacie `{numer}-{typ}-{nazwa}-{data}/`.
472
468
 
473
- ### P6: Czy baza wiedzy wymaga regularnej aktualizacji?
469
+ ### P7: Czy baza wiedzy wymaga regularnej aktualizacji?
474
470
 
475
471
  Ponowna inicjalizacja jest wymagana w następujących sytuacjach:
476
472
  - Znaczne zmiany w strukturze projektu
@@ -485,7 +481,7 @@ Ponowna inicjalizacja jest wymagana w następujących sytuacjach:
485
481
 
486
482
  | Faza | Agent | Rozmowa początkowa |
487
483
  |------|-------|-------------------|
488
- | Diagnostyka | Team Leader | `@speccrew-team-leader zdiagnozuj projekt` |
484
+
489
485
  | Inicjalizacja | Team Leader | `@speccrew-team-leader zainicjuj bazę wiedzy technicznej` |
490
486
  | Analiza wymagań | Product Manager | `@speccrew-product-manager mam nowe wymaganie: [opis]` |
491
487
  | Projektowanie funkcji | Feature Designer | `@speccrew-feature-designer rozpocznij projektowanie funkcji` |
@@ -519,5 +515,5 @@ Ponowna inicjalizacja jest wymagana w następujących sytuacjach:
519
515
  ## Następne kroki
520
516
 
521
517
  1. Uruchom `speccrew init --ide qoder`, aby zainicjować swój projekt
522
- 2. Wykonaj Krok zerowy: Diagnostyka projektu i inicjalizacja bazy wiedzy
518
+ 2. Wykonaj Krok zerowy: Inicjalizacja bazy wiedzy
523
519
  3. Przechodź przez każdą fazę zgodnie z przepływem pracy, ciesząc się doświadczeniem rozwoju opartego na specyfikacjach!
@@ -90,28 +90,11 @@ flowchart LR
90
90
 
91
91
  ---
92
92
 
93
- ## 3. Passo Zero: Diagnóstico do Projeto e Inicialização da Base de Conhecimento
93
+ ## 3. Passo Zero: Inicialização da Base de Conhecimento
94
94
 
95
95
  Antes de iniciar o processo formal de engenharia, você precisa inicializar a base de conhecimento do projeto.
96
96
 
97
- ### 3.1 Diagnóstico do Projeto
98
-
99
- **Exemplo de Conversa**:
100
- ```
101
- @speccrew-team-leader diagnosticar projeto
102
- ```
103
-
104
- **O que o Agente fará**:
105
- - Escanear estrutura do projeto
106
- - Detectar stack tecnológico
107
- - Identificar módulos de negócio
108
-
109
- **Entregável**:
110
- ```
111
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
112
- ```
113
-
114
- ### 3.2 Inicialização da Base de Conhecimento Técnica
97
+ ### 3.1 Inicialização da Base de Conhecimento Técnica
115
98
 
116
99
  **Exemplo de Conversa**:
117
100
  ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
133
116
  └── INDEX.md # Arquivo de índice
134
117
  ```
135
118
 
136
- ### 3.3 Inicialização da Base de Conhecimento de Negócio
119
+ ### 3.2 Inicialização da Base de Conhecimento de Negócio
137
120
 
138
121
  **Exemplo de Conversa**:
139
122
  ```
@@ -466,11 +449,24 @@ speccrew update
466
449
 
467
450
  > **Nota**: Ambas as etapas são necessárias. Executar apenas `speccrew update` não atualizará a própria ferramenta CLI; executar apenas `npm install` não atualizará os arquivos do projeto.
468
451
 
469
- ### P5: Como ver iterações históricas?
452
+ ### P5: `speccrew update` mostra nova versão mas após instalação ainda é a antiga?
453
+
454
+ Geralmente é causado pelo cache do npm. Solução:
455
+ ```bash
456
+ npm cache clean --force
457
+ npm install -g speccrew@latest
458
+ npm list -g speccrew
459
+ ```
460
+ Se ainda não funcionar, instale uma versão específica:
461
+ ```bash
462
+ npm install -g speccrew@0.5.6
463
+ ```
464
+
465
+ ### P6: Como ver iterações históricas?
470
466
 
471
467
  Após arquivar, consulte em `speccrew-workspace/iteration-archives/`, organizado no formato `{número}-{tipo}-{nome}-{data}/`.
472
468
 
473
- ### P6: A base de conhecimento precisa de atualizações regulares?
469
+ ### P7: A base de conhecimento precisa de atualizações regulares?
474
470
 
475
471
  Reinicialização é necessária nas seguintes situações:
476
472
  - Mudanças significativas na estrutura do projeto
@@ -485,7 +481,7 @@ Reinicialização é necessária nas seguintes situações:
485
481
 
486
482
  | Fase | Agente | Conversa de Início |
487
483
  |------|--------|-------------------|
488
- | Diagnóstico | Team Leader | `@speccrew-team-leader diagnosticar projeto` |
484
+
489
485
  | Inicialização | Team Leader | `@speccrew-team-leader inicializar base de conhecimento técnica` |
490
486
  | Análise de Requisitos | Product Manager | `@speccrew-product-manager tenho um novo requisito: [descrição]` |
491
487
  | Design de Funcionalidades | Feature Designer | `@speccrew-feature-designer iniciar design de funcionalidades` |
@@ -519,5 +515,5 @@ Reinicialização é necessária nas seguintes situações:
519
515
  ## Próximos Passos
520
516
 
521
517
  1. Execute `speccrew init --ide qoder` para inicializar seu projeto
522
- 2. Execute o Passo Zero: Diagnóstico do Projeto e Inicialização da Base de Conhecimento
518
+ 2. Execute o Passo Zero: Inicialização da Base de Conhecimento
523
519
  3. Avance através de cada fase seguindo o fluxo de trabalho, aproveitando a experiência de desenvolvimento orientada por especificações!
@@ -90,28 +90,11 @@ flowchart LR
90
90
 
91
91
  ---
92
92
 
93
- ## 3. Нулевой шаг: Диагностика проекта и инициализация базы знаний
93
+ ## 3. Нулевой шаг: Инициализация базы знаний
94
94
 
95
95
  Перед началом формального инженерного процесса необходимо инициализировать базу знаний проекта.
96
96
 
97
- ### 3.1 Диагностика проекта
98
-
99
- **Пример диалога**:
100
- ```
101
- @speccrew-team-leader диагностировать проект
102
- ```
103
-
104
- **Что сделает Агент**:
105
- - Сканирование структуры проекта
106
- - Обнаружение технологического стека
107
- - Идентификация бизнес-модулей
108
-
109
- **Результат**:
110
- ```
111
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
112
- ```
113
-
114
- ### 3.2 Инициализация технической базы знаний
97
+ ### 3.1 Инициализация технической базы знаний
115
98
 
116
99
  **Пример диалога**:
117
100
  ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
133
116
  └── INDEX.md # Файл индекса
134
117
  ```
135
118
 
136
- ### 3.3 Инициализация бизнес-базы знаний
119
+ ### 3.2 Инициализация бизнес-базы знаний
137
120
 
138
121
  **Пример диалога**:
139
122
  ```
@@ -466,11 +449,24 @@ speccrew update
466
449
 
467
450
  > **Примечание**: Оба этапа обязательны. Выполнение только `speccrew update` не обновит сам CLI-инструмент; выполнение только `npm install` не обновит файлы проекта.
468
451
 
469
- ### В5: Как посмотреть исторические итерации?
452
+ ### В5: `speccrew update` показывает новую версию, но после установки всё ещё старая?
453
+
454
+ Обычно это вызвано кэшем npm. Решение:
455
+ ```bash
456
+ npm cache clean --force
457
+ npm install -g speccrew@latest
458
+ npm list -g speccrew
459
+ ```
460
+ Если всё ещё не работает, установите конкретную версию:
461
+ ```bash
462
+ npm install -g speccrew@0.5.6
463
+ ```
464
+
465
+ ### В6: Как посмотреть исторические итерации?
470
466
 
471
467
  После архивирования смотрите в `speccrew-workspace/iteration-archives/`, организовано в формате `{номер}-{тип}-{имя}-{дата}/`.
472
468
 
473
- ### В6: Нужна ли базе знаний регулярная актуализация?
469
+ ### В7: Нужна ли базе знаний регулярная актуализация?
474
470
 
475
471
  Реинициализация требуется в следующих ситуациях:
476
472
  - Значительные изменения структуры проекта
@@ -485,7 +481,6 @@ speccrew update
485
481
 
486
482
  | Этап | Агент | Начальный диалог |
487
483
  |------|-------|-------------------|
488
- | Диагностика | Team Leader | `@speccrew-team-leader диагностировать проект` |
489
484
  | Инициализация | Team Leader | `@speccrew-team-leader инициализировать техническую базу знаний` |
490
485
  | Анализ требований | Product Manager | `@speccrew-product-manager у меня новое требование: [описание]` |
491
486
  | Проектирование функций | Feature Designer | `@speccrew-feature-designer начать проектирование функций` |
@@ -519,5 +514,5 @@ speccrew update
519
514
  ## Следующие шаги
520
515
 
521
516
  1. Выполните `speccrew init --ide qoder` для инициализации вашего проекта
522
- 2. Выполните Нулевой шаг: Диагностика проекта и инициализация базы знаний
517
+ 2. Выполните Нулевой шаг: Инициализация базы знаний
523
518
  3. Продвигайтесь через каждый этап следуя рабочему процессу, наслаждаясь опытом разработки на основе спецификаций!