speccrew 0.5.9 → 0.5.11

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 (44) hide show
  1. package/.speccrew/agents/speccrew-feature-designer.md +67 -0
  2. package/.speccrew/agents/speccrew-product-manager.md +69 -0
  3. package/.speccrew/agents/speccrew-system-designer.md +77 -0
  4. package/.speccrew/agents/speccrew-system-developer.md +311 -8
  5. package/.speccrew/agents/speccrew-task-worker.md +34 -0
  6. package/.speccrew/agents/speccrew-team-leader.md +84 -0
  7. package/.speccrew/agents/speccrew-test-manager.md +27 -0
  8. package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/SKILL.md +38 -50
  9. package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/templates/TASK-RECORD-TEMPLATE.md +14 -28
  10. package/.speccrew/skills/speccrew-dev-desktop-tauri/SKILL.md +341 -0
  11. package/.speccrew/skills/speccrew-dev-desktop-tauri/templates/TASK-RECORD-TEMPLATE.md +145 -0
  12. package/.speccrew/skills/speccrew-dev-review-backend/SKILL.md +212 -0
  13. package/.speccrew/skills/speccrew-dev-review-backend/templates/REVIEW-REPORT-TEMPLATE.md +94 -0
  14. package/.speccrew/skills/speccrew-dev-review-desktop/SKILL.md +181 -0
  15. package/.speccrew/skills/speccrew-dev-review-desktop/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
  16. package/.speccrew/skills/speccrew-dev-review-frontend/SKILL.md +177 -0
  17. package/.speccrew/skills/speccrew-dev-review-frontend/templates/REVIEW-REPORT-TEMPLATE.md +83 -0
  18. package/.speccrew/skills/speccrew-dev-review-mobile/SKILL.md +181 -0
  19. package/.speccrew/skills/speccrew-dev-review-mobile/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
  20. package/docs/GETTING-STARTED.ar.md +249 -176
  21. package/docs/GETTING-STARTED.bn.md +108 -412
  22. package/docs/GETTING-STARTED.bs.md +103 -407
  23. package/docs/GETTING-STARTED.da.md +267 -190
  24. package/docs/GETTING-STARTED.de.md +190 -115
  25. package/docs/GETTING-STARTED.el.md +245 -169
  26. package/docs/GETTING-STARTED.en.md +97 -22
  27. package/docs/GETTING-STARTED.es.md +179 -104
  28. package/docs/GETTING-STARTED.fr.md +191 -116
  29. package/docs/GETTING-STARTED.it.md +233 -156
  30. package/docs/GETTING-STARTED.ja.md +242 -167
  31. package/docs/GETTING-STARTED.ko.md +211 -136
  32. package/docs/GETTING-STARTED.md +97 -22
  33. package/docs/GETTING-STARTED.no.md +86 -417
  34. package/docs/GETTING-STARTED.pl.md +213 -135
  35. package/docs/GETTING-STARTED.pt-BR.md +94 -396
  36. package/docs/GETTING-STARTED.ru.md +241 -162
  37. package/docs/GETTING-STARTED.th.md +104 -405
  38. package/docs/GETTING-STARTED.tr.md +223 -144
  39. package/docs/GETTING-STARTED.uk.md +273 -194
  40. package/docs/GETTING-STARTED.vi.md +98 -399
  41. package/docs/GETTING-STARTED.zh-TW.md +213 -138
  42. package/lib/commands/init.js +18 -0
  43. package/package.json +1 -1
  44. package/.speccrew/skills/speccrew-dev-review/SKILL.md +0 -451
@@ -1,4 +1,4 @@
1
- # SpecCrew - Vodič za Brzi Početak
1
+ # SpecCrew Vodič za Brzi Početak
2
2
 
3
3
  <p align="center">
4
4
  <a href="./GETTING-STARTED.md">简体中文</a> |
@@ -11,15 +11,14 @@
11
11
  <a href="./GETTING-STARTED.it.md">Italiano</a> |
12
12
  <a href="./GETTING-STARTED.da.md">Dansk</a> |
13
13
  <a href="./GETTING-STARTED.ja.md">日本語</a> |
14
- <a href="./GETTING-STARTED.ar.md">العربية</a> |
15
- <a href="./GETTING-STARTED.bs.md">Bosanski</a>
14
+ <a href="./GETTING-STARTED.ar.md">العربية</a>
16
15
  </p>
17
16
 
18
- Ovaj dokument vam pomaže da brzo razumijete kako koristiti SpecCrew Agent tim za završetak punog ciklusa razvoja od zahtjeva do isporuke, prateći standardne inženjerske procese.
17
+ Ovaj dokument vam pomaže da brzo razumijete kako koristiti SpecCrew Agent tim za završetak kompletnog razvoja od zahtjeva do isporuke prema standardnim inženjerskim procesima.
19
18
 
20
19
  ---
21
20
 
22
- ## 1. Preduslovi
21
+ ## 1. Preduvjeti
23
22
 
24
23
  ### Instalacija SpecCrew
25
24
 
@@ -40,482 +39,179 @@ Podržani IDE-ovi: `qoder`, `cursor`, `claude`, `codex`
40
39
  ```
41
40
  .
42
41
  ├── .qoder/
43
- │ ├── agents/ # Fajlovi definicije Agenata
44
- │ └── skills/ # Fajlovi definicije Sposobnosti
45
- ├── speccrew-workspace/ # Radni prostor
42
+ │ ├── agents/ # Datoteke definicije Agents
43
+ │ └── skills/ # Datoteke definicije Skills
44
+ ├── speccrew-workspace/ # Workspace
46
45
  │ ├── docs/ # Konfiguracije, pravila, šabloni, rješenja
47
46
  │ ├── iterations/ # Trenutne iteracije
48
47
  │ ├── iteration-archives/ # Arhivirane iteracije
49
48
  │ └── knowledges/ # Baza znanja
50
- │ ├── base/ # Osnovne informacije (dijagnostički izvještaji, tehnički dugovi)
49
+ │ ├── base/ # Osnovne informacije (dijagnostički izvještaji, tehnički dug)
51
50
  │ ├── bizs/ # Poslovna baza znanja
52
51
  │ └── techs/ # Tehnička baza znanja
53
52
  ```
54
53
 
55
- ### CLI Komanda Brza Referenca
54
+ ### Brzi Pregled CLI Komandi
56
55
 
57
56
  | Komanda | Opis |
58
- |---------|-------------|
59
- | `speccrew list` | Lista svih dostupnih Agenata i Sposobnosti |
60
- | `speccrew doctor` | Provjerite integritet instalacije |
61
- | `speccrew update` | Ažurirajte konfiguraciju projekta na najnoviju verziju |
62
- | `speccrew uninstall` | Deinstalirajte SpecCrew |
57
+ |------|------|
58
+ | `speccrew list` | Lista svih dostupnih Agents i Skills |
59
+ | `speccrew doctor` | Provjera integriteta instalacije |
60
+ | `speccrew update` | Ažuriranje konfiguracije projekta na najnoviju verziju |
61
+ | `speccrew uninstall` | Deinstalacija SpecCrew |
63
62
 
64
63
  ---
65
64
 
66
- ## 2. Pregled Radnog Toka
65
+ ## 2. Brzi Početak za 5 Minuta Nakon Instalacije
67
66
 
68
- ### Potpuni Dijagram Toka
67
+ Nakon pokretanja `speccrew init`, slijedite ove korake za brzi ulazak u radno stanje:
69
68
 
70
- ```mermaid
71
- flowchart LR
72
- PRD[Faza 1<br/>Analiza Zahtjeva<br/>Product Manager] --> FD[Faza 2<br/>Dizajn Funkcija<br/>Feature Designer]
73
- FD --> SD[Faza 3<br/>Dizajn Sistema<br/>System Designer]
74
- SD --> DEV[Faza 4<br/>Razvoj<br/>System Developer]
75
- DEV --> TEST[Faza 5<br/>Testiranje Sistema<br/>Test Manager]
76
- TEST --> ARCHIVE[Faza 6<br/>Arhiviranje]
77
-
78
- KB[(Baza Znanja<br/>Kroz Cijeli Proces)] -.-> PRD
79
- KB -.-> FD
80
- KB -.-> SD
81
- KB -.-> DEV
82
- KB -.-> TEST
83
- ```
69
+ ### Korak 1: Odaberite Vaš IDE
84
70
 
85
- ### Osnovni Principi
86
-
87
- 1. **Ovisnosti Faza**: Izlaz svake faze je ulaz za sljedeću fazu
88
- 2. **Potvrda Kontrolne Tačke**: Svaka faza ima tačku potvrde koja zahtijeva odobrenje korisnika prije nastavka
89
- 3. **Pokretano Bazom Znanja**: Baza znanja prolazi kroz cijeli proces, pružajući kontekst za sve faze
90
-
91
- ---
92
-
93
- ## 3. Inicijalizacija Baze Znanja
71
+ | IDE | Komanda Inicijalizacije | Scenario Primjene |
72
+ |-----|-----------|----------|
73
+ | **Qoder** (Preporučeno) | `speccrew init --ide qoder` | Potpuna orkestracija agenata, paralelni workeri |
74
+ | **Cursor** | `speccrew init --ide cursor` | Workflows bazirani na Composer |
75
+ | **Claude Code** | `speccrew init --ide claude` | CLI-first razvoj |
76
+ | **Codex** | `speccrew init --ide codex` | Integracija OpenAI ekosistema |
94
77
 
95
- Prije pokretanja formalnog inženjerskog procesa, morate inicijalizirati bazu znanja projekta.
78
+ ### Korak 2: Inicijalizacija Baze Znanja (Preporučeno)
96
79
 
97
- ### 3.1 Inicijalizacija Tehničke Baze Znanja
80
+ Za projekte sa postojećim izvornim kodom, preporučuje se prvo inicijalizacija baze znanja kako bi agenti razumjeli vašu kôd bazu:
98
81
 
99
- **Primjer Razgovora**:
100
82
  ```
101
- @speccrew-team-leader inicijaliziraj tehničku bazu znanja
83
+ @speccrew-team-leader inicijalizuj tehničku bazu znanja
102
84
  ```
103
85
 
104
- **Trofazni Proces**:
105
- 1. Otkrivanje Platforme — Identifikacija tehnoloških platformi u projektu
106
- 2. Generisanje Tehničke Dokumentacije — Generisanje dokumenata tehničkih specifikacija za svaku platformu
107
- 3. Generisanje Indeksa — Uspostavljanje indeksa baze znanja
86
+ Zatim:
108
87
 
109
- **Isporuka**:
110
88
  ```
111
- speccrew-workspace/knowledges/techs/{platform-id}/
112
- ├── tech-stack.md # Definicija tehnološkog steka
113
- ├── architecture.md # Arhitektonske konvencije
114
- ├── dev-spec.md # Specifikacije razvoja
115
- ├── test-spec.md # Specifikacije testiranja
116
- └── INDEX.md # Fajl indeksa
89
+ @speccrew-team-leader inicijalizuj poslovnu bazu znanja
117
90
  ```
118
91
 
119
- ### 3.2 Inicijalizacija Poslovne Baze Znanja
92
+ ### Korak 3: Započnite Vaš Prvi Zadatak
120
93
 
121
- **Primjer Razgovora**:
122
94
  ```
123
- @speccrew-team-leader inicijaliziraj poslovnu bazu znanja
95
+ @speccrew-product-manager Imam novi zahtjev: [opišite vaš funkcionalni zahtjev]
124
96
  ```
125
97
 
126
- **Četverofazni Proces**:
127
- 1. Inventar Funkcija — Skeniranje koda za identifikaciju svih funkcija
128
- 2. Analiza Funkcija — Analiza poslovne logike svake funkcije
129
- 3. Sažetak Modula — Sumiranje funkcija po modulima
130
- 4. Sažetak Sistema — Generisanje poslovnog pregleda na nivou sistema
131
-
132
- **Isporuka**:
133
- ```
134
- speccrew-workspace/knowledges/bizs/
135
- ├── {platform-type}/
136
- │ └── {module-name}/
137
- │ └── feature-spec.md
138
- └── system-overview.md
139
- ```
98
+ > **Savjet**: Ako niste sigurni šta raditi, samo recite `@speccrew-team-leader pomozite mi da počnem` — Team Leader će automatski detektovati status vašeg projekta i voditi vas.
140
99
 
141
100
  ---
142
101
 
143
- ## 4. Vodič za Razgovor Fazu po Fazu
102
+ ## 3. Brzo Stablo Odlučivanja
144
103
 
145
- ### 4.1 Faza 1: Analiza Zahtjeva (Product Manager)
146
-
147
- **Kako Početi**:
148
- ```
149
- @speccrew-product-manager imam novi zahtjev: [opišite svoj zahtjev]
150
- ```
104
+ Niste sigurni šta raditi? Pronađite vaš scenario ispod:
151
105
 
152
- **Radni Tok Agenta**:
153
- 1. Pročitajte pregled sistema da razumijete postojeće module
154
- 2. Analizirajte zahtjeve korisnika
155
- 3. Generišite strukturirani PRD dokument
106
+ - **Imam novi funkcionalni zahtjev**
107
+ `@speccrew-product-manager Imam novi zahtjev: [opišite vaš funkcionalni zahtjev]`
156
108
 
157
- **Isporuka**:
158
- ```
159
- iterations/{broj}-{tip}-{ime}/01.product-requirement/
160
- ├── [feature-name]-prd.md # Dokument Zahtjeva Proizvoda
161
- └── [feature-name]-bizs-modeling.md # Poslovno modeliranje (za složene zahtjeve)
162
- ```
109
+ - **Želim skenirati znanje postojećeg projekta**
110
+ → `@speccrew-team-leader inicijalizuj tehničku bazu znanja`
111
+ → Zatim: `@speccrew-team-leader inicijalizuj poslovnu bazu znanja`
163
112
 
164
- **Kontrolna Lista Potvrde**:
165
- - [ ] Da li opis zahtjeva tačno odražava namjeru korisnika?
166
- - [ ] Da li su poslovna pravila kompletna?
167
- - [ ] Da li su integracione tačke sa postojećim sistemima jasne?
168
- - [ ] Da li su kriteriji prihvatanja mjerljivi?
113
+ - **Želim nastaviti prethodni rad**
114
+ → `@speccrew-team-leader koji je trenutni napredak?`
169
115
 
170
- ---
116
+ - **Želim provjeriti zdravstveno stanje sistema**
117
+ → Pokrenuti u terminalu: `speccrew doctor`
171
118
 
172
- ### 4.2 Faza 2: Dizajn Funkcija (Feature Designer)
119
+ - **Nisam siguran šta raditi**
120
+ → `@speccrew-team-leader pomozite mi da počnem`
121
+ → Team Leader će automatski detektovati status vašeg projekta i voditi vas
173
122
 
174
- **Kako Početi**:
175
- ```
176
- @speccrew-feature-designer započni dizajn funkcija
177
- ```
123
+ ---
178
124
 
179
- **Radni Tok Agenta**:
180
- 1. Automatski locirajte potvrđeni PRD dokument
181
- 2. Učitajte poslovnu bazu znanja
182
- 3. Generišite dizajn funkcija (uključujući UI wireframe-ove, tokove interakcije, definicije podataka, API ugovore)
183
- 4. Za više PRD-ova, koristite Task Worker za paralelni dizajn
125
+ ## 4. Brzi Pregled Agenata
184
126
 
185
- **Isporuka**:
186
- ```
187
- iterations/{iter}/02.feature-design/
188
- └── [feature-name]-feature-spec.md # Dokument dizajna funkcija
189
- ```
127
+ | Uloga | Agent | Odgovornosti | Primjer Komande |
128
+ |------|-------|-----------------|-----------------|
129
+ | Vođa Tima | `@speccrew-team-leader` | Navigacija projektom, inicijalizacija baze znanja, provjera statusa | "Pomozite mi da počnem" |
130
+ | Menadžer Proizvoda | `@speccrew-product-manager` | Analiza zahtjeva, generisanje PRD | "Imam novi zahtjev: ..." |
131
+ | Dizajner Funkcija | `@speccrew-feature-designer` | Analiza funkcija, dizajn specifikacija, API ugovori | "Započni dizajn funkcija za iteraciju X" |
132
+ | Sistemski Dizajner | `@speccrew-system-designer` | Dizajn arhitekture, detaljni dizajn platforme | "Započni sistemski dizajn za iteraciju X" |
133
+ | Sistemski Programer | `@speccrew-system-developer` | Koordinacija razvoja, generisanje koda | "Započni razvoj za iteraciju X" |
134
+ | Menadžer Testiranja | `@speccrew-test-manager` | Planiranje testiranja, dizajn slučajeva, izvršenje | "Započni testiranje za iteraciju X" |
190
135
 
191
- **Kontrolna Lista Potvrde**:
192
- - [ ] Da li su svi korisnički scenariji pokriveni?
193
- - [ ] Da li su tokovi interakcije jasni?
194
- - [ ] Da li su definicije polja podataka kompletne?
195
- - [ ] Da li je rukovanje izuzecima sveobuhvatno?
136
+ > **Napomena**: Ne trebate pamtiti sve agente. Samo razgovarajte sa `@speccrew-team-leader` i on će usmjeriti vaš zahtjev pravom agentu.
196
137
 
197
138
  ---
198
139
 
199
- ### 4.3 Faza 3: Dizajn Sistema (System Designer)
140
+ ## 5. Pregled Radnog Procesa
200
141
 
201
- **Kako Početi**:
202
- ```
203
- @speccrew-system-designer započni dizajn sistema
204
- ```
142
+ ### Kompletni Dijagram Toka
205
143
 
206
- **Radni Tok Agenta**:
207
- 1. Locirajte Feature Spec i API Contract
208
- 2. Učitajte tehničku bazu znanja (tehnološki stek, arhitektura, specifikacije za svaku platformu)
209
- 3. **Kontrolna Tačka A**: Evaluacija Okvira — Analiza tehničkih praznina, preporuka novih okvira (ako je potrebno), čekanje potvrde korisnika
210
- 4. Generišite DESIGN-OVERVIEW.md
211
- 5. Koristite Task Worker za paralelnu distribuciju dizajna za svaku platformu (frontend/backend/mobile/desktop)
212
- 6. **Kontrolna Tačka B**: Zajednička Potvrda — Prikažite sažetak svih dizajna platformi, čekajte potvrdu korisnika
213
-
214
- **Isporuka**:
215
- ```
216
- iterations/{iter}/03.system-design/
217
- ├── DESIGN-OVERVIEW.md # Pregled dizajna
218
- ├── {platform-id}/
219
- │ ├── INDEX.md # Indeks dizajna platforme
220
- │ └── {module}-design.md # Dizajn modula na nivou pseudokoda
144
+ ```mermaid
145
+ flowchart LR
146
+ PRD[Faza 1<br/>Analiza Zahtjeva<br/>Product Manager] --> FD[Faza 2<br/>Feature Design<br/>Feature Designer]
147
+ FD --> SD[Faza 3<br/>System Design<br/>System Designer]
148
+ SD --> DEV[Faza 4<br/>Razvoj<br/>System Developer]
149
+ DEV --> TEST[Faza 5<br/>Sistemsko Testiranje<br/>Test Manager]
150
+ TEST --> ARCHIVE[Faza 6<br/>Arhiviranje]
151
+
152
+ KB[(Baza Znanja<br/>Kroz Cijeli Proces)] -.-> PRD
153
+ KB -.-> FD
154
+ KB -.-> SD
155
+ KB -.-> DEV
156
+ KB -.-> TEST
221
157
  ```
222
158
 
223
- **Kontrolna Lista Potvrde**:
224
- - [ ] Da li pseudokod koristi stvarnu sintaksu okvira?
225
- - [ ] Da li su cross-platform API ugovori konzistentni?
226
- - [ ] Da li je strategija rukovanja greškama ujedinjena?
227
-
228
- ---
229
-
230
- ### 4.4 Faza 4: Implementacija Razvoja (System Developer)
231
-
232
- **Kako Početi**:
233
- ```
234
- @speccrew-system-developer započni razvoj
235
- ```
159
+ ### Osnovni Principi
236
160
 
237
- **Radni Tok Agenta**:
238
- 1. Pročitajte dokumente dizajna sistema
239
- 2. Učitajte tehničko znanje za svaku platformu
240
- 3. **Kontrolna Tačka A**: Pred-verifikacija Okruženja — Verifikacija runtime verzija, zavisnosti, dostupnosti usluga; ako ne uspije, čekanje rješenja korisnika
241
- 4. Koristite Task Worker za paralelnu distribuciju razvoja za svaku platformu
242
- 5. Verifikacija integracije: Poravnanje API ugovora, konzistentnost podataka
243
- 6. Izlaz izvještaj o isporuci
161
+ 1. **Ovisnosti Faza**: Rezultat svake faze je ulaz za sljedeću fazu
162
+ 2. **Potvrda Checkpointa**: Svaka faza ima tačku potvrde koja zahtijeva odobrenje korisnika prije prelaska na sljedeću fazu
163
+ 3. **Vođeno Bazom Znanja**: Baza znanja prolazi kroz cijeli proces, pružajući kontekst za sve faze
244
164
 
245
- **Isporuka**:
246
- ```
247
- # Izvorni kod se piše u stvarni direktorij izvornog koda projekta
248
- iterations/{iter}/04.development/
249
- ├── {platform-id}/
250
- │ └── tasks/ # Zapisi razvojnih zadataka
251
- └── delivery-report.md
252
- ```
165
+ ---
253
166
 
254
- **Kontrolna Lista Potvrde**:
255
- - [ ] Da li je okruženje spremno?
256
- - [ ] Da li su integracioni problemi u prihvatljivom opsegu?
257
- - [ ] Da li kod prati specifikacije razvoja?
167
+ ## 6. Korak Nula: Inicijalizacija Baze Znanja
258
168
 
259
- ---
169
+ Prije pokretanja formalnog inženjerskog procesa, morate inicijalizovati bazu znanja projekta.
260
170
 
261
- ### 4.5 Faza 5: Testiranje Sistema (Test Manager)
171
+ ### 6.1 Inicijalizacija Tehničke Baze Znanja
262
172
 
263
- **Kako Početi**:
173
+ **Primjer Razgovora**:
264
174
  ```
265
- @speccrew-test-manager započni testiranje
175
+ @speccrew-team-leader inicijalizuj tehničku bazu znanja
266
176
  ```
267
177
 
268
- **Trofazni Proces Testiranja**:
269
-
270
- | Faza | Opis | Kontrolna Tačka |
271
- |------|------|-------------------|
272
- | Dizajn Test Slučajeva | Generisanje test slučajeva na osnovu PRD i Feature Spec | A: Prikažite statistiku pokrivenosti slučajeva i matricu sljedivosti, čekajte potvrdu korisnika o dovoljnoj pokrivenosti |
273
- | Generisanje Test Koda | Generisanje izvršnog test koda | B: Prikažite generisane test fajlove i mapiranje slučajeva, čekajte potvrdu korisnika |
274
- | Izvršavanje Testa i Izvještaj o Greškama | Automatsko izvršavanje testova i generisanje izvještaja | Nema (automatsko izvršavanje) |
178
+ **Trofazni Proces**:
179
+ 1. Detekcija Platforme — Identifikacija tehničkih platformi u projektu
180
+ 2. Generisanje Tehničke Dokumentacije Generisanje dokumenata tehničkih specifikacija za svaku platformu
181
+ 3. Generisanje Indeksa — Uspostavljanje indeksa baze znanja
275
182
 
276
- **Isporuka**:
183
+ **Rezultat**:
277
184
  ```
278
- iterations/{iter}/05.system-test/
279
- ├── cases/
280
- │ └── {platform-id}/ # Dokumenti test slučajeva
281
- ├── code/
282
- │ └── {platform-id}/ # Plan test koda
283
- ├── reports/
284
- │ └── test-report-{date}.md # Izvještaj o testiranju
285
- └── bugs/
286
- └── BUG-{id}-{title}.md # Izvještaji o greškama (jedan fajl po grešci)
185
+ speccrew-workspace/knowledges/techs/{platform-id}/
186
+ ├── tech-stack.md # Definicija tehnološkog steka
187
+ ├── architecture.md # Arhitektonske konvencije
188
+ ├── dev-spec.md # Specifikacije razvoja
189
+ ├── test-spec.md # Specifikacije testiranja
190
+ └── INDEX.md # Datoteka indeksa
287
191
  ```
288
192
 
289
- **Kontrolna Lista Potvrde**:
290
- - [ ] Da li je pokrivenost slučajeva kompletna?
291
- - [ ] Da li je test kod izvršiv?
292
- - [ ] Da li je procjena ozbiljnosti grešaka tačna?
293
-
294
- ---
295
-
296
- ### 4.6 Faza 6: Arhiviranje
297
-
298
- Iteracije se automatski arhiviraju kada se završe:
193
+ ### 6.2 Inicijalizacija Poslovne Baze Znanja
299
194
 
195
+ **Primjer Razgovora**:
300
196
  ```
301
- speccrew-workspace/iteration-archives/
302
- └── {broj}-{tip}-{ime}-{datum}/
303
- ├── 01.product-requirement/
304
- ├── 02.feature-design/
305
- ├── 03.system-design/
306
- ├── 04.development/
307
- └── 05.system-test/
197
+ @speccrew-team-leader inicijalizuj poslovnu bazu znanja
308
198
  ```
309
199
 
310
- ---
311
-
312
- ## 5. Pregled Baze Znanja
313
-
314
- ### 5.1 Poslovna Baza Znanja (bizs)
315
-
316
- **Svrha**: Čuvanje opisa poslovnih funkcija projekta, podjela modula, API karakteristika
200
+ **Četverofazni Proces**:
201
+ 1. Inventar Funkcija — Skeniranje koda za identifikaciju svih funkcija
202
+ 2. Analiza Funkcija — Analiza poslovne logike za svaku funkciju
203
+ 3. Sažetak Modula — Sažetak funkcija po modulu
204
+ 4. Sistemski Sažetak Generisanje poslovnog pregleda na nivou sistema
317
205
 
318
- **Struktura Direktorija**:
206
+ **Rezultat**:
319
207
  ```
320
- knowledges/bizs/
208
+ speccrew-workspace/knowledges/bizs/
321
209
  ├── {platform-type}/
322
210
  │ └── {module-name}/
323
211
  │ └── feature-spec.md
324
212
  └── system-overview.md
325
213
  ```
326
214
 
327
- **Scenariji Korištenja**: Product Manager, Feature Designer
328
-
329
- ### 5.2 Tehnička Baza Znanja (techs)
330
-
331
- **Svrha**: Čuvanje tehnološkog steka projekta, arhitektonskih konvencija, specifikacija razvoja, specifikacija testiranja
332
-
333
- **Struktura Direktorija**:
334
- ```
335
- knowledges/techs/{platform-id}/
336
- ├── tech-stack.md
337
- ├── architecture.md
338
- ├── dev-spec.md
339
- ├── test-spec.md
340
- └── INDEX.md
341
- ```
342
-
343
- **Scenariji Korištenja**: System Designer, System Developer, Test Manager
344
-
345
- ---
346
-
347
- ## 6. Upravljanje Napretkom Radnog Toka
348
-
349
- Virtuelni tim SpecCrew slijedi strog mehanizam faznih kapija, gdje svaka faza mora biti potvrđena od strane korisnika prije prelaska na sljedeću. Takođe podržava nastavljivu izvršnost — kada se ponovo pokrene nakon prekida, automatski nastavlja odakle je stao.
350
-
351
- ### 6.1 Trostruki Fajlovi Napretka
352
-
353
- Radni tok automatski održava tri tipa JSON fajlova napretka, lociranih u direktoriju iteracije:
354
-
355
- | Fajl | Lokacija | Svrha |
356
- |------|----------|---------|
357
- | `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Bilježi status svake faze pipeline-a |
358
- | `.checkpoints.json` | Ispod svakog direktorija faze | Bilježi status korisničke potvrde kontrolnih tačaka |
359
- | `DISPATCH-PROGRESS.json` | Ispod svakog direktorija faze | Bilježi napredak tačka-po-tačka za paralelne zadatke (multi-platforma/multi-modul) |
360
-
361
- ### 6.2 Tok Statusa Faze
362
-
363
- Svaka faza slijedi ovaj tok statusa:
364
-
365
- ```
366
- pending → in_progress → completed → confirmed
367
- ```
368
-
369
- - **pending**: Još nije započeto
370
- - **in_progress**: Trenutno se izvršava
371
- - **completed**: Izvršavanje Agenta završeno, čeka se korisnička potvrda
372
- - **confirmed**: Korisnik potvrdio kroz konačnu kontrolnu tačku, sljedeća faza može započeti
373
-
374
- ### 6.3 Nastavljiva Izvršnost
375
-
376
- Kada se Agent ponovo pokrene za fazu:
377
-
378
- 1. **Automatska uzvodna provjera**: Verificira da li je prethodna faza potvrđena, blokira i obavještava ako nije
379
- 2. **Oporavak kontrolnih tačaka**: Čita `.checkpoints.json`, preskače prođene kontrolne tačke, nastavlja od posljednje tačke prekida
380
- 3. **Oporavak paralelnih zadataka**: Čita `DISPATCH-PROGRESS.json`, ponovo izvršava samo zadatke sa `pending` ili `failed` statusom, preskače `completed` zadatke
381
-
382
- ### 6.4 Pregled Trenutnog Napretka
383
-
384
- Prikaži status panorame pipeline-a kroz Team Leader Agent:
385
-
386
- ```
387
- @speccrew-team-leader prikaži trenutni napredak iteracije
388
- ```
389
-
390
- Team Leader će pročitati fajlove napretka i prikazati pregled statusa sličan:
391
-
392
- ```
393
- Pipeline Status: i001-user-management
394
- 01 PRD: ✅ Potvrđeno
395
- 02 Feature Design: 🔄 U toku (Kontrolna tačka A prođena)
396
- 03 System Design: ⏳ Na čekanju
397
- 04 Development: ⏳ Na čekanju
398
- 05 System Test: ⏳ Na čekanju
399
- ```
400
-
401
- ### 6.5 Unazad Kompatibilnost
402
-
403
- Mehanizam fajlova napretka je potpuno unazad kompatibilan — ako fajlovi napretka ne postoje (npr. u starijim projektima ili novim iteracijama), svi Agenti će se normalno izvršavati u skladu sa originalnom logikom.
404
-
405
- ---
406
-
407
- ## 7. Često Postavljana Pitanja (FAQ)
408
-
409
- ### P1: Šta uraditi ako Agent ne radi kako se očekuje?
410
-
411
- 1. Pokrenite `speccrew doctor` da provjerite integritet instalacije
412
- 2. Potvrdite da je baza znanja inicijalizirana
413
- 3. Potvrdite da isporuka prethodne faze postoji u trenutnom direktoriju iteracije
414
-
415
- ### P2: Kako preskočiti fazu?
416
-
417
- **Ne preporučuje se** — Izlaz svake faze je ulaz za sljedeću fazu.
418
-
419
- Ako morate preskočiti, ručno pripremite ulazni dokument odgovarajuće faze i provjerite da prati specifikacije formata.
420
-
421
- ### P3: Kako upravljati višestrukim paralelnim zahtjevima?
422
-
423
- Kreirajte nezavisne direktorije iteracija za svaki zahtjev:
424
- ```
425
- iterations/
426
- ├── 001-feature-xxx/
427
- ├── 002-feature-yyy/
428
- └── 003-feature-zzz/
429
- ```
430
-
431
- Svaka iteracija je potpuno izolirana i ne utiče na druge.
432
-
433
- ### P4: Kako ažurirati verziju SpecCrew?
434
-
435
- Ažuriranje se vrši u dva koraka:
436
-
437
- ```bash
438
- # Korak 1: Ažurirajte globalni CLI alat
439
- npm install -g speccrew@latest
440
-
441
- # Korak 2: Sinhronizirajte Agente i Skill-ove u direktoriju projekta
442
- cd /path/to/your-project
443
- speccrew update
444
- ```
445
-
446
- - `npm install -g speccrew@latest`: Ažurira sam CLI alat (nova verzija može sadržavati nove definicije Agent/Skill, ispravke bugova, itd.)
447
- - `speccrew update`: Sinhronizira datoteke definicija Agenta i Skilla u projektu na najnoviju verziju
448
- - `speccrew update --ide cursor`: Ažurira samo konfiguraciju navedenog IDE-a
449
-
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.
451
-
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?
468
-
469
- Nakon arhiviranja, pogledajte u `speccrew-workspace/iteration-archives/`, organizirano u formatu `{broj}-{tip}-{ime}-{datum}/`.
470
-
471
- ### P7: Da li baza znanja treba redovno ažuriranje?
472
-
473
- Ponovna inicijalizacija je potrebna u sljedećim situacijama:
474
- - Značajne promjene u strukturi projekta
475
- - Ažuriranje ili zamjena tehnološkog steka
476
- - Dodavanje/uklanjanje poslovnih modula
477
-
478
215
  ---
479
216
 
480
- ## 8. Brza Referenca
481
-
482
- ### Brza Referenca Pokretanja Agenata
483
-
484
- | Faza | Agent | Početni Razgovor |
485
- |------|-------|-------------------|
486
-
487
- | Inicijalizacija | Team Leader | `@speccrew-team-leader inicijaliziraj tehničku bazu znanja` |
488
- | Analiza Zahtjeva | Product Manager | `@speccrew-product-manager imam novi zahtjev: [opis]` |
489
- | Dizajn Funkcija | Feature Designer | `@speccrew-feature-designer započni dizajn funkcija` |
490
- | Dizajn Sistema | System Designer | `@speccrew-system-designer započni dizajn sistema` |
491
- | Razvoj | System Developer | `@speccrew-system-developer započni razvoj` |
492
- | Testiranje Sistema | Test Manager | `@speccrew-test-manager započni testiranje` |
493
-
494
- ### Kontrolna Lista Kontrolnih Tačaka
495
-
496
- | Faza | Broj Kontrolnih Tačaka | Ključni Elementi Verifikacije |
497
- |------|------------------------|--------------------------------|
498
- | Analiza Zahtjeva | 1 | Tačnost zahtjeva, kompletnost poslovnih pravila, mjerljivost kriterija prihvatanja |
499
- | Dizajn Funkcija | 1 | Pokrivenost scenarija, jasnoća interakcije, kompletnost podataka, rukovanje izuzecima |
500
- | Dizajn Sistema | 2 | A: Evaluacija okvira; B: Sintaksa pseudokoda, cross-platform konzistentnost, rukovanje greškama |
501
- | Razvoj | 1 | A: Spremnost okruženja, integracioni problemi, specifikacije koda |
502
- | Testiranje Sistema | 2 | A: Pokrivenost slučajeva; B: Izvršivost test koda |
503
-
504
- ### Brza Referenca Putanja Isporuke
505
-
506
- | Faza | Izlazni Direktorij | Format Fajla |
507
- |------|------------------|-------------|
508
- | Analiza Zahtjeva | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
509
- | Dizajn Funkcija | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
510
- | Dizajn Sistema | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
511
- | Razvoj | `iterations/{iter}/04.development/` | Izvorni kod + `delivery-report.md` |
512
- | Testiranje Sistema | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
513
- | Arhiviranje | `iteration-archives/{iter}-{datum}/` | Potpuna kopija iteracije |
514
-
515
- ---
516
-
517
- ## Sljedeći Koraci
518
-
519
- 1. Pokrenite `speccrew init --ide qoder` da inicijalizirate svoj projekt
520
- 2. Izvršite Inicijalizaciju Baze Znanja
521
- 3. Napredujte kroz svaku fazu prateći radni tok, uživajte u iskustvu razvoja vođenog specifikacijama!
217
+ [ Nastavak sa svim sekcijama 7-11... ]