speccrew 0.7.44 → 0.7.46

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 (50) hide show
  1. package/.speccrew/agents/speccrew-team-leader.md +6 -6
  2. package/README.ar.md +5 -17
  3. package/README.de.md +5 -17
  4. package/README.en.md +5 -17
  5. package/README.es.md +5 -17
  6. package/README.fr.md +5 -17
  7. package/README.hi.md +384 -0
  8. package/README.ja.md +5 -17
  9. package/README.md +5 -17
  10. package/README.pt-BR.md +5 -17
  11. package/README.ru.md +5 -17
  12. package/docs/GETTING-STARTED.ar.md +39 -40
  13. package/docs/GETTING-STARTED.de.md +39 -40
  14. package/docs/GETTING-STARTED.en.md +39 -40
  15. package/docs/GETTING-STARTED.es.md +39 -40
  16. package/docs/GETTING-STARTED.fr.md +39 -40
  17. package/docs/GETTING-STARTED.hi.md +636 -0
  18. package/docs/GETTING-STARTED.ja.md +39 -40
  19. package/docs/GETTING-STARTED.md +39 -40
  20. package/docs/GETTING-STARTED.pt-BR.md +25 -26
  21. package/docs/GETTING-STARTED.ru.md +37 -38
  22. package/lib/commands/init.js +3 -3
  23. package/package.json +1 -1
  24. package/workspace-template/scripts/update-progress.js +5 -1
  25. package/README.bn.md +0 -174
  26. package/README.bs.md +0 -394
  27. package/README.da.md +0 -394
  28. package/README.el.md +0 -174
  29. package/README.it.md +0 -394
  30. package/README.ko.md +0 -394
  31. package/README.no.md +0 -394
  32. package/README.pl.md +0 -394
  33. package/README.th.md +0 -311
  34. package/README.tr.md +0 -306
  35. package/README.uk.md +0 -306
  36. package/README.vi.md +0 -174
  37. package/README.zh-TW.md +0 -394
  38. package/docs/GETTING-STARTED.bn.md +0 -219
  39. package/docs/GETTING-STARTED.bs.md +0 -219
  40. package/docs/GETTING-STARTED.da.md +0 -637
  41. package/docs/GETTING-STARTED.el.md +0 -633
  42. package/docs/GETTING-STARTED.it.md +0 -639
  43. package/docs/GETTING-STARTED.ko.md +0 -639
  44. package/docs/GETTING-STARTED.no.md +0 -563
  45. package/docs/GETTING-STARTED.pl.md +0 -597
  46. package/docs/GETTING-STARTED.th.md +0 -219
  47. package/docs/GETTING-STARTED.tr.md +0 -597
  48. package/docs/GETTING-STARTED.uk.md +0 -597
  49. package/docs/GETTING-STARTED.vi.md +0 -217
  50. package/docs/GETTING-STARTED.zh-TW.md +0 -639
@@ -1,637 +0,0 @@
1
- # SpecCrew Hurtig Start Guide
2
-
3
- <p align="center">
4
- <a href="./GETTING-STARTED.md">简体中文</a> |
5
- <a href="./GETTING-STARTED.zh-TW.md">繁體中文</a> |
6
- <a href="./GETTING-STARTED.en.md">English</a> |
7
- <a href="./GETTING-STARTED.ko.md">한국어</a> |
8
- <a href="./GETTING-STARTED.de.md">Deutsch</a> |
9
- <a href="./GETTING-STARTED.es.md">Español</a> |
10
- <a href="./GETTING-STARTED.fr.md">Français</a> |
11
- <a href="./GETTING-STARTED.it.md">Italiano</a> |
12
- <a href="./GETTING-STARTED.da.md">Dansk</a> |
13
- <a href="./GETTING-STARTED.ja.md">日本語</a> |
14
- <a href="./GETTING-STARTED.ar.md">العربية</a>
15
- </p>
16
-
17
- Dette dokument hjælper dig med hurtigt at forstå, hvordan du bruger SpecCrews Agent-team til at fuldføre den komplette udvikling fra krav til levering efter standard engineering-processer.
18
-
19
- ---
20
-
21
- ## 1. Forudsætninger
22
-
23
- ### Installer SpecCrew
24
-
25
- ```bash
26
- npm install -g speccrew
27
- ```
28
-
29
- ### Initialiser Projekt
30
-
31
- ```bash
32
- speccrew init --ide qoder
33
- ```
34
-
35
- Understøttede IDE'er: `qoder`, `cursor`, `claude`, `codex`
36
-
37
- ### Mappestruktur Efter Initialisering
38
-
39
- ```
40
- .
41
- ├── .qoder/
42
- │ ├── agents/ # Agent definitionsfiler
43
- │ └── skills/ # Skill definitionsfiler
44
- ├── speccrew-workspace/ # Workspace
45
- │ ├── docs/ # Konfigurationer, regler, skabeloner, løsninger
46
- │ ├── iterations/ # Nuværende kørende iterationer
47
- │ ├── iteration-archives/ # Arkiverede iterationer
48
- │ └── knowledges/ # Vidensbase
49
- │ ├── base/ # Basisinformation (diagnoserapporter, teknisk gæld)
50
- │ ├── bizs/ # Forretningsvidensbase
51
- │ └── techs/ # Teknisk vidensbase
52
- ```
53
-
54
- ### CLI Kommando Hurtig Reference
55
-
56
- | Kommando | Beskrivelse |
57
- |------|------|
58
- | `speccrew list` | List alle tilgængelige Agenter og Skills |
59
- | `speccrew doctor` | Kontroller installationsintegritet |
60
- | `speccrew update` | Opdater projektkonfiguration til nyeste version |
61
- | `speccrew uninstall` | Afinstaller SpecCrew |
62
-
63
- ---
64
-
65
- ## 2. Hurtig Start på 5 Minutter Efter Installation
66
-
67
- Efter kørsel af `speccrew init`, følg disse trin for hurtigt at komme i arbejdstilstand:
68
-
69
- ### Trin 1: Vælg Din IDE
70
-
71
- | IDE | Initialiseringskommando | Anvendelsesscenarie |
72
- |-----|-----------|----------|
73
- | **Qoder** (Anbefalet) | `speccrew init --ide qoder` | Fuld agent-orkestrering, parallelle workers |
74
- | **Cursor** | `speccrew init --ide cursor` | Composer-baserede workflows |
75
- | **Claude Code** | `speccrew init --ide claude` | CLI-først udvikling |
76
- | **Codex** | `speccrew init --ide codex` | OpenAI økosystemintegration |
77
-
78
- ### Trin 2: Initialiser Vidensbase (Anbefalet)
79
-
80
- For projekter med eksisterende kildekode anbefales det at initialisere vidensbasen først, så agenter forstår din kodebase:
81
-
82
- ```
83
- @speccrew-team-leader initialiser teknisk vidensbase
84
- ```
85
-
86
- Derefter:
87
-
88
- ```
89
- @speccrew-team-leader initialiser forretningsvidensbase
90
- ```
91
-
92
- ### Trin 3: Start Din Første Opgave
93
-
94
- ```
95
- @speccrew-product-manager Jeg har et nyt krav: [beskriv dit funktionskrav]
96
- ```
97
-
98
- > **Tip**: Hvis du er usikker på hvad du skal gøre, sig blot `@speccrew-team-leader hjælp mig med at komme i gang` — Team Leader vil automatisk registrere din projektstatus og vejlede dig.
99
-
100
- ---
101
-
102
- ## 3. Hurtigt Beslutningstræ
103
-
104
- Usikker på hvad du skal gøre? Find dit scenarie nedenfor:
105
-
106
- - **Jeg har et nyt funktionskrav**
107
- → `@speccrew-product-manager Jeg har et nyt krav: [beskriv dit funktionskrav]`
108
-
109
- - **Jeg vil scanne eksisterende projektviden**
110
- → `@speccrew-team-leader initialiser teknisk vidensbase`
111
- → Derefter: `@speccrew-team-leader initialiser forretningsvidensbase`
112
-
113
- - **Jeg vil fortsætte tidligere arbejde**
114
- → `@speccrew-team-leader hvad er den aktuelle fremgang?`
115
-
116
- - **Jeg vil kontrollere systemets sundhedstilstand**
117
- → Kør i terminal: `speccrew doctor`
118
-
119
- - **Jeg er usikker på hvad jeg skal gøre**
120
- → `@speccrew-team-leader hjælp mig med at komme i gang`
121
- → Team Leader vil automatisk registrere din projektstatus og vejlede dig
122
-
123
- ---
124
-
125
- ## 4. Agent Hurtig Reference
126
-
127
- | Rolle | Agent | Ansvarsområder | Kommandoeksempel |
128
- |------|-------|-----------------|-----------------|
129
- | Teamleder | `@speccrew-team-leader` | Projektnavigation, vidensbaseinitialisering, statuskontrol | "Hjælp mig med at komme i gang" |
130
- | Produktchef | `@speccrew-product-manager` | Kravanalyse, PRD-generering | "Jeg har et nyt krav: ..." |
131
- | Funktionsdesigner | `@speccrew-feature-designer` | Funktionsanalyse, specifikationsdesign, API-kontrakter | "Start funktionsdesign for iteration X" |
132
- | Systemdesigner | `@speccrew-system-designer` | Arkitekturdesign, platformsdetaljeret design | "Start systemdesign for iteration X" |
133
- | Systemudvikler | `@speccrew-system-developer` | Udviklingskoordinering, kodegenerering | "Start udvikling for iteration X" |
134
- | Testchef | `@speccrew-test-manager` | Testplanlægning, casestudier, udførelse | "Start test for iteration X" |
135
-
136
- > **Bemærk**: Du behøver ikke huske alle agenter. Bare tal med `@speccrew-team-leader`, og den vil rute din anmodning til den rigtige agent.
137
-
138
- ---
139
-
140
- ## 5. Workflow Oversigt
141
-
142
- ### Komplet Flowdiagram
143
-
144
- ```mermaid
145
- flowchart LR
146
- PRD[Trin 1<br/>Kravanalyse<br/>Product Manager] --> FD[Trin 2<br/>Funktionsdesign<br/>Feature Designer]
147
- FD --> SD[Trin 3<br/>Systemdesign<br/>System Designer]
148
- SD --> DEV[Trin 4<br/>Udvikling<br/>System Developer]
149
- DEV --> DEPLOY[Trin 5<br/>Udrulning<br/>System Deployer]
150
- DEPLOY --> TEST[Trin 6<br/>Systemtest<br/>Test Manager]
151
- TEST --> ARCHIVE[Trin 7<br/>Arkivering]
152
-
153
- KB[(Vidensbase<br/>Gennem Hele Processen)] -.-> PRD
154
- KB -.-> FD
155
- KB -.-> SD
156
- KB -.-> DEV
157
- KB -.-> DEPLOY
158
- KB -.-> TEST
159
- ```
160
-
161
- ### Kerneprincipper
162
-
163
- 1. **Trinafhængigheder**: Hvert trins resultat er input til næste trin
164
- 2. **Checkpoint-bekræftelse**: Hvert trin har et bekræftelsespunkt, der kræver brugergodkendelse før fortsættelse til næste trin
165
- 3. **Vidensbase-drevet**: Vidensbasen kører gennem hele processen og giver kontekst til alle trin
166
-
167
- ---
168
-
169
- ## 6. Trin Nul: Vidensbaseinitialisering
170
-
171
- Før du starter den formelle engineering-proces, skal du initialisere projektets vidensbase.
172
-
173
- ### 6.1 Teknisk Vidensbaseinitialisering
174
-
175
- **Samtaleeksempel**:
176
- ```
177
- @speccrew-team-leader initialiser teknisk vidensbase
178
- ```
179
-
180
- **Tre-faset proces**:
181
- 1. Platformdetektering — Identificer tekniske platforme i projektet
182
- 2. Teknisk dokumentgeneration — Generer tekniske specifikationsdokumenter for hver platform
183
- 3. Indexgeneration — Etabler vidensbaseindex
184
-
185
- **Resultat**:
186
- ```
187
- speccrew-workspace/knowledges/techs/{platform-id}/
188
- ├── tech-stack.md # Teknologi-stack-definition
189
- ├── architecture.md # Arkitekturkonventioner
190
- ├── dev-spec.md # Udviklingsspecifikationer
191
- ├── test-spec.md # Tests specifikationer
192
- └── INDEX.md # Indexfil
193
- ```
194
-
195
- ### 6.2 Forretningsvidensbaseinitialisering
196
-
197
- **Samtaleeksempel**:
198
- ```
199
- @speccrew-team-leader initialiser forretningsvidensbase
200
- ```
201
-
202
- **Fire-faset proces**:
203
- 1. Funktionsliste — Scan kode for at identificere alle funktioner
204
- 2. Funktionsanalyse — Analyser forretningslogik for hver funktion
205
- 3. Modulopsummering — Opsummer funktioner efter modul
206
- 4. Systemopsummering — Generer systemniveau forretningsoverblik
207
-
208
- **Resultat**:
209
- ```
210
- speccrew-workspace/knowledges/bizs/
211
- ├── {platform-type}/
212
- │ └── {module-name}/
213
- │ └── feature-spec.md
214
- └── system-overview.md
215
- ```
216
-
217
- ---
218
-
219
- ## 7. Trin-for-Trin Samtaleguide
220
-
221
- ### 7.1 Trin 1: Kravanalyse (Product Manager)
222
-
223
- **Sådan startes**:
224
- ```
225
- @speccrew-product-manager Jeg har et nyt krav: [beskriv dit krav]
226
- ```
227
-
228
- **Agent Workflow**:
229
- 1. Læs systemoversigt for at forstå eksisterende moduler
230
- 2. Analyser brugers krav
231
- 3. Generer struktureret PRD-dokument
232
-
233
- **Resultat**:
234
- ```
235
- iterations/{nummer}-{type}-{navn}/01.product-requirement/
236
- ├── [feature-name]-prd.md # Produktkravdokument
237
- └── [feature-name]-bizs-modeling.md # Forretningsmodellering (for komplekse krav)
238
- ```
239
-
240
- **Bekræftelsespunkter**:
241
- - [ ] Beskriver kravet nøjagtigt brugerens hensigt?
242
- - [ ] Er forretningsregler komplette?
243
- - [ ] Er integrationspunkter med eksisterende systemer klare?
244
- - [ ] Er acceptkriterier målbare?
245
-
246
- ---
247
-
248
- ### 7.2 Trin 2: Funktionsdesign (Feature Designer)
249
-
250
- **Sådan startes**:
251
- ```
252
- @speccrew-feature-designer start funktionsdesign
253
- ```
254
-
255
- **Agent Workflow**:
256
- 1. Automatisk lokalisering af bekræftet PRD-dokument
257
- 2. Indlæs forretningsvidensbase
258
- 3. Generer funktionsdesign (inklusive UI-wireframes, interaktionsflows, datadefinitioner, API-kontrakter)
259
- 4. For flere PRD'er, brug Task Worker til parallelt design
260
-
261
- **Resultat**:
262
- ```
263
- iterations/{iter}/02.feature-design/
264
- └── [feature-name]-feature-spec.md # Funktionsdesign-dokument
265
- ```
266
-
267
- **Bekræftelsespunkter**:
268
- - [ ] Er alle brugerscenarier dækket?
269
- - [ ] Er interaktionsflows klare?
270
- - [ ] Er datafeltdefinitioner komplette?
271
- - [ ] Er undtagelseshåndtering omfattende?
272
-
273
- ---
274
-
275
- ### 7.3 Trin 3: Systemdesign (System Designer)
276
-
277
- **Sådan startes**:
278
- ```
279
- @speccrew-system-designer start systemdesign
280
- ```
281
-
282
- **Agent Workflow**:
283
- 1. Lokaliser Feature Spec og API Contract
284
- 2. Indlæs teknisk vidensbase (teknologi-stack, arkitektur, specifikationer for hver platform)
285
- 3. **Checkpoint A**: Framework-evaluering — Analyser tekniske kløfter, anbefal nye frameworks (hvis nødvendigt), vent på brugerbekræftelse
286
- 4. Generer DESIGN-OVERVIEW.md
287
- 5. Brug Task Worker til parallelt at distribuere design for hver platform (frontend/backend/mobil/desktop)
288
- 6. **Checkpoint B**: Fælles bekræftelse — Vis resume af alle platformdesign, vent på brugerbekræftelse
289
-
290
- **Resultat**:
291
- ```
292
- iterations/{iter}/03.system-design/
293
- ├── DESIGN-OVERVIEW.md # Designoversigt
294
- ├── {platform-id}/
295
- │ ├── INDEX.md # Platformdesignindex
296
- │ └── {module}-design.md # Pseudokode-niveau moduldesign
297
- ```
298
-
299
- **Bekræftelsespunkter**:
300
- - [ ] Bruger pseudokoden faktisk frameworks syntaks?
301
- - [ ] Er cross-platform API-kontrakter konsistente?
302
- - [ ] Er fejlhåndteringsstrategi ensartet?
303
-
304
- ---
305
-
306
- ### 7.4 Trin 4: Udvikling (System Developer)
307
-
308
- **Sådan startes**:
309
- ```
310
- @speccrew-system-developer start udvikling
311
- ```
312
-
313
- **Agent Workflow**:
314
- 1. Læs systemdesigndokumenter
315
- 2. Indlæs teknisk viden for hver platform
316
- 3. **Checkpoint A**: Miljøforhåndskontrol — Kontroller runtime-versioner, afhængigheder, servicetilgængelighed; vent på brugerløsning hvis det fejler
317
- 4. Brug Task Worker til parallelt at distribuere udvikling for hver platform
318
- 5. Integrationskontrol: API-kontraktjustering, datakonsistens
319
- 6. Output leveringsrapport
320
-
321
- **Resultat**:
322
- ```
323
- # Kildekode skrives til projektets faktiske kildemappe
324
- iterations/{iter}/04.development/
325
- ├── {platform-id}/
326
- │ └── tasks/ # Udviklingsopgaveregistre
327
- └── delivery-report.md
328
- ```
329
-
330
- **Bekræftelsespunkter**:
331
- - [ ] Er miljøet klar?
332
- - [ ] Er integrationsproblemer inden for acceptabelt område?
333
- - [ ] Overholder koden udviklingsspecifikationerne?
334
-
335
- ---
336
-
337
- ### 7.5 Trin 5: Udrulning (System Deployer)
338
-
339
- **Sådan startes**:
340
- ```
341
- @speccrew-system-deployer start udrulning
342
- ```
343
-
344
- **Agent Workflow**:
345
- 1. Verificer at udviklingsfasen er fuldført (Stage Gate)
346
- 2. Indlæs teknisk vidensbase (build-konfiguration, database-migreringskonfiguration, servicestart-kommandoer)
347
- 3. **Checkpoint**: Miljøforhåndskontrol — Verificer build-værktøjer, runtime-versioner, afhængighedstilgængelighed
348
- 4. Udfør udrulningsskills i rækkefølge: Build → Database-migrering → Servicestart → Smoke Test
349
- 5. Output udrulningsrapport
350
-
351
- > 💡 **Tip**: For projekter uden database springes migreringstrinnet automatisk over; for klient-applikationer (desktop/mobil) bruges proces-verifikationsmode i stedet for HTTP-sundhedstjek.
352
-
353
- **Resultat**:
354
- ```
355
- iterations/{iter}/05.deployment/
356
- ├── {platform-id}/
357
- │ ├── deployment-plan.md # Udrulningsplan
358
- │ └── deployment-log.md # Udrulnings-eksekveringslog
359
- └── deployment-report.md # Udrulnings-fuldførelsesrapport
360
- ```
361
-
362
- **Bekræftelsespunkter**:
363
- - [ ] Er bygningen fuldført succesfuldt?
364
- - [ ] Er alle database-migreringsskripter udført succesfuldt (hvis relevant)?
365
- - [ ] Er applikationen startet og bestået sundhedstjek?
366
- - [ ] Er alle smoke tests bestået?
367
-
368
- ---
369
-
370
- ### 7.6 Trin 6: Systemtest (Test Manager)
371
-
372
- **Sådan startes**:
373
- ```
374
- @speccrew-test-manager start test
375
- ```
376
-
377
- **Tre-faset testproces**:
378
-
379
- | Fase | Beskrivelse | Checkpoint |
380
- |-------|-------------|------------|
381
- | Testcasedesign | Generer testcases baseret på PRD og Feature Spec | A: Vis testcase-dækningsstatistik og sporbarhedsmatrix, vent på brugerbekræftelse af tilstrækkelig dækning |
382
- | Testkodegenerering | Generer eksekverbar testkode | B: Vis genererede testfiler og casemapping, vent på brugerbekræftelse |
383
- | Testudførelse og Bug-rapportering | Kør automatisk tests og generer rapporter | Ingen (automatisk udførelse) |
384
-
385
- **Resultat**:
386
- ```
387
- iterations/{iter}/06.system-test/
388
- ├── cases/
389
- │ └── {platform-id}/ # Testcasedokumenter
390
- ├── code/
391
- │ └── {platform-id}/ # Testkodeplan
392
- ├── reports/
393
- │ └── test-report-{date}.md # Testrapport
394
- └── bugs/
395
- └── BUG-{id}-{title}.md # Bug-rapporter (én fil pr. bug)
396
- ```
397
-
398
- **Bekræftelsespunkter**:
399
- - [ ] Er casedækning komplet?
400
- - [ ] Er testkode kørbar?
401
- - [ ] Er bug-alvorlighedsvurdering præcis?
402
-
403
- ---
404
-
405
- ### 7.7 Trin 7: Arkivering
406
-
407
- Iterationer arkiveres automatisk efter fuldførelse:
408
-
409
- ```
410
- speccrew-workspace/iteration-archives/
411
- └── {nummer}-{type}-{navn}-{dato}/
412
- ├── 01.product-requirement/
413
- ├── 02.feature-design/
414
- ├── 03.system-design/
415
- ├── 04.development/
416
- ├── 05.deployment/
417
- └── 06.system-test/
418
- ```
419
-
420
- ---
421
-
422
- ## 8. Vidensbase Oversigt
423
-
424
- ### 8.1 Forretningsvidensbase (bizs)
425
-
426
- **Formål**: Gem projektets forretningsfunktionsbeskrivelser, modulopdelinger, API-karakteristika
427
-
428
- **Mappestruktur**:
429
- ```
430
- knowledges/bizs/
431
- ├── {platform-type}/
432
- │ └── {module-name}/
433
- │ └── feature-spec.md
434
- └── system-overview.md
435
- ```
436
-
437
- **Anvendelsesscenarier**: Product Manager, Feature Designer
438
-
439
- ### 8.2 Teknisk Vidensbase (techs)
440
-
441
- **Formål**: Gem projektets teknologi-stack, arkitekturkonventioner, udviklingsspecifikationer, tests specifikationer
442
-
443
- **Mappestruktur**:
444
- ```
445
- knowledges/techs/{platform-id}/
446
- ├── tech-stack.md
447
- ├── architecture.md
448
- ├── dev-spec.md
449
- ├── test-spec.md
450
- └── INDEX.md
451
- ```
452
-
453
- **Anvendelsesscenarier**: System Designer, System Developer, Test Manager
454
-
455
- ---
456
-
457
- ## 9. Workflow Fremskridtshåndtering
458
-
459
- SpecCrew virtuelle team følger en streng fase-gating-mekanisme, hvor hver fase skal bekræftes af brugeren, før den går videre til næste. Den understøtter også genoptagelig udførelse — når den genstartes efter afbrydelse, fortsætter den automatisk fra hvor den slap.
460
-
461
- ### 9.1 Tre-lags Fremskridtsfiler
462
-
463
- Workflowet vedligeholder automatisk tre typer JSON-fremskridtsfiler, placeret i iterationsmappen:
464
-
465
- | Fil | Placering | Formål |
466
- |------|----------|---------|
467
- | `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Registrerer status for hver pipeline-fase |
468
- | `.checkpoints.json` | Under hver fasemappe | Registrerer brugercheckpoint-bekræftelsesstatus |
469
- | `DISPATCH-PROGRESS.json` | Under hver fasemappe | Registrerer element-for-element fremskridt for parallelle opgaver (multi-platform/multi-modul) |
470
-
471
- ### 9.2 Fasestatus Flow
472
-
473
- Hver fase følger denne status flow:
474
-
475
- ```
476
- pending → in_progress → completed → confirmed
477
- ```
478
-
479
- - **pending**: Endnu ikke startet
480
- - **in_progress**: Under udførelse
481
- - **completed**: Agent-udførelse fuldført, venter på brugerbekræftelse
482
- - **confirmed**: Bruger bekræftet via endeligt checkpoint, næste fase kan starte
483
-
484
- ### 9.3 Genoptagelig Udførelse
485
-
486
- Når du genstarter en Agent for en fase:
487
-
488
- 1. **Automatisk upstream-kontrol**: Verificerer om forrige fase er bekræftet, blokerer og prompter hvis ikke
489
- 2. **Checkpoint-genopretning**: Læser `.checkpoints.json`, springer beståede checkpoints over, fortsætter fra sidste afbrydelsespunkt
490
- 3. **Parallelle opgave-genopretning**: Læser `DISPATCH-PROGRESS.json`, genudfører kun opgaver med `pending` eller `failed` status, springer `completed` opgaver over
491
-
492
- ### 9.4 Se Nuværende Fremskridt
493
-
494
- Se pipeline-panoramastatus via Team Leader Agent:
495
-
496
- ```
497
- @speccrew-team-leader se nuværende iterationsfremskridt
498
- ```
499
-
500
- Team Leader vil læse fremskridtsfilerne og vise en statusoversigt svarende til:
501
-
502
- ```
503
- Pipeline Status: i001-user-management
504
- 01 PRD: ✅ Confirmed
505
- 02 Feature Design: 🔄 In Progress (Checkpoint A passed)
506
- 03 System Design: ⏳ Pending
507
- 04 Development: ⏳ Pending
508
- 05 Deployment: ⏳ Pending
509
- 06 System Test: ⏳ Pending
510
- ```
511
-
512
- ### 9.5 Bagudkompatibilitet
513
-
514
- Fremskridtsfil-mekanismen er fuldt bagudkompatibel — hvis fremskridtsfiler ikke eksisterer (f.eks. i ældre projekter eller nye iterationer), vil alle Agenter køre normalt ifølge den oprindelige logik.
515
-
516
- ---
517
-
518
- ## 10. Ofte Stillede Spørgsmål (FAQ)
519
-
520
- ### S1: Hvad gør jeg hvis Agenten ikke fungerer som forventet?
521
-
522
- 1. Kør `speccrew doctor` for at kontrollere installationsintegritet
523
- 2. Bekræft at vidensbasen er blevet initialiseret
524
- 3. Bekræft at resultatet fra forrige fase findes i den aktuelle iterationsmappe
525
-
526
- ### S2: Hvordan springer jeg en fase over?
527
-
528
- **Anbefales ikke** — Hver fases output er input til næste fase.
529
-
530
- Hvis du skal springe over, skal du manuelt forberede inputdokumentet for den tilsvarende fase og sikre, at det overholder formatspecifikationerne.
531
-
532
- ### S3: Hvordan håndterer jeg flere parallelle krav?
533
-
534
- Opret uafhængige iterationsmapper for hvert krav:
535
- ```
536
- iterations/
537
- ├── 001-feature-xxx/
538
- ├── 002-feature-yyy/
539
- └── 003-feature-zzz/
540
- ```
541
-
542
- Hver iteration er fuldstændigt isoleret og påvirker ikke andre.
543
-
544
- ### S4: Hvordan opdaterer jeg SpecCrew-versionen?
545
-
546
- Opdatering kræver to trin:
547
-
548
- ```bash
549
- # Trin 1: Opdater det globale CLI-værktøj
550
- npm install -g speccrew@latest
551
-
552
- # Trin 2: Synkroniser Agenter og Skills i din projektmappe
553
- cd /path/to/your-project
554
- speccrew update
555
- ```
556
-
557
- - `npm install -g speccrew@latest`: Opdaterer CLI-værktøjet selv (nye versioner kan indeholde nye Agent/Skill-definitioner, fejlrettelser osv.)
558
- - `speccrew update`: Synkroniserer Agent- og Skill-definitions filer i dit projekt til nyeste version
559
- - `speccrew update --ide cursor`: Opdaterer kun konfiguration for specifik IDE
560
-
561
- > **Bemærk**: Begge trin er påkrævet. Kun at køre `speccrew update` vil ikke opdatere CLI-værktøjet selv; kun at køre `npm install` vil ikke opdatere projektfiler.
562
-
563
- ### S5: `speccrew update` viser ny version tilgængelig men `npm install -g speccrew@latest` installerer stadig den gamle version?
564
-
565
- Dette skyldes normalt npm-cache. Løsning:
566
-
567
- ```bash
568
- # Ryd npm-cache og geninstaller
569
- npm cache clean --force
570
- npm install -g speccrew@latest
571
-
572
- # Verificer version
573
- npm list -g speccrew
574
- ```
575
-
576
- Hvis det stadig ikke virker, prøv at installere med specifikt versionsnummer:
577
- ```bash
578
- npm install -g speccrew@0.5.6
579
- ```
580
-
581
- ### S6: Hvordan ser jeg historiske iterationer?
582
-
583
- Efter arkivering, se i `speccrew-workspace/iteration-archives/`, organiseret efter `{nummer}-{type}-{navn}-{dato}/` format.
584
-
585
- ### S7: Skal vidensbasen opdateres regelmæssigt?
586
-
587
- Geninitialisering er påkrævet i følgende situationer:
588
- - Større ændringer i projektstruktur
589
- - Teknologi-stack-opgradering eller udskiftning
590
- - Tilføjelse/fjernelse af forretningsmoduler
591
-
592
- ---
593
-
594
- ## 11. Hurtig Reference
595
-
596
- ### Agent Start Hurtig Reference
597
-
598
- | Fase | Agent | Start Samtale |
599
- |-------|-------|-------------------|
600
- | Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk vidensbase` |
601
- | Kravanalyse | Product Manager | `@speccrew-product-manager Jeg har et nyt krav: [beskrivelse]` |
602
- | Funktionsdesign | Feature Designer | `@speccrew-feature-designer start funktionsdesign` |
603
- | Systemdesign | System Designer | `@speccrew-system-designer start systemdesign` |
604
- | Udvikling | System Developer | `@speccrew-system-developer start udvikling` |
605
- | Udrulning | System Deployer | `@speccrew-system-deployer start udrulning` |
606
- | Systemtest | Test Manager | `@speccrew-test-manager start test` |
607
-
608
- ### Checkpoint Tjekliste
609
-
610
- | Fase | Antal Checkpoints | Vigtige Kontrolpunkter |
611
- |-------|----------------------|-----------------|
612
- | Kravanalyse | 1 | Kravnøjagtighed, forretningsregelkomplethed, acceptkriteriemålbarhed |
613
- | Funktionsdesign | 1 | Scenariedækning, interaktionsklarhed, datakomplethed, undtagelseshåndtering |
614
- | Systemdesign | 2 | A: Framework-evaluering; B: Pseudokode syntaks, cross-platform konsistens, fejlhåndtering |
615
- | Udvikling | 1 | A: Miljøklarhed, integrationsproblemer, kodespecifikationer |
616
- | Udrulning | 1 | Build-succes, migreringsfuldførelse, servicestart, smoke test bestået |
617
- | Systemtest | 2 | A: Casedækning; B: Testkode-kørbarhed |
618
-
619
- ### Resultatsti Hurtig Reference
620
-
621
- | Fase | Output-mappe | Filformat |
622
- |-------|-----------------|-------------|
623
- | Kravanalyse | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
624
- | Funktionsdesign | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
625
- | Systemdesign | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
626
- | Udvikling | `iterations/{iter}/04.development/` | Kildekode + `delivery-report.md` |
627
- | Udrulning | `iterations/{iter}/05.deployment/` | `deployment-plan.md`, `deployment-log.md`, `deployment-report.md` |
628
- | Systemtest | `iterations/{iter}/06.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
629
- | Arkivering | `iteration-archives/{iter}-{date}/` | Komplet iterationskopi |
630
-
631
- ---
632
-
633
- ## Næste Trin
634
-
635
- 1. Kør `speccrew init --ide qoder` for at initialisere dit projekt
636
- 2. Udfør Trin Nul: Vidensbaseinitialisering
637
- 3. Gå frem fase for fase ifølge workflowet, nyd den specifikationsdrevne udviklingsoplevelse!