speccrew 0.5.10 → 0.5.12
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.
- package/.speccrew/agents/speccrew-system-developer.md +242 -19
- package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/SKILL.md +38 -50
- package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/templates/TASK-RECORD-TEMPLATE.md +14 -28
- package/.speccrew/skills/speccrew-dev-desktop-tauri/SKILL.md +341 -0
- package/.speccrew/skills/speccrew-dev-desktop-tauri/templates/TASK-RECORD-TEMPLATE.md +145 -0
- package/.speccrew/skills/speccrew-dev-review-backend/SKILL.md +212 -0
- package/.speccrew/skills/speccrew-dev-review-backend/templates/REVIEW-REPORT-TEMPLATE.md +94 -0
- package/.speccrew/skills/speccrew-dev-review-desktop/SKILL.md +181 -0
- package/.speccrew/skills/speccrew-dev-review-desktop/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
- package/.speccrew/skills/speccrew-dev-review-frontend/SKILL.md +177 -0
- package/.speccrew/skills/speccrew-dev-review-frontend/templates/REVIEW-REPORT-TEMPLATE.md +83 -0
- package/.speccrew/skills/speccrew-dev-review-mobile/SKILL.md +181 -0
- package/.speccrew/skills/speccrew-dev-review-mobile/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
- package/docs/GETTING-STARTED.ar.md +249 -176
- package/docs/GETTING-STARTED.bn.md +108 -412
- package/docs/GETTING-STARTED.bs.md +103 -407
- package/docs/GETTING-STARTED.da.md +267 -190
- package/docs/GETTING-STARTED.de.md +190 -115
- package/docs/GETTING-STARTED.el.md +245 -169
- package/docs/GETTING-STARTED.es.md +179 -104
- package/docs/GETTING-STARTED.fr.md +191 -116
- package/docs/GETTING-STARTED.it.md +233 -156
- package/docs/GETTING-STARTED.ja.md +242 -167
- package/docs/GETTING-STARTED.ko.md +211 -136
- package/docs/GETTING-STARTED.no.md +86 -417
- package/docs/GETTING-STARTED.pl.md +213 -135
- package/docs/GETTING-STARTED.pt-BR.md +94 -396
- package/docs/GETTING-STARTED.ru.md +241 -162
- package/docs/GETTING-STARTED.th.md +104 -405
- package/docs/GETTING-STARTED.tr.md +223 -144
- package/docs/GETTING-STARTED.uk.md +273 -194
- package/docs/GETTING-STARTED.vi.md +98 -399
- package/lib/commands/init.js +10 -1
- package/lib/commands/update.js +9 -0
- package/lib/utils.js +26 -0
- package/package.json +1 -1
- package/.speccrew/skills/speccrew-dev-review/SKILL.md +0 -451
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# SpecCrew
|
|
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
|
|
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.
|
|
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/ #
|
|
44
|
-
│ └── skills/ #
|
|
45
|
-
├── speccrew-workspace/ #
|
|
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
|
|
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
|
-
###
|
|
54
|
+
### Brzi Pregled CLI Komandi
|
|
56
55
|
|
|
57
56
|
| Komanda | Opis |
|
|
58
|
-
|
|
59
|
-
| `speccrew list` | Lista svih dostupnih
|
|
60
|
-
| `speccrew doctor` |
|
|
61
|
-
| `speccrew update` |
|
|
62
|
-
| `speccrew uninstall` |
|
|
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.
|
|
65
|
+
## 2. Brzi Početak za 5 Minuta Nakon Instalacije
|
|
67
66
|
|
|
68
|
-
|
|
67
|
+
Nakon pokretanja `speccrew init`, slijedite ove korake za brzi ulazak u radno stanje:
|
|
69
68
|
|
|
70
|
-
|
|
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
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
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
|
-
|
|
78
|
+
### Korak 2: Inicijalizacija Baze Znanja (Preporučeno)
|
|
96
79
|
|
|
97
|
-
|
|
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
|
|
83
|
+
@speccrew-team-leader inicijalizuj tehničku bazu znanja
|
|
102
84
|
```
|
|
103
85
|
|
|
104
|
-
|
|
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-
|
|
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
|
|
92
|
+
### Korak 3: Započnite Vaš Prvi Zadatak
|
|
120
93
|
|
|
121
|
-
**Primjer Razgovora**:
|
|
122
94
|
```
|
|
123
|
-
@speccrew-
|
|
95
|
+
@speccrew-product-manager Imam novi zahtjev: [opišite vaš funkcionalni zahtjev]
|
|
124
96
|
```
|
|
125
97
|
|
|
126
|
-
|
|
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
|
-
##
|
|
102
|
+
## 3. Brzo Stablo Odlučivanja
|
|
144
103
|
|
|
145
|
-
|
|
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
|
-
**
|
|
153
|
-
|
|
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
|
-
**
|
|
158
|
-
|
|
159
|
-
|
|
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
|
-
|
|
165
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
175
|
-
```
|
|
176
|
-
@speccrew-feature-designer započni dizajn funkcija
|
|
177
|
-
```
|
|
123
|
+
---
|
|
178
124
|
|
|
179
|
-
|
|
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
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
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
|
-
**
|
|
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
|
-
|
|
140
|
+
## 5. Pregled Radnog Procesa
|
|
200
141
|
|
|
201
|
-
|
|
202
|
-
```
|
|
203
|
-
@speccrew-system-designer započni dizajn sistema
|
|
204
|
-
```
|
|
142
|
+
### Kompletni Dijagram Toka
|
|
205
143
|
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
4
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
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
|
-
|
|
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
|
-
**
|
|
238
|
-
|
|
239
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
###
|
|
171
|
+
### 6.1 Inicijalizacija Tehničke Baze Znanja
|
|
262
172
|
|
|
263
|
-
**
|
|
173
|
+
**Primjer Razgovora**:
|
|
264
174
|
```
|
|
265
|
-
@speccrew-
|
|
175
|
+
@speccrew-team-leader inicijalizuj tehničku bazu znanja
|
|
266
176
|
```
|
|
267
177
|
|
|
268
|
-
**Trofazni Proces
|
|
269
|
-
|
|
270
|
-
|
|
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
|
-
**
|
|
183
|
+
**Rezultat**:
|
|
277
184
|
```
|
|
278
|
-
|
|
279
|
-
├──
|
|
280
|
-
|
|
281
|
-
├──
|
|
282
|
-
|
|
283
|
-
|
|
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
|
-
|
|
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-
|
|
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
|
-
|
|
313
|
-
|
|
314
|
-
|
|
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
|
-
**
|
|
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
|
-
|
|
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... ]
|