speccrew 0.6.0 → 0.6.1

package/docs/GETTING-STARTED.no.md

@@ -1,4 +1,4 @@
-# SpecCrew Rask Start Guide
+# SpecCrew - Rask Startguide
 
 <p align="center">
   <a href="./GETTING-STARTED.md">简体中文</a> |
@@ -11,10 +11,11 @@
   <a href="./GETTING-STARTED.it.md">Italiano</a> |
   <a href="./GETTING-STARTED.da.md">Dansk</a> |
   <a href="./GETTING-STARTED.ja.md">日本語</a> |
-  <a href="./GETTING-STARTED.ar.md">العربية</a>
+  <a href="./GETTING-STARTED.ar.md">العربية</a> |
+  <a href="./GETTING-STARTED.no.md">Norsk</a>
 </p>
 
-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.
+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.
 
 ---
 
@@ -32,159 +33,531 @@ npm install -g speccrew
 speccrew init --ide qoder
 ```
 
-Støttede IDEer: `qoder`, `cursor`, `claude`, `codex`
+Støttede IDE-er: `qoder`, `cursor`, `claude`, `codex`
 
 ### Katalogstruktur Etter Initialisering
 
 ```
 .
 ├── .qoder/
-│   ├── agents/          # Agent definisjonsfiler
-│   └── skills/          # Skill definisjonsfiler
-├── speccrew-workspace/  # Workspace
+│   ├── agents/          # Agent-definisjonsfiler
+│   └── skills/          # Skill-definisjonsfiler
+├── speccrew-workspace/  # Arbeidsområde
 │   ├── docs/            # Konfigurasjoner, regler, maler, løsninger
-│   ├── iterations/      # Nåværende kjørende iterasjoner
+│   ├── iterations/      # Gjeldende iterasjoner
 │   ├── iteration-archives/  # Arkiverte iterasjoner
 │   └── knowledges/      # Kunnskapsbase
-│       ├── base/        # Basisinformasjon (diagnoserapporter, teknisk gjeld)
+│       ├── base/        # Grunnleggende informasjon (diagnoserapporter, teknisk gjeld)
 │       ├── bizs/        # Forretningskunnskapsbase
 │       └── techs/       # Teknisk kunnskapsbase
 ```
 
-### CLI Kommando Rask Referanse
+### CLI-kommando Hurtigreferanse
 
 | Kommando | Beskrivelse |
-|------|------|
-| `speccrew list` | List alle tilgjengelige Agenter og Skills |
+|---------|-------------|
+| `speccrew list` | List opp alle tilgjengelige Agenter og Skills |
 | `speccrew doctor` | Sjekk installasjonsintegritet |
 | `speccrew update` | Oppdater prosjektkonfigurasjon til nyeste versjon |
 | `speccrew uninstall` | Avinstaller SpecCrew |
 
 ---
 
-## 2. Rask Start på 5 Minutter Etter Installasjon
+## 2. Arbeidsflytoversikt
 
-Etter kjøring av `speccrew init`, følg disse trinnene for raskt å komme i arbeidstilstand:
+### Full Flytdiagram
 
-### Trinn 1: Velg Din IDE
+```mermaid
+flowchart LR
+    PRD[Fase 1<br/>Kravanalyse<br/>Product Manager] --> FD[Fase 2<br/>Funksjonsdesign<br/>Feature Designer]
+    FD --> SD[Fase 3<br/>Systemdesign<br/>System Designer]
+    SD --> DEV[Fase 4<br/>Utvikling<br/>System Developer]
+    DEV --> DEPLOY[Fase 5<br/>Utrulling<br/>System Deployer]
+    DEPLOY --> TEST[Fase 6<br/>Systemtesting<br/>Test Manager]
+    TEST --> ARCHIVE[Fase 7<br/>Arkivering]
+    
+    KB[(Kunnskapsbase<br/>Gjennom Hele Prosessen)] -.-> PRD
+    KB -.-> FD
+    KB -.-> SD
+    KB -.-> DEV
+    KB -.-> DEPLOY
+    KB -.-> TEST
+```
 
-| IDE | Initialiseringskommando | Anvendelsesscenario |
-|-----|-----------|----------|
-| **Qoder** (Anbefalt) | `speccrew init --ide qoder` | Full agent-orkestrering, parallelle workers |
-| **Cursor** | `speccrew init --ide cursor` | Composer-baserte arbeidsflyter |
-| **Claude Code** | `speccrew init --ide claude` | CLI-først utvikling |
-| **Codex** | `speccrew init --ide codex` | OpenAI økosystemintegrasjon |
+### Grunnleggende Prinsipper
 
-### Trinn 2: Initialiser Kunnskapsbase (Anbefalt)
+1. **Faseavhengigheter**: Hver fases output er input for neste fase
+2. **Kontrollpunkt-bekreftelse**: Hver fase har et bekreftelsespunkt som krever brukergodkjenning før du fortsetter
+3. **Kunnskapsbase-drevet**: Kunnskapsbasen strømmer gjennom hele prosessen, gir kontekst for alle faser
+
+---
 
-For prosjekter med eksisterende kildekode anbefales det å initialisere kunnskapsbasen først, slik at agenter forstår din kodebase:
+## 3. Null Steg: Kunnskapsbase-initialisering
 
+Før du starter den formelle ingeniørprosessen, må du initialisere prosjektets kunnskapsbase.
+
+### 3.1 Initialiser Teknisk Kunnskapsbase
+
+**Eksempel på Dialog**:
 ```
 @speccrew-team-leader initialiser teknisk kunnskapsbase
 ```
 
-Deretter:
+**Tre-fase Prosess**:
+1. Plattformoppdagelse — Identifiser teknologiplattformer i prosjektet
+2. Teknisk Dokumentasjonsgenerering — Generer tekniske spesifikasjonsdokumenter for hver plattform
+3. Indeksgenerering — Etabler kunnskapsbase-indeks
+
+**Leveranse**:
+```
+speccrew-workspace/knowledges/techs/{platform-id}/
+├── tech-stack.md          # Teknologistabeldefinisjon
+├── architecture.md        # Arkitekturkonvensjoner
+├── dev-spec.md            # Utviklingsspesifikasjoner
+├── test-spec.md           # Testspesifikasjoner
+└── INDEX.md               # Indeksfil
+```
+
+### 3.2 Initialiser Forretningskunnskapsbase
 
+**Eksempel på Dialog**:
 ```
 @speccrew-team-leader initialiser forretningskunnskapsbase
 ```
 
-### Trinn 3: Start Din Første Oppgave
+**Fire-fase Prosess**:
+1. Funksjonsinventar — Skann kode for å identifisere alle funksjoner
+2. Funksjonsanalyse — Analyser forretningslogikk for hver funksjon
+3. Modulsammendrag — Oppsummer funksjoner etter modul
+4. Systemsammendrag — Generer forretningsoversikt på systemnivå
 
+**Leveranse**:
 ```
-@speccrew-product-manager Jeg har et nytt krav: [beskriv ditt funksjonskrav]
+speccrew-workspace/knowledges/bizs/
+├── {platform-type}/
+│   └── {module-name}/
+│       └── feature-spec.md
+└── system-overview.md
 ```
 
-> **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.
+---
+
+## 4. Fase-for-Fase Dialogguide
+
+### 4.1 Fase 1: Kravanalyse (Product Manager)
+
+**Hvordan Starte**:
+```
+@speccrew-product-manager jeg har et nytt krav: [beskriv kravet ditt]
+```
+
+**Agent Arbeidsflyt**:
+1. Les systemoversikt for å forstå eksisterende moduler
+2. Analyser brukerkrav
+3. Generer strukturert PRD-dokument
+
+**Leveranse**:
+```
+iterations/{nummer}-{type}-{navn}/01.product-requirement/
+├── [feature-name]-prd.md           # Produktkravdokument
+└── [feature-name]-bizs-modeling.md # Forretningsmodellering (for komplekse krav)
+```
+
+**Bekreftelseskontrollliste**:
+- [ ] Reflekterer kravbeskrivelsen brukerens intensjon nøyaktig?
+- [ ] Er forretningsregler komplette?
+- [ ] Er integrasjonspunkter med eksisterende systemer klare?
+- [ ] Er akseptkriterier målbare?
 
 ---
 
-## 3. Raskt Beslutningstre
+### 4.2 Fase 2: Funksjonsdesign (Feature Designer)
+
+**Hvordan Starte**:
+```
+@speccrew-feature-designer start funksjonsdesign
+```
+
+**Agent Arbeidsflyt**:
+1. Finn automatisk bekreftet PRD-dokument
+2. Last inn forretningskunnskapsbase
+3. Generer funksjonsdesign (inkludert UI-wireframes, interaksjonsflyter, datadefinisjoner, API-kontrakter)
+4. For flere PRD-er, bruk Task Worker for parallell design
 
-Usikker på hva du skal gjøre? Finn scenarioet ditt nedenfor:
+**Leveranse**:
+```
+iterations/{iter}/02.feature-design/
+└── [feature-name]-feature-spec.md  # Funksjonsdesigndokument
+```
 
-- **Jeg har et nytt funksjonskrav**
-  → `@speccrew-product-manager Jeg har et nytt krav: [beskriv ditt funksjonskrav]`
+**Bekreftelseskontrollliste**:
+- [ ] Er alle brukerscenarier dekket?
+- [ ] Er interaksjonsflyter klare?
+- [ ] Er datafeltdefinisjoner komplette?
+- [ ] Er unntakshåndtering omfattende?
 
-- **Jeg vil skanne eksisterende prosjektviten**
-  → `@speccrew-team-leader initialiser teknisk kunnskapsbase`
-  → Deretter: `@speccrew-team-leader initialiser forretningskunnskapsbase`
+---
 
-- **Jeg vil fortsette tidligere arbeid**
-  → `@speccrew-team-leader hva er den nåværende fremgangen?`
+### 4.3 Fase 3: Systemdesign (System Designer)
 
-- **Jeg vil sjekke systemets helsetilstand**
-  → Kjør i terminal: `speccrew doctor`
+**Hvordan Starte**:
+```
+@speccrew-system-designer start systemdesign
+```
 
-- **Jeg er usikker på hva jeg skal gjøre**
-  → `@speccrew-team-leader hjelp meg med å komme i gang`
-  → Team Leader vil automatisk oppdage prosjektstatusen din og veilede deg
+**Agent Arbeidsflyt**:
+1. Finn Feature Spec og API Contract
+2. Last inn teknisk kunnskapsbase (teknologistabel, arkitektur, spesifikasjoner for hver plattform)
+3. **Kontrollpunkt A**: Rammeverkvurdering — Analyser tekniske gap, anbefal nye rammeverk (om nødvendig), vent på brukerbekreftelse
+4. Generer DESIGN-OVERVIEW.md
+5. Bruk Task Worker for parallell designdistribusjon for hver plattform (frontend/backend/mobil/skrivebord)
+6. **Kontrollpunkt B**: Felles Bekreftelse — Vis oppsummering av alle plattformdesign, vent på brukerbekreftelse
+
+**Leveranse**:
+```
+iterations/{iter}/03.system-design/
+├── DESIGN-OVERVIEW.md              # Designoversikt
+├── {platform-id}/
+│   ├── INDEX.md                    # Plattformdesign-indeks
+│   └── {module}-design.md          # Moduldesign på pseudokodenivå
+```
+
+**Bekreftelseskontrollliste**:
+- [ ] Bruker pseudokoden faktisk rammeverksyntaks?
+- [ ] Er cross-plattform API-kontrakter konsistente?
+- [ ] Er feilhåndteringsstrategi unified?
 
 ---
 
-## 4. Agent Rask Referanse
+### 4.4 Fase 4: Utviklingsimplementering (System Developer)
+
+**Hvordan Starte**:
+```
+@speccrew-system-developer start utvikling
+```
+
+**Agent Arbeidsflyt**:
+1. Les systemdesigndokumenter
+2. Last inn teknisk kunnskap for hver plattform
+3. **Kontrollpunkt A**: Miljø-forhåndsverifisering — Verifiser runtime-versjoner, avhengigheter, tjenestetilgjengelighet; hvis mislykkes, vent på brukerløsning
+4. Bruk Task Worker for parallell utviklingsdistribusjon for hver plattform
+5. Integrasjonsverifisering: API-kontraktsjustering, datakonsistens
+6. Output leveranserapport
 
-| Rolle | Agent | Ansvarsområder | Kommandoeksempel |
-|------|-------|-----------------|-----------------|
-| Teamleder | `@speccrew-team-leader` | Prosjektnavigasjon, kunnskapsbaseinitialisering, statuskontroll | "Hjelp meg med å komme i gang" |
-| Produktleder | `@speccrew-product-manager` | Kravanalyse, PRD-generering | "Jeg har et nytt krav: ..." |
-| Funksjonsdesigner | `@speccrew-feature-designer` | Funksjonsanalyse, spesifikasjonsdesign, API-kontrakter | "Start funksjonsdesign for iterasjon X" |
-| Systemdesigner | `@speccrew-system-designer` | Arkitekturdesign, plattformdetaljert design | "Start systemdesign for iterasjon X" |
-| Systemutvikler | `@speccrew-system-developer` | Utviklingskoordinering, kodegenerering | "Start utvikling for iterasjon X" |
-| Testleder | `@speccrew-test-manager` | Testplanlegging, casestudier, utførelse | "Start test for iterasjon X" |
+**Leveranse**:
+```
+# Kildekode skrives til prosjektets faktiske kildekodekatalog
+iterations/{iter}/04.development/
+├── {platform-id}/
+│   └── tasks/                      # Utviklingsopptegnelser
+└── delivery-report.md
+```
 
-> **Merk**: Du trenger ikke huske alle agenter. Bare snakk med `@speccrew-team-leader`, og den vil rute forespørselen din til riktig agent.
+**Bekreftelseskontrollliste**:
+- [ ] Er miljøet klart?
+- [ ] Er integrasjonsproblemer innen akseptabelt område?
+- [ ] Følger koden utviklingsspesifikasjoner?
 
 ---
 
-## 5. Arbeidsflyt Oversikt
+### 4.5 Fase 5: Utrulling (System Deployer)
 
-### Komplett Flytdiagram
+**Hvordan Starte**:
 
-```mermaid
-flowchart LR
-    PRD[Trinn 1<br/>Kravanalyse<br/>Product Manager] --> FD[Trinn 2<br/>Funksjonsdesign<br/>Feature Designer]
-    FD --> SD[Trinn 3<br/>Systemdesign<br/>System Designer]
-    SD --> DEV[Trinn 4<br/>Utvikling<br/>System Developer]
-    DEV --> TEST[Trinn 5<br/>Systemtest<br/>Test Manager]
-    TEST --> ARCHIVE[Trinn 6<br/>Arkivering]
-    
-    KB[(Kunnskapsbase<br/>Gjennom Hele Prosessen)] -.-> PRD
-    KB -.-> FD
-    KB -.-> SD
-    KB -.-> DEV
-    KB -.-> TEST
 ```
+@speccrew-system-deployer start utrulling
+```
+
+**Agent Arbeidsflyt**:
+1. Verifiser at utviklingsfasen er fullført (Stage Gate)
+2. Last inn teknisk kunnskapsbase (byggekonfigurasjon, databasemigreringskonfigurasjon, tjenestestart-kommandoer)
+3. **Kontrollpunkt**: Miljø-forhåndsverifisering — Verifiser byggeverktøy, runtime-versjoner, avhengighetstilgjengelighet
+4. Utfør utrullingsskills i rekkefølge: Bygging (Build) → Databasemigrering (Migrate) → Tjenestestart (Startup) → Røyktest (Smoke Test)
+5. Output utrullingsrapport
 
-### Kjerneprinsipper
+> 💡 **Tips**: For prosjekter uten database, blir migreringstrinnet automatisk hoppet over; for klientapplikasjoner (desktop/mobil), brukes prosessverifiseringsmodus i stedet for HTTP-helsesjekk.
 
-1. **Trinnavhengigheter**: Hvert trinns resultat er input til neste trinn
-2. **Checkpoint-bekreftelse**: Hvert trinn har et bekreftelsespunkt som krever brukergodkjenning før fortsettelse til neste trinn
-3. **Kunnskapsbase-drevet**: Kunnskapsbasen kjører gjennom hele prosessen og gir kontekst for alle trinn
+**Leveranse**:
+
+```
+iterations/{iter}/05.deployment/
+├── {platform-id}/
+│   ├── deployment-plan.md          # Utrullingsplan
+│   └── deployment-log.md           # Utrulling gjennomføringslogg
+└── deployment-report.md            # Utrulling fullført rapport
+```
+
+**Bekreftelseskontrollliste**:
+- [ ] Er byggingen fullført vellykket?
+- [ ] Er alle databasemigreringsskript utført vellykket (hvis aktuelt)?
+- [ ] Startet applikasjonen normalt og passerte helsesjekk?
+- [ ] Er alle røyktester bestått?
 
 ---
 
-## 6. Trinn Null: Kunnskapsbaseinitialisering
+### 4.6 Fase 6: Systemtesting (Test Manager)
+
+**Hvordan Starte**:
+```
+@speccrew-test-manager start testing
+```
 
-Før du starter den formelle engineering-prosessen, må du initialisere prosjektets kunnskapsbase.
+**Tre-fase Testprosess**:
 
-### 6.1 Teknisk Kunnskapsbaseinitialisering
+| Fase | Beskrivelse | Kontrollpunkt |
+|------|----------|-------------------|
+| Testtilfelldesign | Generer testtilfeller basert på PRD og Feature Spec | A: Vis testtilfelde-dekningsstatistikk og sporbarhetsmatrise, vent på brukerbekreftelse på tilstrekkelig dekning |
+| Testkodegenerering | Generer kjørbart testkode | B: Vis genererte testfiler og用例-mapping, vent på brukerbekreftelse |
+| Testutførelse og Feilrapport | Utfør tester automatisk og generer rapporter | Ingen (automatisk utførelse) |
 
-**Samtaleeksempel**:
+**Leveranse**:
 ```
-@speccrew-team-leader initialiser teknisk kunnskapsbase
+iterations/{iter}/06.system-test/
+├── cases/
+│   └── {platform-id}/              # Testtilfelldokumenter
+├── code/
+│   └── {platform-id}/              # Testkodeplan
+├── reports/
+│   └── test-report-{date}.md       # Testrapport
+└── bugs/
+    └── BUG-{id}-{title}.md         # Feilrapporter (én fil per feil)
 ```
 
-**Tre-fase prosess**:
-1. Plattformdeteksjon — Identifiser tekniske plattformer i prosjektet
-2. Teknisk dokumentgenerering — Generer tekniske spesifikasjonsdokumenter for hver plattform
-3. Indeksgenerering — Etabler kunnskapsbaseindeks
+**Bekreftelseskontrollliste**:
+- [ ] Er testtilfelledekning komplett?
+- [ ] Er testkoden kjørbar?
+- [ ] Er feilalvorlighetsvurdering nøyaktig?
+
+---
+
+### 4.7 Fase 7: Arkivering
+
+Iterasjoner arkiveres automatisk når de er fullført:
 
-**Resultat**:
 ```
-speccrew-workspace/knowledges/techs/{platform-id}/
-├── tech-stack.md          # Teknologi-stack-definisjon
-├── architecture.md        # Arkitekturkonvensjoner
-├── dev-spec.md            # Utviklingsspesifikasjoner
-├── test-spec.md           # Testspesifikasjoner
-└── INDEX.md               # Indeksf
+speccrew-workspace/iteration-archives/
+└── {nummer}-{type}-{navn}-{dato}/
+    ├── 01.product-requirement/
+    ├── 02.feature-design/
+    ├── 03.system-design/
+    ├── 04.development/
+    ├── 05.deployment/
+    └── 06.system-test/
+```
+
+---
+
+## 5. Kunnskapsbaseoversikt
+
+### 5.1 Forretningskunnskapsbase (bizs)
+
+**Formål**: Lagre prosjektets forretningsfunksjonsbeskrivelser, moduloppdelinger, API-kjennetegn
+
+**Katalogstruktur**:
+```
+knowledges/bizs/
+├── {platform-type}/
+│   └── {module-name}/
+│       └── feature-spec.md
+└── system-overview.md
+```
+
+**Bruksscenarier**: Product Manager, Feature Designer
+
+### 5.2 Teknisk Kunnskapsbase (techs)
+
+**Formål**: Lagre prosjektets teknologistabel, arkitekturkonvensjoner, utviklingsspesifikasjoner, testspesifikasjoner
+
+**Katalogstruktur**:
+```
+knowledges/techs/{platform-id}/
+├── tech-stack.md
+├── architecture.md
+├── dev-spec.md
+├── test-spec.md
+└── INDEX.md
+```
+
+**Bruksscenarier**: System Designer, System Developer, Test Manager
+
+---
+
+## 6. Arbeidsflytforløpsstyring
+
+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.
+
+### 6.1 Trelagsforløpsfiler
+
+Arbeidsflyten vedlikeholder automatisk tre typer JSON-forløpsfiler, plassert i iterasjonskatalogen:
+
+| Fil | Plassering | Formål |
+|------|----------|---------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Registrerer status for hver pipeline-fase |
+| `.checkpoints.json` | Under hver fasekatalog | Registrerer brukerens sjekkpunkt-bekreftelsesstatus |
+| `DISPATCH-PROGRESS.json` | Under hver fasekatalog | Registrerer punkt-for-punkt forløp for parallelle oppgaver (multi-plattform/multi-modul) |
+
+### 6.2 Fasestatusforløp
+
+Hver fase følger dette statusforløpet:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: Ikke startet ennå
+- **in_progress**: Utføres for øyeblikket
+- **completed**: Agent-utførelse fullført, venter på brukerbekreftelse
+- **confirmed**: Bruker bekreftet gjennom siste sjekkpunkt, neste fase kan starte
+
+### 6.3 Gjenopptakbar Utførelse
+
+Når en Agent startes på nytt for en fase:
+
+1. **Automatisk oppstrømskontroll**: Verifiserer om den forrige fasen er bekreftet, blokkerer og varsler hvis ikke
+2. **Sjekkpunkt-gjenoppretting**: Leser `.checkpoints.json`, hopper over passerte sjekkpunkter, fortsetter fra det siste avbruddspunktet
+3. **Parallell oppgave-gjenoppretting**: Leser `DISPATCH-PROGRESS.json`, utfører kun oppgaver med `pending` eller `failed` status på nytt, hopper over `completed` oppgaver
+
+### 6.4 Vise Nåværende Forløp
+
+Vis pipeline-panorama-status gjennom Team Leader Agent:
+
+```
+@speccrew-team-leader vis nåværende iterasjonsforløp
+```
+
+Team Leader vil lese forløpsfilene og vise en statusoversikt som ligner på:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Bekreftet
+  02 Feature Design: 🔄 Pågår (Sjekkpunkt A passert)
+  03 System Design:  ⏳ Avventer
+  04 Development:    ⏳ Avventer
+  05 Deployment:     ⏳ Avventer
+  06 System Test:    ⏳ Avventer
+```
+
+### 6.5 Bakoverkompatibilitet
+
+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.
+
+---
+
+## 7. Ofte Stilte Spørsmål (FAQ)
+
+### S1: Hva gjør jeg hvis Agenten ikke fungerer som forventet?
+
+1. Kjør `speccrew doctor` for å sjekke installasjonsintegritet
+2. Bekreft at kunnskapsbasen er initialisert
+3. Bekreft at forrige fases leveranse finnes i gjeldende iterasjonskatalog
+
+### S2: Hvordan hoppe over en fase?
+
+**Anbefales ikke** — Hver fases output er input for neste fase.
+
+Hvis du må hoppe over, forbered manuelt input-dokumentet for den tilsvarende fasen og sørg for at det følger formatspesifikasjoner.
+
+### S3: Hvordan håndtere flere parallelle krav?
+
+Opprett uavhengige iterasjonskataloger for hvert krav:
+```
+iterations/
+├── 001-feature-xxx/
+├── 002-feature-yyy/
+└── 003-feature-zzz/
+```
+
+Hver iterasjon er fullstendig isolert og påvirker ikke hverandre.
+
+### S4: Hvordan oppdatere SpecCrew-versjonen?
+
+Oppdatering krever to trinn:
+
+```bash
+# Trinn 1: Oppdater globalt CLI-verktøy
+npm install -g speccrew@latest
+
+# Trinn 2: Synkroniser Agenter og Skills i prosjektkatalogen din
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: Oppdaterer selve CLI-verktøyet (nye versjoner kan inkludere nye Agent/Skill-definisjoner, feilrettelser osv.)
+- `speccrew update`: Synkroniserer Agent- og Skill-definisjonsfiler i prosjektet ditt til den nyeste versjonen
+- `speccrew update --ide cursor`: Oppdaterer konfigurasjon kun for en spesifikk IDE
+
+> **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.
+
+### S5: `speccrew update` viser at ny versjon er tilgjengelig, men `npm install -g speccrew@latest` installerer fortsatt den gamle versjonen?
+
+Årsak: npm cache-problem. Løsning:
+
+```bash
+npm cache clean --force
+npm install -g speccrew@latest
+npm list -g speccrew
+```
+
+Hvis det fortsatt ikke fungerer, spesifiser versjon:
+
+```bash
+npm install -g speccrew@0.5.6
+```
+
+### S6: Hvordan se historiske iterasjoner?
+
+Etter arkivering, se i `speccrew-workspace/iteration-archives/`, organisert i formatet `{nummer}-{type}-{navn}-{dato}/`.
+
+### S6: Trenger kunnskapsbasen regelmessig oppdatering?
+
+Re-initialisering kreves i følgende situasjoner:
+- Betydelige endringer i prosjektstruktur
+- Oppdatering eller erstatning av teknologistabel
+- Legge til/fjerne forretningsmoduler
+
+---
+
+## 8. Hurtigreferanse
+
+### Agent-start Hurtigreferanse
+
+| Fase | Agent | Startdialog |
+|------|-------|-------------------|
+| Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk kunnskapsbase` |
+| Kravanalyse | Product Manager | `@speccrew-product-manager jeg har et nytt krav: [beskrivelse]` |
+| Funksjonsdesign | Feature Designer | `@speccrew-feature-designer start funksjonsdesign` |
+| Systemdesign | System Designer | `@speccrew-system-designer start systemdesign` |
+| Utvikling | System Developer | `@speccrew-system-developer start utvikling` |
+| Utrulling | System Deployer | `@speccrew-system-deployer start utrulling` |
+| Systemtesting | Test Manager | `@speccrew-test-manager start testing` |
+
+### Kontrollpunkter Kontrollliste
+
+| Fase | Antall Kontrollpunkter | Nøkkelelementer for Verifisering |
+|------|------------------------|--------------------------------|
+| Kravanalyse | 1 | Kravnøyaktighet, forretningsregler kompletthet, akseptkriterier målbarhet |
+| Funksjonsdesign | 1 | Szenariedekning, interaksjonsklarhet, datakompletthet, unntakshåndtering |
+| Systemdesign | 2 | A: Rammeverkvurdering; B: Pseudokodesyntaks, cross-plattform konsistens, feilhåndtering |
+| Utvikling | 1 | A: Miljøklarhet, integrasjonsproblemer, kodespesifikasjoner |
+| Utrulling | 1 | Bygging vellykket, migrering fullført, tjenestestart, røyktest bestått |
+| Systemtesting | 2 | A: Tilfelledekning; B: Testkodekjørbarhet |
+
+### Leveransesti Hurtigreferanse
+
+| Fase | Output-katalog | Filformat |
+|------|------------------|-------------|
+| Kravanalyse | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
+| Funksjonsdesign | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
+| Systemdesign | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
+| Utvikling | `iterations/{iter}/04.development/` | Kildekode + `delivery-report.md` |
+| Utrulling | `iterations/{iter}/05.deployment/` | `deployment-plan.md`, `deployment-log.md`, `deployment-report.md` |
+| Systemtesting | `iterations/{iter}/06.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
+| Arkivering | `iteration-archives/{iter}-{dato}/` | Fullstendig kopi av iterasjonen |
+
+---
+
+## Neste Steg
+
+1. Kjør `speccrew init --ide qoder` for å initialisere prosjektet ditt
+2. Utfør Null Steg: Kunnskapsbase-initialisering
+3. Beveg deg gjennom hver fase etter arbeidsflyten, nyt spesifikasjonsdrevet utviklingserfaring!

package/docs/GETTING-STARTED.th.md

@@ -146,13 +146,15 @@ flowchart LR
     PRD[ระยะที่ 1<br/>การวิเคราะห์ความต้องการ<br/>Product Manager] --> FD[ระยะที่ 2<br/>Feature Design<br/>Feature Designer]
     FD --> SD[ระยะที่ 3<br/>System Design<br/>System Designer]
     SD --> DEV[ระยะที่ 4<br/>การพัฒนา<br/>System Developer]
-    DEV --> TEST[ระยะที่ 5<br/>การทดสอบระบบ<br/>Test Manager]
-    TEST --> ARCHIVE[ระยะที่ 6<br/>การเก็บถาวร]
+    DEV --> DEPLOY[ระยะที่ 5<br/>การปรับใช้<br/>System Deployer]
+    DEPLOY --> TEST[ระยะที่ 6<br/>การทดสอบระบบ<br/>Test Manager]
+    TEST --> ARCHIVE[ระยะที่ 7<br/>การเก็บถาวร]
     
     KB[(ฐานความรู้<br/>ตลอดกระบวนการ)] -.-> PRD
     KB -.-> FD
     KB -.-> SD
     KB -.-> DEV
+    KB -.-> DEPLOY
     KB -.-> TEST
 ```