speccrew 0.5.6 → 0.5.8

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.
@@ -90,28 +90,11 @@ flowchart LR
90
90
 
91
91
  ---
92
92
 
93
- ## 3. Nulti Korak: Dijagnostika Projekta i Inicijalizacija Baze Znanja
93
+ ## 3. Inicijalizacija Baze Znanja
94
94
 
95
95
  Prije pokretanja formalnog inženjerskog procesa, morate inicijalizirati bazu znanja projekta.
96
96
 
97
- ### 3.1 Dijagnostika Projekta
98
-
99
- **Primjer Razgovora**:
100
- ```
101
- @speccrew-team-leader dijagnosticiraj projekt
102
- ```
103
-
104
- **Šta će Agent Uraditi**:
105
- - Skeniranje strukture projekta
106
- - Otkrivanje tehnološkog steka
107
- - Identifikacija poslovnih modula
108
-
109
- **Isporuka**:
110
- ```
111
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
112
- ```
113
-
114
- ### 3.2 Inicijalizacija Tehničke Baze Znanja
97
+ ### 3.1 Inicijalizacija Tehničke Baze Znanja
115
98
 
116
99
  **Primjer Razgovora**:
117
100
  ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
133
116
  └── INDEX.md # Fajl indeksa
134
117
  ```
135
118
 
136
- ### 3.3 Inicijalizacija Poslovne Baze Znanja
119
+ ### 3.2 Inicijalizacija Poslovne Baze Znanja
137
120
 
138
121
  **Primjer Razgovora**:
139
122
  ```
@@ -466,11 +449,26 @@ speccrew update
466
449
 
467
450
  > **Napomena**: Obje korake treba izvršiti. Samo izvršavanje `speccrew update` neće ažurirati sam CLI alat; samo izvršavanje `npm install` neće ažurirati datoteke u projektu.
468
451
 
469
- ### P5: Kako pogledati historijske iteracije?
452
+ ### P5: `speccrew update` prikazuje novu verziju ali nakon instalacije je još uvijek stara?
453
+
454
+ Obično uzrokovano npm kešom. Rješenje:
455
+
456
+ ```bash
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+ npm list -g speccrew
460
+ ```
461
+
462
+ Ako i dalje ne radi, navedite broj verzije:
463
+ ```bash
464
+ npm install -g speccrew@0.5.6
465
+ ```
466
+
467
+ ### P6: Kako pogledati historijske iteracije?
470
468
 
471
469
  Nakon arhiviranja, pogledajte u `speccrew-workspace/iteration-archives/`, organizirano u formatu `{broj}-{tip}-{ime}-{datum}/`.
472
470
 
473
- ### P6: Da li baza znanja treba redovno ažuriranje?
471
+ ### P7: Da li baza znanja treba redovno ažuriranje?
474
472
 
475
473
  Ponovna inicijalizacija je potrebna u sljedećim situacijama:
476
474
  - Značajne promjene u strukturi projekta
@@ -485,7 +483,7 @@ Ponovna inicijalizacija je potrebna u sljedećim situacijama:
485
483
 
486
484
  | Faza | Agent | Početni Razgovor |
487
485
  |------|-------|-------------------|
488
- | Dijagnostika | Team Leader | `@speccrew-team-leader dijagnosticiraj projekt` |
486
+
489
487
  | Inicijalizacija | Team Leader | `@speccrew-team-leader inicijaliziraj tehničku bazu znanja` |
490
488
  | Analiza Zahtjeva | Product Manager | `@speccrew-product-manager imam novi zahtjev: [opis]` |
491
489
  | Dizajn Funkcija | Feature Designer | `@speccrew-feature-designer započni dizajn funkcija` |
@@ -519,5 +517,5 @@ Ponovna inicijalizacija je potrebna u sljedećim situacijama:
519
517
  ## Sljedeći Koraci
520
518
 
521
519
  1. Pokrenite `speccrew init --ide qoder` da inicijalizirate svoj projekt
522
- 2. Izvršite Nulti Korak: Dijagnostika Projekta i Inicijalizacija Baze Znanja
520
+ 2. Izvršite Inicijalizaciju Baze Znanja
523
521
  3. Napredujte kroz svaku fazu prateći radni tok, uživajte u iskustvu razvoja vođenog specifikacijama!
@@ -89,28 +89,11 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. Trin 0: Projekt Diagnose og Videnbase Initialisering
92
+ ## 3. Videnbase Initialisering
93
93
 
94
94
  Før du starter den formelle ingeniørarbejdsgang, skal du initialisere projektvidenbasen.
95
95
 
96
- ### 3.1 Projekt Diagnose
97
-
98
- **Dialogeksempel**:
99
- ```
100
- @speccrew-team-leader diagnosticer projekt
101
- ```
102
-
103
- **Hvad agenten gør**:
104
- - Scanner projektstruktur
105
- - Detekterer teknologistak
106
- - Identificerer forretningsmoduler
107
-
108
- **Output**:
109
- ```
110
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
111
- ```
112
-
113
- ### 3.2 Teknisk Videnbase Initialisering
96
+ ### 3.1 Teknisk Videnbase Initialisering
114
97
 
115
98
  **Dialogeksempel**:
116
99
  ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
115
  └── INDEX.md # Indeksfil
133
116
  ```
134
117
 
135
- ### 3.3 Forretningsvidenbase Initialisering
118
+ ### 3.2 Forretningsvidenbase Initialisering
136
119
 
137
120
  **Dialogeksempel**:
138
121
  ```
@@ -465,11 +448,26 @@ speccrew update
465
448
 
466
449
  > **Bemærk**: Begge trin skal udføres. Kun at køre `speccrew update` opdaterer ikke selve CLI-værktøjet; kun at køre `npm install` opdaterer ikke filerne i projektet.
467
450
 
468
- ### Q5: Hvordan vises historiske iterationer?
451
+ ### Q5: `speccrew update` viser ny version, men efter installation er det stadig den gamle?
452
+
453
+ Normalt forårsaget af npm cache. Løsning:
454
+
455
+ ```bash
456
+ npm cache clean --force
457
+ npm install -g speccrew@latest
458
+ npm list -g speccrew
459
+ ```
460
+
461
+ Hvis det stadig ikke virker, angiv versionsnummeret:
462
+ ```bash
463
+ npm install -g speccrew@0.5.6
464
+ ```
465
+
466
+ ### Q6: Hvordan vises historiske iterationer?
469
467
 
470
468
  Efter arkivering, se i `speccrew-workspace/iteration-archives/`, organiseret efter `{sekvens}-{type}-{navn}-{dato}/` format.
471
469
 
472
- ### Q6: Skal videnbasen opdateres regelmæssigt?
470
+ ### Q7: Skal videnbasen opdateres regelmæssigt?
473
471
 
474
472
  Følgende situationer kræver re-initialisering:
475
473
  - Projektstruktur ændres væsentligt
@@ -484,7 +482,7 @@ Følgende situationer kræver re-initialisering:
484
482
 
485
483
  | Fase | Agent | Startdialog |
486
484
  |------|-------|----------|
487
- | Diagnose | Team Leader | `@speccrew-team-leader diagnosticer projekt` |
485
+
488
486
  | Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk videnbase` |
489
487
  | Kravanalyse | Product Manager | `@speccrew-product-manager Jeg har et nyt krav: [beskrivelse]` |
490
488
  | Funktionsdesign | Feature Designer | `@speccrew-feature-designer start funktionsdesign` |
@@ -518,5 +516,5 @@ Følgende situationer kræver re-initialisering:
518
516
  ## Næste Skridt
519
517
 
520
518
  1. Kør `speccrew init --ide qoder` for at initialisere dit projekt
521
- 2. Udfør trin 0: Projekt Diagnose og Videnbase Initialisering
519
+ 2. Udfør Videnbase Initialisering
522
520
  3. Følg arbejdsgangen fase for fase og nyd specifikationsdrevet udvikling!
@@ -89,28 +89,11 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. Schritt Null: Projektdiagnose und Wissensbasis-Initialisierung
92
+ ## 3. Schritt Null: Wissensbasis-Initialisierung
93
93
 
94
94
  Bevor Sie den formellen Engineering-Prozess starten, müssen Sie die Projektwissensbasis initialisieren.
95
95
 
96
- ### 3.1 Projektdiagnose
97
-
98
- **Konversationsbeispiel**:
99
- ```
100
- @speccrew-team-leader Projekt diagnostizieren
101
- ```
102
-
103
- **Was der Agent tun wird**:
104
- - Projektstruktur scannen
105
- - Technologie-Stack erkennen
106
- | Geschäftsmodule identifizieren
107
-
108
- **Liefergegenstand**:
109
- ```
110
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
111
- ```
112
-
113
- ### 3.2 Technische Wissensbasis-Initialisierung
96
+ ### 3.1 Technische Wissensbasis-Initialisierung
114
97
 
115
98
  **Konversationsbeispiel**:
116
99
  ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
115
  └── INDEX.md # Indexdatei
133
116
  ```
134
117
 
135
- ### 3.3 Geschäftswissen-Basis-Initialisierung
118
+ ### 3.2 Geschäftswissen-Basis-Initialisierung
136
119
 
137
120
  **Konversationsbeispiel**:
138
121
  ```
@@ -465,11 +448,29 @@ speccrew update
465
448
 
466
449
  > **Hinweis**: Beide Schritte müssen ausgeführt werden. Nur `speccrew update` auszuführen aktualisiert nicht das CLI-Tool selbst; nur `npm install` auszuführen aktualisiert nicht die Dateien im Projekt.
467
450
 
468
- ### Q5: Wie historische Iterationen ansehen?
451
+ ### Q5: `speccrew update` zeigt neue Version verfügbar an, aber `npm install -g speccrew@latest` installiert trotzdem die alte Version?
452
+
453
+ Dies wird normalerweise durch den npm-Cache verursacht. Lösung:
454
+
455
+ ```bash
456
+ # npm-Cache leeren und neu installieren
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+
460
+ # Version überprüfen
461
+ npm list -g speccrew
462
+ ```
463
+
464
+ Wenn es immer noch nicht funktioniert, versuchen Sie die Installation mit einer spezifischen Versionsnummer:
465
+ ```bash
466
+ npm install -g speccrew@0.5.6
467
+ ```
468
+
469
+ ### Q6: Wie historische Iterationen ansehen?
469
470
 
470
471
  Nach Archivierung in `speccrew-workspace/iteration-archives/` ansehen, organisiert nach `{nummer}-{typ}-{name}-{date}/` Format.
471
472
 
472
- ### Q6: Muss die Wissensbasis regelmäßig aktualisiert werden?
473
+ ### Q7: Muss die Wissensbasis regelmäßig aktualisiert werden?
473
474
 
474
475
  Neuinitialisierung ist in folgenden Situationen erforderlich:
475
476
  - Große Änderungen an der Projektstruktur
@@ -484,7 +485,6 @@ Neuinitialisierung ist in folgenden Situationen erforderlich:
484
485
 
485
486
  | Phase | Agent | Start-Konversation |
486
487
  |-------|-------|-------------------|
487
- | Diagnose | Team Leader | `@speccrew-team-leader Projekt diagnostizieren` |
488
488
  | Initialisierung | Team Leader | `@speccrew-team-leader technische Wissensbasis initialisieren` |
489
489
  | Anforderungsanalyse | Product Manager | `@speccrew-product-manager Ich habe eine neue Anforderung: [Beschreibung]` |
490
490
  | Feature Design | Feature Designer | `@speccrew-feature-designer Feature Design starten` |
@@ -518,5 +518,5 @@ Neuinitialisierung ist in folgenden Situationen erforderlich:
518
518
  ## Nächste Schritte
519
519
 
520
520
  1. `speccrew init --ide qoder` ausführen um Ihr Projekt zu initialisieren
521
- 2. Schritt Null ausführen: Projektdiagnose und Wissensbasis-Initialisierung
521
+ 2. Schritt Null ausführen: Wissensbasis-Initialisierung
522
522
  3. Durchlaufen Sie jede Phase nach dem Workflow und genießen Sie die specification-driven Entwicklungserfahrung!
@@ -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
- **Τι θα Κάνει ο Agent**:
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,26 @@ speccrew update
466
449
 
467
450
  > **Σημείωση**: Και τα δύο βήματα πρέπει να εκτελεστούν. Η εκτέλεση μόνο του `speccrew update` δεν θα ενημερώσει το ίδιο το εργαλείο CLI· η εκτέλεση μόνο του `npm install` δεν θα ενημερώσει τα αρχεία στο έργο.
468
451
 
469
- ### Ε5: Πώς να δω ιστορικές επαναλήψεις;
452
+ ### Ε5: `speccrew update` εμφανίζει νέα έκδοση αλλά μετά την εγκατάσταση είναι ακόμα παλιά;
453
+
454
+ Συνήθως οφείλεται στην ενδιάμεση μνήμη npm. Λύση:
455
+
456
+ ```bash
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+ npm list -g speccrew
460
+ ```
461
+
462
+ Αν εξακολουθεί να μην λειτουργεί, καθορίστε τον αριθμό έκδοσης:
463
+ ```bash
464
+ npm install -g speccrew@0.5.6
465
+ ```
466
+
467
+ ### Ε6: Πώς να δω ιστορικές επαναλήψεις;
470
468
 
471
469
  Μετά την αρχειοθέτηση, δείτε στο `speccrew-workspace/iteration-archives/`, οργανωμένο σε μορφή `{αριθμός}-{τύπος}-{όνομα}-{ημερομηνία}/`.
472
470
 
473
- ### Ε6: Η βάση γνώσεων χρειάζεται τακτική ενημέρωση;
471
+ ### Ε7: Η βάση γνώσεων χρειάζεται τακτική ενημέρωση;
474
472
 
475
473
  Απαιτείται επανεκκίνηση στις ακόλουθες καταστάσεις:
476
474
  - Σημαντικές αλλαγές στη δομή του έργου
@@ -485,7 +483,7 @@ speccrew update
485
483
 
486
484
  | Φάση | Agent | Διάλογος Εκκίνησης |
487
485
  |------|-------|-------------------|
488
- | Διάγνωση | Team Leader | `@speccrew-team-leader διάγνωση έργου` |
486
+
489
487
  | Αρχικοποίηση | Team Leader | `@speccrew-team-leader αρχικοποίηση τεχνικής βάσης γνώσεων` |
490
488
  | Ανάλυση Απαιτήσεων | Product Manager | `@speccrew-product-manager έχω μια νέα απαίτηση: [περιγραφή]` |
491
489
  | Σχεδιασμός Χαρακτηριστικών | Feature Designer | `@speccrew-feature-designer έναρξη σχεδιασμού χαρακτηριστικών` |
@@ -519,5 +517,5 @@ speccrew update
519
517
  ## Επόμενα Βήματα
520
518
 
521
519
  1. Εκτελέστε `speccrew init --ide qoder` για να αρχικοποιήσετε το έργο σας
522
- 2. Εκτελέστε το Μηδενικό Βήμα: Διάγνωση Έργου και Αρχικοποίηση Βάσης Γνώσεων
520
+ 2. Εκτελέστε την Αρχικοποίηση Βάσης Γνώσεων
523
521
  3. Προχωρήστε μέσα από κάθε φάση ακολουθώντας τη ροή εργασίας, απολαμβάνοντας την εμπειρία ανάπτυξης που καθοδηγείται από προδιαγραφές!
@@ -89,28 +89,11 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. Step Zero: Project Diagnosis and Knowledge Base Initialization
92
+ ## 3. Step Zero: Knowledge Base Initialization
93
93
 
94
94
  Before starting the formal engineering process, you need to initialize the project knowledge base.
95
95
 
96
- ### 3.1 Project Diagnosis
97
-
98
- **Conversation Example**:
99
- ```
100
- @speccrew-team-leader diagnose project
101
- ```
102
-
103
- **What the Agent Will Do**:
104
- - Scan project structure
105
- - Detect technology stack
106
- - Identify business modules
107
-
108
- **Deliverable**:
109
- ```
110
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
111
- ```
112
-
113
- ### 3.2 Technical Knowledge Base Initialization
96
+ ### 3.1 Technical Knowledge Base Initialization
114
97
 
115
98
  **Conversation Example**:
116
99
  ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
115
  └── INDEX.md # Index file
133
116
  ```
134
117
 
135
- ### 3.3 Business Knowledge Base Initialization
118
+ ### 3.2 Business Knowledge Base Initialization
136
119
 
137
120
  **Conversation Example**:
138
121
  ```
@@ -465,11 +448,29 @@ speccrew update
465
448
 
466
449
  > **Note**: Both steps are required. Running only `speccrew update` will not update the CLI tool itself; running only `npm install` will not update project files.
467
450
 
468
- ### Q5: How to view historical iterations?
451
+ ### Q5: `speccrew update` shows new version available but `npm install -g speccrew@latest` still installs the old version?
452
+
453
+ This is usually caused by npm cache. Solution:
454
+
455
+ ```bash
456
+ # Clear npm cache and reinstall
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+
460
+ # Verify version
461
+ npm list -g speccrew
462
+ ```
463
+
464
+ If it still doesn't work, try installing with a specific version number:
465
+ ```bash
466
+ npm install -g speccrew@0.5.6
467
+ ```
468
+
469
+ ### Q6: How to view historical iterations?
469
470
 
470
471
  After archiving, view in `speccrew-workspace/iteration-archives/`, organized by `{number}-{type}-{name}-{date}/` format.
471
472
 
472
- ### Q6: Does the knowledge base need regular updates?
473
+ ### Q7: Does the knowledge base need regular updates?
473
474
 
474
475
  Re-initialization is required in the following situations:
475
476
  - Major changes to project structure
@@ -484,7 +485,6 @@ Re-initialization is required in the following situations:
484
485
 
485
486
  | Phase | Agent | Start Conversation |
486
487
  |-------|-------|-------------------|
487
- | Diagnosis | Team Leader | `@speccrew-team-leader diagnose project` |
488
488
  | Initialization | Team Leader | `@speccrew-team-leader initialize technical knowledge base` |
489
489
  | Requirements Analysis | Product Manager | `@speccrew-product-manager I have a new requirement: [description]` |
490
490
  | Feature Design | Feature Designer | `@speccrew-feature-designer start feature design` |
@@ -518,5 +518,5 @@ Re-initialization is required in the following situations:
518
518
  ## Next Steps
519
519
 
520
520
  1. Run `speccrew init --ide qoder` to initialize your project
521
- 2. Execute Step Zero: Project Diagnosis and Knowledge Base Initialization
521
+ 2. Execute Step Zero: Knowledge Base Initialization
522
522
  3. Progress through each phase following the workflow, enjoying the specification-driven development experience!
@@ -89,28 +89,11 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. Paso Cero: Diagnóstico del Proyecto e Inicialización de la Base de Conocimientos
92
+ ## 3. Paso Cero: Inicialización de la Base de Conocimientos
93
93
 
94
94
  Antes de comenzar el proceso formal de ingeniería, necesita inicializar la base de conocimientos del proyecto.
95
95
 
96
- ### 3.1 Diagnóstico del Proyecto
97
-
98
- **Ejemplo de Conversación**:
99
- ```
100
- @speccrew-team-leader diagnosticar proyecto
101
- ```
102
-
103
- **Qué Hará el Agente**:
104
- - Escanear la estructura del proyecto
105
- - Detectar el stack tecnológico
106
- - Identificar módulos de negocio
107
-
108
- **Entregable**:
109
- ```
110
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
111
- ```
112
-
113
- ### 3.2 Inicialización de la Base de Conocimientos Técnica
96
+ ### 3.1 Inicialización de la Base de Conocimientos Técnica
114
97
 
115
98
  **Ejemplo de Conversación**:
116
99
  ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
115
  └── INDEX.md # Archivo de índice
133
116
  ```
134
117
 
135
- ### 3.3 Inicialización de la Base de Conocimientos de Negocio
118
+ ### 3.2 Inicialización de la Base de Conocimientos de Negocio
136
119
 
137
120
  **Ejemplo de Conversación**:
138
121
  ```
@@ -465,11 +448,29 @@ speccrew update
465
448
 
466
449
  > **Nota**: Ambos pasos deben ejecutarse. Ejecutar solo `speccrew update` no actualizará la herramienta CLI en sí; ejecutar solo `npm install` no actualizará los archivos en el proyecto.
467
450
 
468
- ### P5: ¿Cómo ver iteraciones históricas?
451
+ ### P5: ¿`speccrew update` muestra nueva versión disponible pero `npm install -g speccrew@latest` sigue instalando la versión anterior?
452
+
453
+ Esto suele ser causado por la caché de npm. Solución:
454
+
455
+ ```bash
456
+ # Limpiar caché de npm y reinstalar
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+
460
+ # Verificar versión
461
+ npm list -g speccrew
462
+ ```
463
+
464
+ Si aún no funciona, intente instalar con un número de versión específico:
465
+ ```bash
466
+ npm install -g speccrew@0.5.6
467
+ ```
468
+
469
+ ### P6: ¿Cómo ver iteraciones históricas?
469
470
 
470
471
  Después de archivar, consulte en `speccrew-workspace/iteration-archives/`, organizado en formato `{número}-{tipo}-{nombre}-{fecha}/`.
471
472
 
472
- ### P6: ¿La base de conocimientos necesita actualizaciones regulares?
473
+ ### P7: ¿La base de conocimientos necesita actualizaciones regulares?
473
474
 
474
475
  Se requiere reinicialización en las siguientes situaciones:
475
476
  - Cambios importantes en la estructura del proyecto
@@ -484,7 +485,6 @@ Se requiere reinicialización en las siguientes situaciones:
484
485
 
485
486
  | Fase | Agente | Conversación de Inicio |
486
487
  |------|--------|------------------------|
487
- | Diagnóstico | Team Leader | `@speccrew-team-leader diagnosticar proyecto` |
488
488
  | Inicialización | Team Leader | `@speccrew-team-leader inicializar base de conocimientos técnica` |
489
489
  | Análisis de Requisitos | Product Manager | `@speccrew-product-manager tengo un nuevo requisito: [descripción]` |
490
490
  | Diseño de Funcionalidades | Feature Designer | `@speccrew-feature-designer iniciar diseño de funcionalidades` |
@@ -518,5 +518,5 @@ Se requiere reinicialización en las siguientes situaciones:
518
518
  ## Próximos Pasos
519
519
 
520
520
  1. Ejecute `speccrew init --ide qoder` para inicializar su proyecto
521
- 2. Ejecute el Paso Cero: Diagnóstico del Proyecto e Inicialización de la Base de Conocimientos
521
+ 2. Ejecute el Paso Cero: Inicialización de la Base de Conocimientos
522
522
  3. Avance a través de cada fase siguiendo el flujo de trabajo, ¡disfrutando de la experiencia de desarrollo impulsada por especificaciones!
@@ -89,28 +89,11 @@ flowchart LR
89
89
 
90
90
  ---
91
91
 
92
- ## 3. Étape Zéro : Diagnostic de Projet et Initialisation de la Base de Connaissances
92
+ ## 3. Étape Zéro : Initialisation de la Base de Connaissances
93
93
 
94
94
  Avant de commencer le processus d'ingénierie formel, vous devez initialiser la base de connaissances du projet.
95
95
 
96
- ### 3.1 Diagnostic de Projet
97
-
98
- **Exemple de Conversation** :
99
- ```
100
- @speccrew-team-leader diagnostiquer le projet
101
- ```
102
-
103
- **Ce que l'Agent fera** :
104
- - Scanner la structure du projet
105
- - Détecter la pile technologique
106
- - Identifier les modules métier
107
-
108
- **Livrable** :
109
- ```
110
- speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
111
- ```
112
-
113
- ### 3.2 Initialisation de la Base de Connaissances Techniques
96
+ ### 3.1 Initialisation de la Base de Connaissances Techniques
114
97
 
115
98
  **Exemple de Conversation** :
116
99
  ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
132
115
  └── INDEX.md # Fichier d'index
133
116
  ```
134
117
 
135
- ### 3.3 Initialisation de la Base de Connaissances Métier
118
+ ### 3.2 Initialisation de la Base de Connaissances Métier
136
119
 
137
120
  **Exemple de Conversation** :
138
121
  ```
@@ -465,11 +448,29 @@ speccrew update
465
448
 
466
449
  > **Remarque** : Les deux étapes doivent être exécutées. Exécuter uniquement `speccrew update` ne mettra pas à jour l'outil CLI lui-même ; exécuter uniquement `npm install` ne mettra pas à jour les fichiers dans le projet.
467
450
 
468
- ### Q5 : Comment consulter les itérations historiques ?
451
+ ### Q5 : `speccrew update` montre qu'une nouvelle version est disponible mais `npm install -g speccrew@latest` installe toujours l'ancienne version ?
452
+
453
+ Ceci est généralement causé par le cache npm. Solution :
454
+
455
+ ```bash
456
+ # Vider le cache npm et réinstaller
457
+ npm cache clean --force
458
+ npm install -g speccrew@latest
459
+
460
+ # Vérifier la version
461
+ npm list -g speccrew
462
+ ```
463
+
464
+ Si cela ne fonctionne toujours pas, essayez d'installer avec un numéro de version spécifique :
465
+ ```bash
466
+ npm install -g speccrew@0.5.6
467
+ ```
468
+
469
+ ### Q6 : Comment consulter les itérations historiques ?
469
470
 
470
471
  Après archivage, consultez dans `speccrew-workspace/iteration-archives/`, organisé par le format `{numéro}-{type}-{nom}-{date}/`.
471
472
 
472
- ### Q6 : La base de connaissances a-t-elle besoin de mises à jour régulières ?
473
+ ### Q7 : La base de connaissances a-t-elle besoin de mises à jour régulières ?
473
474
 
474
475
  La réinitialisation est nécessaire dans les situations suivantes :
475
476
  - Changements majeurs dans la structure du projet
@@ -484,7 +485,6 @@ La réinitialisation est nécessaire dans les situations suivantes :
484
485
 
485
486
  | Phase | Agent | Conversation de Démarrage |
486
487
  |-------|-------|---------------------------|
487
- | Diagnostic | Team Leader | `@speccrew-team-leader diagnostiquer le projet` |
488
488
  | Initialisation | Team Leader | `@speccrew-team-leader initialiser la base de connaissances techniques` |
489
489
  | Analyse des Exigences | Product Manager | `@speccrew-product-manager J'ai une nouvelle exigence : [description]` |
490
490
  | Feature Design | Feature Designer | `@speccrew-feature-designer démarrer la conception de fonctionnalité` |
@@ -518,5 +518,5 @@ La réinitialisation est nécessaire dans les situations suivantes :
518
518
  ## Prochaines Étapes
519
519
 
520
520
  1. Exécuter `speccrew init --ide qoder` pour initialiser votre projet
521
- 2. Exécuter l'Étape Zéro : Diagnostic de Projet et Initialisation de la Base de Connaissances
521
+ 2. Exécuter l'Étape Zéro : Initialisation de la Base de Connaissances
522
522
  3. Progresser à travers chaque phase en suivant le flux de travail, en profitant de l'expérience de développement piloté par les spécifications !
@@ -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!