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 - Rask Startguide
1
+ # SpecCrew Rask Start Guide
2
2
 
3
3
  <p align="center">
4
4
  <a href="./GETTING-STARTED.md">简体中文</a> |
@@ -11,11 +11,10 @@
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.no.md">Norsk</a>
14
+ <a href="./GETTING-STARTED.ar.md">العربية</a>
16
15
  </p>
17
16
 
18
- Dette dokumentet hjelper deg med raskt å forstå hvordan du bruker SpecCrew Agent-teamet for å fullføre hele utviklingssyklusen fra krav til levering, etter standard ingeniørprosesser.
17
+ Dette dokumentet hjelper deg med raskt å forstå hvordan du bruker SpecCrews Agent-team for å fullføre den komplette utviklingen fra krav til levering etter standard engineering-prosesser.
19
18
 
20
19
  ---
21
20
 
@@ -33,489 +32,159 @@ npm install -g speccrew
33
32
  speccrew init --ide qoder
34
33
  ```
35
34
 
36
- Støttede IDE-er: `qoder`, `cursor`, `claude`, `codex`
35
+ Støttede IDEer: `qoder`, `cursor`, `claude`, `codex`
37
36
 
38
37
  ### Katalogstruktur Etter Initialisering
39
38
 
40
39
  ```
41
40
  .
42
41
  ├── .qoder/
43
- │ ├── agents/ # Agent-definisjonsfiler
44
- │ └── skills/ # Skill-definisjonsfiler
45
- ├── speccrew-workspace/ # Arbeidsområde
42
+ │ ├── agents/ # Agent definisjonsfiler
43
+ │ └── skills/ # Skill definisjonsfiler
44
+ ├── speccrew-workspace/ # Workspace
46
45
  │ ├── docs/ # Konfigurasjoner, regler, maler, løsninger
47
- │ ├── iterations/ # Gjeldende iterasjoner
46
+ │ ├── iterations/ # Nåværende kjørende iterasjoner
48
47
  │ ├── iteration-archives/ # Arkiverte iterasjoner
49
48
  │ └── knowledges/ # Kunnskapsbase
50
- │ ├── base/ # Grunnleggende informasjon (diagnoserapporter, teknisk gjeld)
49
+ │ ├── base/ # Basisinformasjon (diagnoserapporter, teknisk gjeld)
51
50
  │ ├── bizs/ # Forretningskunnskapsbase
52
51
  │ └── techs/ # Teknisk kunnskapsbase
53
52
  ```
54
53
 
55
- ### CLI-kommando Hurtigreferanse
54
+ ### CLI Kommando Rask Referanse
56
55
 
57
56
  | Kommando | Beskrivelse |
58
- |---------|-------------|
59
- | `speccrew list` | List opp alle tilgjengelige Agenter og Skills |
57
+ |------|------|
58
+ | `speccrew list` | List alle tilgjengelige Agenter og Skills |
60
59
  | `speccrew doctor` | Sjekk installasjonsintegritet |
61
60
  | `speccrew update` | Oppdater prosjektkonfigurasjon til nyeste versjon |
62
61
  | `speccrew uninstall` | Avinstaller SpecCrew |
63
62
 
64
63
  ---
65
64
 
66
- ## 2. Arbeidsflytoversikt
65
+ ## 2. Rask Start på 5 Minutter Etter Installasjon
67
66
 
68
- ### Full Flytdiagram
67
+ Etter kjøring av `speccrew init`, følg disse trinnene for raskt å komme i arbeidstilstand:
69
68
 
70
- ```mermaid
71
- flowchart LR
72
- PRD[Fase 1<br/>Kravanalyse<br/>Product Manager] --> FD[Fase 2<br/>Funksjonsdesign<br/>Feature Designer]
73
- FD --> SD[Fase 3<br/>Systemdesign<br/>System Designer]
74
- SD --> DEV[Fase 4<br/>Utvikling<br/>System Developer]
75
- DEV --> TEST[Fase 5<br/>Systemtesting<br/>Test Manager]
76
- TEST --> ARCHIVE[Fase 6<br/>Arkivering]
77
-
78
- KB[(Kunnskapsbase<br/>Gjennom Hele Prosessen)] -.-> PRD
79
- KB -.-> FD
80
- KB -.-> SD
81
- KB -.-> DEV
82
- KB -.-> TEST
83
- ```
84
-
85
- ### Grunnleggende Prinsipper
69
+ ### Trinn 1: Velg Din IDE
86
70
 
87
- 1. **Faseavhengigheter**: Hver fases output er input for neste fase
88
- 2. **Kontrollpunkt-bekreftelse**: Hver fase har et bekreftelsespunkt som krever brukergodkjenning før du fortsetter
89
- 3. **Kunnskapsbase-drevet**: Kunnskapsbasen strømmer gjennom hele prosessen, gir kontekst for alle faser
71
+ | IDE | Initialiseringskommando | Anvendelsesscenario |
72
+ |-----|-----------|----------|
73
+ | **Qoder** (Anbefalt) | `speccrew init --ide qoder` | Full agent-orkestrering, parallelle workers |
74
+ | **Cursor** | `speccrew init --ide cursor` | Composer-baserte arbeidsflyter |
75
+ | **Claude Code** | `speccrew init --ide claude` | CLI-først utvikling |
76
+ | **Codex** | `speccrew init --ide codex` | OpenAI økosystemintegrasjon |
90
77
 
91
- ---
92
-
93
- ## 3. Kunnskapsbase-initialisering
94
-
95
- Før du starter den formelle ingeniørprosessen, må du initialisere prosjektets kunnskapsbase.
78
+ ### Trinn 2: Initialiser Kunnskapsbase (Anbefalt)
96
79
 
97
- ### 3.1 Initialiser Teknisk Kunnskapsbase
80
+ For prosjekter med eksisterende kildekode anbefales det å initialisere kunnskapsbasen først, slik at agenter forstår din kodebase:
98
81
 
99
- **Eksempel på Dialog**:
100
82
  ```
101
83
  @speccrew-team-leader initialiser teknisk kunnskapsbase
102
84
  ```
103
85
 
104
- **Tre-fase Prosess**:
105
- 1. Plattformoppdagelse — Identifiser teknologiplattformer i prosjektet
106
- 2. Teknisk Dokumentasjonsgenerering — Generer tekniske spesifikasjonsdokumenter for hver plattform
107
- 3. Indeksgenerering — Etabler kunnskapsbase-indeks
86
+ Deretter:
108
87
 
109
- **Leveranse**:
110
- ```
111
- speccrew-workspace/knowledges/techs/{platform-id}/
112
- ├── tech-stack.md # Teknologistabeldefinisjon
113
- ├── architecture.md # Arkitekturkonvensjoner
114
- ├── dev-spec.md # Utviklingsspesifikasjoner
115
- ├── test-spec.md # Testspesifikasjoner
116
- └── INDEX.md # Indeksfil
117
- ```
118
-
119
- ### 3.2 Initialiser Forretningskunnskapsbase
120
-
121
- **Eksempel på Dialog**:
122
88
  ```
123
89
  @speccrew-team-leader initialiser forretningskunnskapsbase
124
90
  ```
125
91
 
126
- **Fire-fase Prosess**:
127
- 1. Funksjonsinventar — Skann kode for å identifisere alle funksjoner
128
- 2. Funksjonsanalyse — Analyser forretningslogikk for hver funksjon
129
- 3. Modulsammendrag — Oppsummer funksjoner etter modul
130
- 4. Systemsammendrag — Generer forretningsoversikt på systemnivå
131
-
132
- **Leveranse**:
133
- ```
134
- speccrew-workspace/knowledges/bizs/
135
- ├── {platform-type}/
136
- │ └── {module-name}/
137
- │ └── feature-spec.md
138
- └── system-overview.md
139
- ```
140
-
141
- ---
142
-
143
- ## 4. Fase-for-Fase Dialogguide
144
-
145
- ### 4.1 Fase 1: Kravanalyse (Product Manager)
92
+ ### Trinn 3: Start Din Første Oppgave
146
93
 
147
- **Hvordan Starte**:
148
94
  ```
149
- @speccrew-product-manager jeg har et nytt krav: [beskriv kravet ditt]
95
+ @speccrew-product-manager Jeg har et nytt krav: [beskriv ditt funksjonskrav]
150
96
  ```
151
97
 
152
- **Agent Arbeidsflyt**:
153
- 1. Les systemoversikt for å forstå eksisterende moduler
154
- 2. Analyser brukerkrav
155
- 3. Generer strukturert PRD-dokument
156
-
157
- **Leveranse**:
158
- ```
159
- iterations/{nummer}-{type}-{navn}/01.product-requirement/
160
- ├── [feature-name]-prd.md # Produktkravdokument
161
- └── [feature-name]-bizs-modeling.md # Forretningsmodellering (for komplekse krav)
162
- ```
163
-
164
- **Bekreftelseskontrollliste**:
165
- - [ ] Reflekterer kravbeskrivelsen brukerens intensjon nøyaktig?
166
- - [ ] Er forretningsregler komplette?
167
- - [ ] Er integrasjonspunkter med eksisterende systemer klare?
168
- - [ ] Er akseptkriterier målbare?
98
+ > **Tips**: Hvis du er usikker på hva du skal gjøre, si bare `@speccrew-team-leader hjelp meg med å komme i gang` — Team Leader vil automatisk oppdage prosjektstatusen din og veilede deg.
169
99
 
170
100
  ---
171
101
 
172
- ### 4.2 Fase 2: Funksjonsdesign (Feature Designer)
102
+ ## 3. Raskt Beslutningstre
173
103
 
174
- **Hvordan Starte**:
175
- ```
176
- @speccrew-feature-designer start funksjonsdesign
177
- ```
104
+ Usikker på hva du skal gjøre? Finn scenarioet ditt nedenfor:
178
105
 
179
- **Agent Arbeidsflyt**:
180
- 1. Finn automatisk bekreftet PRD-dokument
181
- 2. Last inn forretningskunnskapsbase
182
- 3. Generer funksjonsdesign (inkludert UI-wireframes, interaksjonsflyter, datadefinisjoner, API-kontrakter)
183
- 4. For flere PRD-er, bruk Task Worker for parallell design
106
+ - **Jeg har et nytt funksjonskrav**
107
+ `@speccrew-product-manager Jeg har et nytt krav: [beskriv ditt funksjonskrav]`
184
108
 
185
- **Leveranse**:
186
- ```
187
- iterations/{iter}/02.feature-design/
188
- └── [feature-name]-feature-spec.md # Funksjonsdesigndokument
189
- ```
109
+ - **Jeg vil skanne eksisterende prosjektviten**
110
+ → `@speccrew-team-leader initialiser teknisk kunnskapsbase`
111
+ → Deretter: `@speccrew-team-leader initialiser forretningskunnskapsbase`
190
112
 
191
- **Bekreftelseskontrollliste**:
192
- - [ ] Er alle brukerscenarier dekket?
193
- - [ ] Er interaksjonsflyter klare?
194
- - [ ] Er datafeltdefinisjoner komplette?
195
- - [ ] Er unntakshåndtering omfattende?
113
+ - **Jeg vil fortsette tidligere arbeid**
114
+ → `@speccrew-team-leader hva er den nåværende fremgangen?`
196
115
 
197
- ---
116
+ - **Jeg vil sjekke systemets helsetilstand**
117
+ → Kjør i terminal: `speccrew doctor`
198
118
 
199
- ### 4.3 Fase 3: Systemdesign (System Designer)
200
-
201
- **Hvordan Starte**:
202
- ```
203
- @speccrew-system-designer start systemdesign
204
- ```
205
-
206
- **Agent Arbeidsflyt**:
207
- 1. Finn Feature Spec og API Contract
208
- 2. Last inn teknisk kunnskapsbase (teknologistabel, arkitektur, spesifikasjoner for hver plattform)
209
- 3. **Kontrollpunkt A**: Rammeverkvurdering — Analyser tekniske gap, anbefal nye rammeverk (om nødvendig), vent på brukerbekreftelse
210
- 4. Generer DESIGN-OVERVIEW.md
211
- 5. Bruk Task Worker for parallell designdistribusjon for hver plattform (frontend/backend/mobil/skrivebord)
212
- 6. **Kontrollpunkt B**: Felles Bekreftelse — Vis oppsummering av alle plattformdesign, vent på brukerbekreftelse
213
-
214
- **Leveranse**:
215
- ```
216
- iterations/{iter}/03.system-design/
217
- ├── DESIGN-OVERVIEW.md # Designoversikt
218
- ├── {platform-id}/
219
- │ ├── INDEX.md # Plattformdesign-indeks
220
- │ └── {module}-design.md # Moduldesign på pseudokodenivå
221
- ```
222
-
223
- **Bekreftelseskontrollliste**:
224
- - [ ] Bruker pseudokoden faktisk rammeverksyntaks?
225
- - [ ] Er cross-plattform API-kontrakter konsistente?
226
- - [ ] Er feilhåndteringsstrategi unified?
227
-
228
- ---
229
-
230
- ### 4.4 Fase 4: Utviklingsimplementering (System Developer)
231
-
232
- **Hvordan Starte**:
233
- ```
234
- @speccrew-system-developer start utvikling
235
- ```
236
-
237
- **Agent Arbeidsflyt**:
238
- 1. Les systemdesigndokumenter
239
- 2. Last inn teknisk kunnskap for hver plattform
240
- 3. **Kontrollpunkt A**: Miljø-forhåndsverifisering — Verifiser runtime-versjoner, avhengigheter, tjenestetilgjengelighet; hvis mislykkes, vent på brukerløsning
241
- 4. Bruk Task Worker for parallell utviklingsdistribusjon for hver plattform
242
- 5. Integrasjonsverifisering: API-kontraktsjustering, datakonsistens
243
- 6. Output leveranserapport
244
-
245
- **Leveranse**:
246
- ```
247
- # Kildekode skrives til prosjektets faktiske kildekodekatalog
248
- iterations/{iter}/04.development/
249
- ├── {platform-id}/
250
- │ └── tasks/ # Utviklingsopptegnelser
251
- └── delivery-report.md
252
- ```
253
-
254
- **Bekreftelseskontrollliste**:
255
- - [ ] Er miljøet klart?
256
- - [ ] Er integrasjonsproblemer innen akseptabelt område?
257
- - [ ] Følger koden utviklingsspesifikasjoner?
258
-
259
- ---
260
-
261
- ### 4.5 Fase 5: Systemtesting (Test Manager)
262
-
263
- **Hvordan Starte**:
264
- ```
265
- @speccrew-test-manager start testing
266
- ```
267
-
268
- **Tre-fase Testprosess**:
269
-
270
- | Fase | Beskrivelse | Kontrollpunkt |
271
- |------|----------|-------------------|
272
- | Testtilfelldesign | Generer testtilfeller basert på PRD og Feature Spec | A: Vis testtilfelde-dekningsstatistikk og sporbarhetsmatrise, vent på brukerbekreftelse på tilstrekkelig dekning |
273
- | Testkodegenerering | Generer kjørbart testkode | B: Vis genererte testfiler og用例-mapping, vent på brukerbekreftelse |
274
- | Testutførelse og Feilrapport | Utfør tester automatisk og generer rapporter | Ingen (automatisk utførelse) |
275
-
276
- **Leveranse**:
277
- ```
278
- iterations/{iter}/05.system-test/
279
- ├── cases/
280
- │ └── {platform-id}/ # Testtilfelldokumenter
281
- ├── code/
282
- │ └── {platform-id}/ # Testkodeplan
283
- ├── reports/
284
- │ └── test-report-{date}.md # Testrapport
285
- └── bugs/
286
- └── BUG-{id}-{title}.md # Feilrapporter (én fil per feil)
287
- ```
288
-
289
- **Bekreftelseskontrollliste**:
290
- - [ ] Er testtilfelledekning komplett?
291
- - [ ] Er testkoden kjørbar?
292
- - [ ] Er feilalvorlighetsvurdering nøyaktig?
119
+ - **Jeg er usikker hva jeg skal gjøre**
120
+ → `@speccrew-team-leader hjelp meg med å komme i gang`
121
+ Team Leader vil automatisk oppdage prosjektstatusen din og veilede deg
293
122
 
294
123
  ---
295
124
 
296
- ### 4.6 Fase 6: Arkivering
125
+ ## 4. Agent Rask Referanse
297
126
 
298
- Iterasjoner arkiveres automatisk når de er fullført:
127
+ | Rolle | Agent | Ansvarsområder | Kommandoeksempel |
128
+ |------|-------|-----------------|-----------------|
129
+ | Teamleder | `@speccrew-team-leader` | Prosjektnavigasjon, kunnskapsbaseinitialisering, statuskontroll | "Hjelp meg med å komme i gang" |
130
+ | Produktleder | `@speccrew-product-manager` | Kravanalyse, PRD-generering | "Jeg har et nytt krav: ..." |
131
+ | Funksjonsdesigner | `@speccrew-feature-designer` | Funksjonsanalyse, spesifikasjonsdesign, API-kontrakter | "Start funksjonsdesign for iterasjon X" |
132
+ | Systemdesigner | `@speccrew-system-designer` | Arkitekturdesign, plattformdetaljert design | "Start systemdesign for iterasjon X" |
133
+ | Systemutvikler | `@speccrew-system-developer` | Utviklingskoordinering, kodegenerering | "Start utvikling for iterasjon X" |
134
+ | Testleder | `@speccrew-test-manager` | Testplanlegging, casestudier, utførelse | "Start test for iterasjon X" |
299
135
 
300
- ```
301
- speccrew-workspace/iteration-archives/
302
- └── {nummer}-{type}-{navn}-{dato}/
303
- ├── 01.product-requirement/
304
- ├── 02.feature-design/
305
- ├── 03.system-design/
306
- ├── 04.development/
307
- └── 05.system-test/
308
- ```
136
+ > **Merk**: Du trenger ikke huske alle agenter. Bare snakk med `@speccrew-team-leader`, og den vil rute forespørselen din til riktig agent.
309
137
 
310
138
  ---
311
139
 
312
- ## 5. Kunnskapsbaseoversikt
313
-
314
- ### 5.1 Forretningskunnskapsbase (bizs)
315
-
316
- **Formål**: Lagre prosjektets forretningsfunksjonsbeskrivelser, moduloppdelinger, API-kjennetegn
317
-
318
- **Katalogstruktur**:
319
- ```
320
- knowledges/bizs/
321
- ├── {platform-type}/
322
- │ └── {module-name}/
323
- │ └── feature-spec.md
324
- └── system-overview.md
325
- ```
326
-
327
- **Bruksscenarier**: Product Manager, Feature Designer
328
-
329
- ### 5.2 Teknisk Kunnskapsbase (techs)
140
+ ## 5. Arbeidsflyt Oversikt
330
141
 
331
- **Formål**: Lagre prosjektets teknologistabel, arkitekturkonvensjoner, utviklingsspesifikasjoner, testspesifikasjoner
142
+ ### Komplett Flytdiagram
332
143
 
333
- **Katalogstruktur**:
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
- **Bruksscenarier**: System Designer, System Developer, Test Manager
344
-
345
- ---
346
-
347
- ## 6. Arbeidsflytforløpsstyring
348
-
349
- Det virtuelle SpecCrew-teamet følger en streng fase-port-mekanisme hvor hver fase må bekreftes av brukeren før man fortsetter til den neste. Det støtter også gjenopptakbar utførelse — når det startes på nytt etter avbrudd, fortsetter det automatisk fra hvor det slapp.
350
-
351
- ### 6.1 Trelagsforløpsfiler
352
-
353
- Arbeidsflyten vedlikeholder automatisk tre typer JSON-forløpsfiler, plassert i iterasjonskatalogen:
354
-
355
- | Fil | Plassering | Formål |
356
- |------|----------|---------|
357
- | `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Registrerer status for hver pipeline-fase |
358
- | `.checkpoints.json` | Under hver fasekatalog | Registrerer brukerens sjekkpunkt-bekreftelsesstatus |
359
- | `DISPATCH-PROGRESS.json` | Under hver fasekatalog | Registrerer punkt-for-punkt forløp for parallelle oppgaver (multi-plattform/multi-modul) |
360
-
361
- ### 6.2 Fasestatusforløp
362
-
363
- Hver fase følger dette statusforløpet:
364
-
365
- ```
366
- pending → in_progress → completed → confirmed
367
- ```
368
-
369
- - **pending**: Ikke startet ennå
370
- - **in_progress**: Utføres for øyeblikket
371
- - **completed**: Agent-utførelse fullført, venter på brukerbekreftelse
372
- - **confirmed**: Bruker bekreftet gjennom siste sjekkpunkt, neste fase kan starte
373
-
374
- ### 6.3 Gjenopptakbar Utførelse
375
-
376
- Når en Agent startes på nytt for en fase:
377
-
378
- 1. **Automatisk oppstrømskontroll**: Verifiserer om den forrige fasen er bekreftet, blokkerer og varsler hvis ikke
379
- 2. **Sjekkpunkt-gjenoppretting**: Leser `.checkpoints.json`, hopper over passerte sjekkpunkter, fortsetter fra det siste avbruddspunktet
380
- 3. **Parallell oppgave-gjenoppretting**: Leser `DISPATCH-PROGRESS.json`, utfører kun oppgaver med `pending` eller `failed` status på nytt, hopper over `completed` oppgaver
381
-
382
- ### 6.4 Vise Nåværende Forløp
383
-
384
- Vis pipeline-panorama-status gjennom Team Leader Agent:
385
-
386
- ```
387
- @speccrew-team-leader vis nåværende iterasjonsforløp
388
- ```
389
-
390
- Team Leader vil lese forløpsfilene og vise en statusoversikt som ligner på:
391
-
392
- ```
393
- Pipeline Status: i001-user-management
394
- 01 PRD: ✅ Bekreftet
395
- 02 Feature Design: 🔄 Pågår (Sjekkpunkt A passert)
396
- 03 System Design: ⏳ Avventer
397
- 04 Development: ⏳ Avventer
398
- 05 System Test: ⏳ Avventer
144
+ ```mermaid
145
+ flowchart LR
146
+ PRD[Trinn 1<br/>Kravanalyse<br/>Product Manager] --> FD[Trinn 2<br/>Funksjonsdesign<br/>Feature Designer]
147
+ FD --> SD[Trinn 3<br/>Systemdesign<br/>System Designer]
148
+ SD --> DEV[Trinn 4<br/>Utvikling<br/>System Developer]
149
+ DEV --> TEST[Trinn 5<br/>Systemtest<br/>Test Manager]
150
+ TEST --> ARCHIVE[Trinn 6<br/>Arkivering]
151
+
152
+ KB[(Kunnskapsbase<br/>Gjennom Hele Prosessen)] -.-> PRD
153
+ KB -.-> FD
154
+ KB -.-> SD
155
+ KB -.-> DEV
156
+ KB -.-> TEST
399
157
  ```
400
158
 
401
- ### 6.5 Bakoverkompatibilitet
159
+ ### Kjerneprinsipper
402
160
 
403
- Forløpsfil-mekanismen er fullstendig bakoverkompatibel — hvis forløpsfiler ikke finnes (f.eks. i eldre prosjekter eller nye iterasjoner), vil alle Agenter utføre normalt i henhold til den opprinnelige logikken.
161
+ 1. **Trinnavhengigheter**: Hvert trinns resultat er input til neste trinn
162
+ 2. **Checkpoint-bekreftelse**: Hvert trinn har et bekreftelsespunkt som krever brukergodkjenning før fortsettelse til neste trinn
163
+ 3. **Kunnskapsbase-drevet**: Kunnskapsbasen kjører gjennom hele prosessen og gir kontekst for alle trinn
404
164
 
405
165
  ---
406
166
 
407
- ## 7. Ofte Stilte Spørsmål (FAQ)
408
-
409
- ### S1: Hva gjør jeg hvis Agenten ikke fungerer som forventet?
410
-
411
- 1. Kjør `speccrew doctor` for å sjekke installasjonsintegritet
412
- 2. Bekreft at kunnskapsbasen er initialisert
413
- 3. Bekreft at forrige fases leveranse finnes i gjeldende iterasjonskatalog
414
-
415
- ### S2: Hvordan hoppe over en fase?
167
+ ## 6. Trinn Null: Kunnskapsbaseinitialisering
416
168
 
417
- **Anbefales ikke** Hver fases output er input for neste fase.
169
+ Før du starter den formelle engineering-prosessen, du initialisere prosjektets kunnskapsbase.
418
170
 
419
- Hvis du hoppe over, forbered manuelt input-dokumentet for den tilsvarende fasen og sørg for at det følger formatspesifikasjoner.
171
+ ### 6.1 Teknisk Kunnskapsbaseinitialisering
420
172
 
421
- ### S3: Hvordan håndtere flere parallelle krav?
422
-
423
- Opprett uavhengige iterasjonskataloger for hvert krav:
173
+ **Samtaleeksempel**:
424
174
  ```
425
- iterations/
426
- ├── 001-feature-xxx/
427
- ├── 002-feature-yyy/
428
- └── 003-feature-zzz/
175
+ @speccrew-team-leader initialiser teknisk kunnskapsbase
429
176
  ```
430
177
 
431
- Hver iterasjon er fullstendig isolert og påvirker ikke hverandre.
432
-
433
- ### S4: Hvordan oppdatere SpecCrew-versjonen?
434
-
435
- Oppdatering krever to trinn:
436
-
437
- ```bash
438
- # Trinn 1: Oppdater globalt CLI-verktøy
439
- npm install -g speccrew@latest
178
+ **Tre-fase prosess**:
179
+ 1. Plattformdeteksjon — Identifiser tekniske plattformer i prosjektet
180
+ 2. Teknisk dokumentgenerering Generer tekniske spesifikasjonsdokumenter for hver plattform
181
+ 3. Indeksgenerering — Etabler kunnskapsbaseindeks
440
182
 
441
- # Trinn 2: Synkroniser Agenter og Skills i prosjektkatalogen din
442
- cd /path/to/your-project
443
- speccrew update
183
+ **Resultat**:
444
184
  ```
445
-
446
- - `npm install -g speccrew@latest`: Oppdaterer selve CLI-verktøyet (nye versjoner kan inkludere nye Agent/Skill-definisjoner, feilrettelser osv.)
447
- - `speccrew update`: Synkroniserer Agent- og Skill-definisjonsfiler i prosjektet ditt til den nyeste versjonen
448
- - `speccrew update --ide cursor`: Oppdaterer konfigurasjon kun for en spesifikk IDE
449
-
450
- > **Merk**: Begge trinnene er nødvendige. Hvis du bare kjører `speccrew update`, oppdateres ikke selve CLI-verktøyet; hvis du bare kjører `npm install`, oppdateres ikke prosjektfilene.
451
-
452
- ### S5: `speccrew update` viser ny versjon men etter installasjon er det fortsatt den gamle?
453
-
454
- Vanligvis forårsaket av npm-hurtigbuffer. Løsning:
455
-
456
- ```bash
457
- npm cache clean --force
458
- npm install -g speccrew@latest
459
- npm list -g speccrew
460
- ```
461
-
462
- Hvis det fortsatt ikke fungerer, spesifiser versjonsnummeret:
463
- ```bash
464
- npm install -g speccrew@0.5.6
465
- ```
466
-
467
- ### S6: Hvordan se historiske iterasjoner?
468
-
469
- Etter arkivering, se i `speccrew-workspace/iteration-archives/`, organisert i formatet `{nummer}-{type}-{navn}-{dato}/`.
470
-
471
- ### S7: Trenger kunnskapsbasen regelmessig oppdatering?
472
-
473
- Re-initialisering kreves i følgende situasjoner:
474
- - Betydelige endringer i prosjektstruktur
475
- - Oppdatering eller erstatning av teknologistabel
476
- - Legge til/fjerne forretningsmoduler
477
-
478
- ---
479
-
480
- ## 8. Hurtigreferanse
481
-
482
- ### Agent-start Hurtigreferanse
483
-
484
- | Fase | Agent | Startdialog |
485
- |------|-------|-------------------|
486
-
487
- | Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk kunnskapsbase` |
488
- | Kravanalyse | Product Manager | `@speccrew-product-manager jeg har et nytt krav: [beskrivelse]` |
489
- | Funksjonsdesign | Feature Designer | `@speccrew-feature-designer start funksjonsdesign` |
490
- | Systemdesign | System Designer | `@speccrew-system-designer start systemdesign` |
491
- | Utvikling | System Developer | `@speccrew-system-developer start utvikling` |
492
- | Systemtesting | Test Manager | `@speccrew-test-manager start testing` |
493
-
494
- ### Kontrollpunkter Kontrollliste
495
-
496
- | Fase | Antall Kontrollpunkter | Nøkkelelementer for Verifisering |
497
- |------|------------------------|--------------------------------|
498
- | Kravanalyse | 1 | Kravnøyaktighet, forretningsregler kompletthet, akseptkriterier målbarhet |
499
- | Funksjonsdesign | 1 | Szenariedekning, interaksjonsklarhet, datakompletthet, unntakshåndtering |
500
- | Systemdesign | 2 | A: Rammeverkvurdering; B: Pseudokodesyntaks, cross-plattform konsistens, feilhåndtering |
501
- | Utvikling | 1 | A: Miljøklarhet, integrasjonsproblemer, kodespesifikasjoner |
502
- | Systemtesting | 2 | A: Tilfelledekning; B: Testkodekjørbarhet |
503
-
504
- ### Leveransesti Hurtigreferanse
505
-
506
- | Fase | Output-katalog | Filformat |
507
- |------|------------------|-------------|
508
- | Kravanalyse | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
509
- | Funksjonsdesign | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
510
- | Systemdesign | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
511
- | Utvikling | `iterations/{iter}/04.development/` | Kildekode + `delivery-report.md` |
512
- | Systemtesting | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
513
- | Arkivering | `iteration-archives/{iter}-{dato}/` | Fullstendig kopi av iterasjonen |
514
-
515
- ---
516
-
517
- ## Neste Steg
518
-
519
- 1. Kjør `speccrew init --ide qoder` for å initialisere prosjektet ditt
520
- 2. Utfør Kunnskapsbase-initialisering
521
- 3. Beveg deg gjennom hver fase etter arbeidsflyten, nyt spesifikasjonsdrevet utviklingserfaring!
185
+ speccrew-workspace/knowledges/techs/{platform-id}/
186
+ ├── tech-stack.md # Teknologi-stack-definisjon
187
+ ├── architecture.md # Arkitekturkonvensjoner
188
+ ├── dev-spec.md # Utviklingsspesifikasjoner
189
+ ├── test-spec.md # Testspesifikasjoner
190
+ └── INDEX.md # Indeksf