speccrew 0.1.0 → 0.1.2

package/README.md

@@ -1,10 +1,34 @@
 # SpecCrew - AI 驱动的软件工程化框架
 
 <p align="center">
-  <a href="./README.md">中文</a> |
+  <a href="./README.md">简体中文</a> |
+  <a href="./README.zh-TW.md">繁體中文</a> |
   <a href="./README.en.md">English</a> |
+  <a href="./README.ko.md">한국어</a> |
+  <a href="./README.de.md">Deutsch</a> |
+  <a href="./README.es.md">Español</a> |
+  <a href="./README.fr.md">Français</a> |
+  <a href="./README.it.md">Italiano</a> |
+  <a href="./README.da.md">Dansk</a> |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.pl.md">Polski</a> |
+  <a href="./README.ru.md">Русский</a> |
+  <a href="./README.bs.md">Bosanski</a> |
   <a href="./README.ar.md">العربية</a> |
-  <a href="./README.es.md">Español</a>
+  <a href="./README.no.md">Norsk</a> |
+  <a href="./README.pt-BR.md">Português (Brasil)</a> |
+  <a href="./README.th.md">ไทย</a> |
+  <a href="./README.tr.md">Türkçe</a> |
+  <a href="./README.uk.md">Українська</a> |
+  <a href="./README.bn.md">বাংলা</a> |
+  <a href="./README.el.md">Ελληνικά</a> |
+  <a href="./README.vi.md">Tiếng Việt</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
+  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
 </p>
 
 > 让任何软件项目快速实现工程化落地的虚拟 AI 开发团队
@@ -93,7 +117,7 @@ graph LR
     B --> C[API Contract<br/>接口契约]
     C --> D[System Design<br/>系统设计]
     D --> E[Dev<br/>开发实现]
-    E --> F[Test<br/>测试验证]
+    E --> F[System Test<br/>系统测试]
     F --> G[Archive<br/>归档]
     
     H[Knowledge<br/>知识库] -.-> A
@@ -113,7 +137,7 @@ graph LR
 | Feature Design | Feature Designer | PRD | 功能设计文档 + 接口契约 | ✅ 必需 |
 | System Design | System Designer | Feature Spec | 前端/后端设计文档 | ✅ 必需 |
 | Dev | Dev | Design | 代码 + 任务记录 | ✅ 必需 |
-| Test | Test | Dev 产出 + PRD 验收标准 | 测试报告 | ✅ 必需 |
+| System Test | Test Manager | Dev 产出 + Feature Spec | 测试用例 + 测试代码 + 测试报告 + Bug 报告 | ✅ 必需 |
 
 ---
 
@@ -134,100 +158,71 @@ graph LR
 
 ## 快速开始
 
-### 1. 安装 SpecCrew
-
-**方式一：一键安装脚本（推荐，仅适用于 Qoder IDE）**
-
-```bash
-# macOS / Linux / WSL - 从 GitHub 安装
-curl -fsSL https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/install-qoder.sh | bash
-
-# macOS / Linux / WSL - 从 Gitee 安装（中国镜像）
-curl -fsSL https://gitee.com/amutek/speccrew/raw/main/scripts/install-qoder.sh | bash
-```
+### 前置条件
 
-```powershell
-# Windows - 从 GitHub 安装
-Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/install-qoder.ps1").Content
+- Node.js >= 16.0.0
+- 支持的 IDE：Qoder（默认）、Cursor、Claude Code
 
-# Windows - 从 Gitee 安装（中国镜像）
-Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/speccrew/raw/main/scripts/install-qoder.ps1").Content
-```
-
-> **注意**：一键安装脚本目前仅支持 Qoder IDE。对于其他 IDE（如 VS Code、Cursor 等），请使用下方手动复制方式。
+> **注意**：Cursor 和 Claude Code 的适配尚未在实际 IDE 环境中测试（代码层面已实现并通过 E2E 验证，但未在真实 Cursor/Claude Code 中实测）。
 
-**方式二：手动复制（适用于所有 IDE）**
+### 1. 安装 SpecCrew
 
 ```bash
-# 克隆仓库后复制到现有项目
-git clone https://github.com/charlesmu99/SpecCrew.git
-# 或：git clone https://gitee.com/amutek/SpecCrew.git
-
-# 复制到目标项目（根据你的 IDE 配置目录调整）
-cp -r SpecCrew/.speccrew /path/to/your-project/
-cp -r SpecCrew/SpecCrew-workspace /path/to/your-project/
-
-# 对于 Qoder IDE，还需复制到 .qoder/ 目录
-cp -r SpecCrew/.speccrew/agents/* /path/to/your-project/.qoder/agents/
-cp -r SpecCrew/.speccrew/skills/* /path/to/your-project/.qoder/skills/
+npm install -g speccrew
 ```
 
 ### 2. 初始化项目
 
+进入你的项目根目录，运行初始化命令：
+
 ```bash
-# 运行初始化 Skill，自动生成知识库和项目结构
-# 由 speccrew-project-init Skill 自动执行
-```
+cd /path/to/your-project
 
-### 3. 开始开发流程
+# 默认使用 Qoder
+speccrew init
 
-```bash
-# 1. 创建 PRD
-# 2. 生成 Solution
-# 3. 确认 API Contract
-# 4. 详细设计
-# 5. 开发实现
-# 6. 测试验证
+# 或指定 IDE
+speccrew init --ide qoder
+speccrew init --ide cursor
+speccrew init --ide claude
 ```
 
-### 4. 卸载 SpecCrew
+初始化完成后，项目中会生成：
+- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 个 Agent 角色定义
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 个 Skill 工作流
+- `speccrew-workspace/` — 工作区（迭代目录、知识库、文档模板）
+- `.speccrewrc` — SpecCrew 配置文件
 
-**方式一：一键卸载脚本（推荐，仅适用于 Qoder IDE）**
+后续如需更新指定 IDE 的 Agents 和 Skills：
 
 ```bash
-# macOS / Linux / WSL - 从 GitHub 卸载
-curl -fsSL https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/uninstall-qoder.sh | bash
-
-# macOS / Linux / WSL - 从 Gitee 卸载（中国镜像）
-curl -fsSL https://gitee.com/amutek/speccrew/raw/main/scripts/uninstall-qoder.sh | bash
+speccrew update --ide cursor
+speccrew update --ide claude
 ```
 
-```powershell
-# Windows - 从 GitHub 卸载
-Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/uninstall-qoder.ps1").Content
-
-# Windows - 从 Gitee 卸载（中国镜像）
-Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/speccrew/raw/main/scripts/uninstall-qoder.ps1").Content
-```
+### 3. 开始开发流程
 
-> **注意**：一键卸载脚本目前仅支持 Qoder IDE。
+按照标准工程流程逐步推进：
 
-**方式二：手动卸载（适用于所有 IDE）**
+1. **PRD**：由产品经理 Agent 分析需求，生成产品需求文档
+2. **Feature Design**：由功能设计师 Agent 生成功能设计文档 + API 契约
+3. **System Design**：由系统设计师 Agent 按端（前端/后端/移动端/桌面端）生成系统设计文档
+4. **Dev**：由系统开发者 Agent 按端并行实现开发
+5. **System Test**：由测试管理员 Agent 协调三阶段测试（用例设计 → 代码生成 → 执行报告）
+6. **Archive**：归档迭代
 
-```bash
-# 删除 speccrew-workspace 目录
-rm -rf speccrew-workspace/
+> 每个阶段产出物需人工确认后方可进入下一阶段。
 
-# 删除 .speccrew/ 中的 SpecCrew 前缀文件（保留自定义内容）
-rm -rf .speccrew/agents/SpecCrew-*.md
-rm -rf .speccrew/skills/SpecCrew-*/
+### 4. 其他 CLI 命令
 
-# 对于 Qoder IDE，还需清理 .qoder/ 目录
-rm -rf .qoder/agents/SpecCrew-*.md
-rm -rf .qoder/skills/SpecCrew-*/
+```bash
+speccrew list       # 列出已安装的 agents 和 skills
+speccrew doctor     # 诊断环境和安装状态
+speccrew update     # 更新 agents 和 skills 到最新版本
+speccrew uninstall  # 卸载 SpecCrew（--all 同时删除工作区）
 ```
 
-> **注意**：卸载会保留你在 `.speccrew/` 目录中的源文件和自定义内容。如需完全删除 IDE 配置，请手动删除对应的 IDE 配置目录（如 `.qoder/`）。
+📖 **详细使用指南**：安装完成后，查看 [快速开始文档](docs/GETTING-STARTED.md) 了解完整的工作流程和各 Agent 对话指南。
 
 ---
 
@@ -235,64 +230,51 @@ rm -rf .qoder/skills/SpecCrew-*/
 
 ```
 your-project/
-├── .speccrew/                       # SpecCrew 源文件（可版本控制）
-├── .qoder/                          # Qoder IDE 配置（运行时）
-│   ├── agents/                      # 6 个角色 Agent
-│   │   ├── speccrew-pm.md
-│   │   ├── speccrew-planner.md
-│   │   ├── speccrew-system-designer.md
-│   │   ├── speccrew-dev-[framework].md
-│   │   └── speccrew-test-[framework].md
-│   └── skills/                      # 16 个 Skill
-│       ├── speccrew-pm-requirement-analysis/
-│       ├── speccrew-fd-feature-design/
-│       ├── speccrew-fd-api-contract/
-│       ├── speccrew-sd-frontend/
-│       ├── speccrew-sd-backend/
-│       ├── speccrew-sd-mobile/
-│       ├── speccrew-sd-desktop/
-│       ├── speccrew-dev-frontend/             # System Developer: frontend dev
-│       ├── speccrew-dev-backend/              # System Developer: backend dev
-│       ├── speccrew-dev-mobile/               # System Developer: mobile dev
-│       ├── speccrew-dev-desktop/              # System Developer: desktop dev
-│       ├── speccrew-test-report/
-│       ├── speccrew-knowledge-dispatch/
-│       ├── speccrew-knowledge-bizs-init/
-│       ├── speccrew-knowledge-bizs-sync/
-│       ├── speccrew-workflow-diagnose/
-│       ├── speccrew-create-se-infrastructure/
-│       ├── speccrew-skill-develop/
-│       └── speccrew-agent-optimize/
+├── .qoder/                          # IDE 配置目录（Qoder 示例）
+│   ├── agents/                      # 7 个角色 Agent
+│   │   ├── speccrew-team-leader.md       # 团队领导：全局调度与迭代管理
+│   │   ├── speccrew-product-manager.md   # 产品经理：需求分析与 PRD
+│   │   ├── speccrew-feature-designer.md  # 功能设计师：Feature Design + API 契约
+│   │   ├── speccrew-system-designer.md   # 系统设计师：按端生成系统设计
+│   │   ├── speccrew-system-developer.md  # 系统开发者：按端并行开发
+│   │   ├── speccrew-test-manager.md      # 测试管理员：三阶段测试协调
+│   │   └── speccrew-task-worker.md       # 任务工人：并行子任务执行
+│   └── skills/                      # 38 个 Skill（按职能分组）
+│       ├── speccrew-pm-*/                # 产品管理（需求分析、需求评估）
+│       ├── speccrew-fd-*/                # 功能设计（Feature Design、API 契约）
+│       ├── speccrew-sd-*/                # 系统设计（前端/后端/移动端/桌面端）
+│       ├── speccrew-dev-*/               # 开发实现（前端/后端/移动端/桌面端）
+│       ├── speccrew-test-*/              # 测试（用例设计/代码生成/执行报告）
+│       ├── speccrew-knowledge-bizs-*/    # 业务知识库（API分析/UI分析/模块分类等）
+│       ├── speccrew-knowledge-techs-*/   # 技术知识库（技术栈生成/规约/索引等）
+│       ├── speccrew-knowledge-graph-*/   # 知识图谱（读写查询）
+│       └── speccrew-*/                   # 工具类（诊断/时间戳/工作流等）
 │
 └── speccrew-workspace/              # 工作区（初始化时生成）
     ├── docs/                        # 管理性文档
+    │   ├── configs/                 # 配置文件（平台映射、技术栈映射等）
     │   ├── rules/                   # 规则配置
     │   └── solutions/               # 解决方案文档
-    │       └── agent-knowledge-map.md
     │
     ├── iterations/                  # 迭代项目（动态生成）
-    │   └── {序号}-{类型}-{名称}/     # 如 001-feature-order
+    │   └── {序号}-{类型}-{名称}/
     │       ├── 00.docs/             # 原始需求文档
     │       ├── 01.product-requirement/ # 产品需求文档
-    │       ├── 02.feature-design/   # 特性设计
+    │       ├── 02.feature-design/   # 功能设计
     │       ├── 03.system-design/    # 系统设计
     │       ├── 04.development/      # 开发阶段
-    │       ├── 05.test/             # 测试阶段
+    │       ├── 05.system-test/      # 系统测试
     │       └── 06.delivery/         # 交付阶段
     │
     ├── iteration-archives/          # 迭代归档
-    │   └── {序号}-{类型}-{名称}-{日期}/
     │
     └── knowledges/                  # 知识库
         ├── base/                    # 基础/元数据
         │   ├── diagnosis-reports/   # 诊断报告
         │   ├── sync-state/          # 同步状态
         │   └── tech-debts/          # 技术债
-        │
         ├── bizs/                    # 业务知识
-        │   └── {platform-type}/
-        │       └── {module-name}/
-        │
+        │   └── {platform-type}/{module-name}/
         └── techs/                   # 技术知识
             └── {platform-id}/
 ```
@@ -331,6 +313,7 @@ your-project/
 ## 更多信息
 
 - **Agent 知识地图**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
+- **npm**: https://www.npmjs.com/package/speccrew
 - **GitHub**: https://github.com/charlesmu99/speccrew
 - **Gitee**: https://gitee.com/amutek/speccrew
 - **Qoder IDE**: https://qoder.com/

package/README.no.md

@@ -0,0 +1,321 @@
+# SpecCrew - AI-drevet programvareingeniør-rammeverk
+
+<p align="center">
+  <a href="./README.md">简体中文</a> |
+  <a href="./README.zh-TW.md">繁體中文</a> |
+  <a href="./README.en.md">English</a> |
+  <a href="./README.ko.md">한국어</a> |
+  <a href="./README.de.md">Deutsch</a> |
+  <a href="./README.es.md">Español</a> |
+  <a href="./README.fr.md">Français</a> |
+  <a href="./README.it.md">Italiano</a> |
+  <a href="./README.da.md">Dansk</a> |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.pl.md">Polski</a> |
+  <a href="./README.ru.md">Русский</a> |
+  <a href="./README.bs.md">Bosanski</a> |
+  <a href="./README.ar.md">العربية</a> |
+  <a href="./README.no.md">Norsk</a> |
+  <a href="./README.pt-BR.md">Português (Brasil)</a> |
+  <a href="./README.th.md">ไทย</a> |
+  <a href="./README.tr.md">Türkçe</a> |
+  <a href="./README.uk.md">Українська</a> |
+  <a href="./README.bn.md">বাংলা</a> |
+  <a href="./README.el.md">Ελληνικά</a> |
+  <a href="./README.vi.md">Tiếng Việt</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
+  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
+</p>
+
+> Et virtuelt AI-utviklingsteam som muliggjør rask ingeniørimplementering for ethvert programvareprosjekt
+
+## Hva er SpecCrew?
+
+SpecCrew er et innebygd virtuelt AI-utviklingsteam-rammeverk. Det transformerer profesjonelle programvareingeniør-arbeidsflyter (PRD → Feature Design → System Design → Dev → Test) til gjenbrukbare Agent-arbeidsflyter, og hjelper utviklingsteam å oppnå Specification-Driven Development (SDD), spesielt egnet for eksisterende prosjekter.
+
+Ved å integrere Agenter og Skills i eksisterende prosjekter, kan team raskt initialisere prosjektdokumentasjonssystemer og virtuelle programvareteam, og implementere nye funksjoner og modifikasjoner i henhold til standard ingeniørarbeidsflyter.
+
+---
+
+## 8 Kjerne-problemer Løst
+
+### 1. AI Ignorerer Eksisterende Prosjektdokumentasjon (Kunnskapshull)
+**Problem**: Eksisterende SDD- eller Vibe Coding-metoder er avhengige av at AI oppsummerer prosjekter i sanntid, noe som lett går glipp av kritisk kontekst og forårsaker utviklingsresultater som avviker fra forventninger.
+
+**Løsning**: `knowledge/`-depotet fungerer som prosjektets "eneste kilde til sannhet", og akkumulerer arkitekturdesign, funksjonelle moduler og forretningsprosesser for å sikre at kravene holder seg på sporet fra kilden.
+
+### 2. Direkte PRD-til-Teknisk Dokumentasjon (Innholdsutelatelse)
+**Problem**: Å hoppe direkte fra PRD til detaljert design går lett glipp av kravdetaljer, noe som får implementerte funksjoner til å avvike fra kravene.
+
+**Løsning**: Introduser **Feature Design-dokument**-fasen, som kun fokuserer på kravskjelettet uten tekniske detaljer:
+- Hvilke sider og komponenter er inkludert?
+- Sideoperasjonsflyter
+- Backend-behandlingslogikk
+- Datalagringsstruktur
+
+Utvikling trenger kun å "fylle kjøttet" basert på den spesifikke tech-stacken, og sikrer at funksjoner vokser "tett på beinet (kravene)".
+
+### 3. Usikker Agent-søkeomfang (Usikkerhet)
+**Problem**: I komplekse prosjekter gir AI's brede søk etter kode og dokumenter usikre resultater, noe som gjør konsistens vanskelig å garantere.
+
+**Løsning**: Klare dokumentkatalogstrukturer og maler, designet basert på hver Agents behov, implementerer **progressiv offentliggjøring og behovslastering** for å sikre determinisme.
+
+### 4. Manglende Trinn og Oppgaver (Prosess-nedbryting)
+**Problem**: Manglende fullstendig dekning av ingeniørprosessen går lett glipp av kritiske trinn, noe som gjør kvalitet vanskelig å garantere.
+
+**Løsning**: Dekker hele programvareingeniør-livssyklusen:
+```
+PRD (Krav) → Feature Design (Funksjonsdesign) → API Contract (Kontrakt)
+    → System Design (Systemdesign) → Dev (Utvikling) → Test (Testing)
+```
+- Hver fases utdata er neste fases inndata
+- Hvert trinn krever menneskelig bekreftelse før fortsettelse
+- Alle Agent-eksekveringer har todo-lister med selvkontroll etter fullføring
+
+### 5. Lav Team-samarbeidseffektivitet (Kunnskap-siloer)
+**Problem**: AI-programmeringserfaring er vanskelig å dele på tvers av team, noe som fører til gjentatte feil.
+
+**Løsning**: Alle Agenter, Skills og relaterte dokumenter er versjonskontrollert med kildekode:
+- Én persons optimalisering deles av teamet
+- Kunnskap akkumuleres i kodebasen
+- Forbedret team-samarbeidseffektivitet
+
+### 7. Enkelt Agent-kontekst for Lang (Ytelses-flaskehals)
+**Problem**: Store komplekse oppgaver overstiger enkelt Agent-kontekstvinduer, noe som forårsaker forståelsesavvik og redusert utdatakvalitet.
+
+**Løsning**: **Sub-Agent Auto-Dispatch-mekanisme**:
+- Komplekse oppgaver identifiseres automatisk og deles inn i underoppgaver
+- Hver underoppgave utføres av en uavhengig sub-Agent med isolert kontekst
+- Parent Agent koordinerer og aggregerer for å sikre generell konsistens
+- Unngår enkelt Agent-kontekstutvidelse og sikrer utdatakvalitet
+
+### 8. Krav-iterasjonskaos (Ledelsesvanskeligheter)
+**Problem**: Flere krav blandet i samme gren påvirker hverandre, noe som gjør sporing og tilbakeføring vanskelig.
+
+**Løsning**: **Hvert Krav som et Uavhengig Prosjekt**:
+- Hvert krav oppretter en uavhengig iterasjonskatalog `iterations/iXXX-[krav-navn]/`
+- Fullstendig isolasjon: dokumenter, design, kode og tester administreres uavhengig
+- Rask iterasjon: liten granularitetsleveranse, rask verifisering, rask utrulling
+- Fleksibel arkivering: etter fullføring, arkivering til `archive/` med klar historisk sporing
+
+### 6. Dokumentoppdateringsforsinkelse (Kunnskaps-forråtning)
+**Problem**: Dokumenter blir utdaterte etter hvert som prosjekter utvikler seg, noe som får AI til å arbeide med feil informasjon.
+
+**Løsning**: Agenter har automatiske dokumentoppdateringsmuligheter, og synkroniserer prosjektendringer i sanntid for å holde kunnskapsbasen nøyaktig.
+
+---
+
+## Kjerne-arbeidsflyt
+
+```mermaid
+graph LR
+    A[PRD<br/>Kravdokument] --> B[Feature Design<br/>Funksjonsdesign]
+    B --> C[API Contract<br/>Grensesnittkontrakt]
+    C --> D[System Design<br/>Systemdesign]
+    D --> E[Dev<br/>Implementering]
+    E --> F[System Test<br/>Testing]
+    F --> G[Archive<br/>Arkivering]
+    
+    H[Knowledge<br/>Depot] -.-> A
+    H -.-> B
+    H -.-> D
+    H -.-> E
+    
+    E -.-> H
+    F -.-> H
+```
+
+### Fasebeskrivelser
+
+| Fase | Agent | Inndata | Utdata | Menneskelig Bekreftelse |
+|------|-------|---------|--------|------------------------|
+| PRD | PM | Brukerkrav | Produktkravdokument | ✅ Påkrevd |
+| Feature Design | Feature Designer | PRD | Feature Design Dokument + API Kontrakt | ✅ Påkrevd |
+| System Design | System Designer | Feature Spec | Frontend/Backend Design-dokumenter | ✅ Påkrevd |
+| Dev | Dev | Design | Kode + Oppgaveregistreringer | ✅ Påkrevd |
+| System Test | Test Manager | Dev Utdata + Feature Spec | Testtilfeller + Testkode + Testrapport + Bug-rapport | ✅ Påkrevd |
+
+---
+
+## Sammenligning med Eksisterende Løsninger
+
+| Dimensjon | Vibe Coding | Ralph Loop | **SpecCrew** |
+|-----------|-------------|------------|-------------|
+| Dokumentavhengighet | Ignorerer eksisterende docs | Er avhengig av AGENTS.md | **Strukturert Kunnskapsbase** |
+| Kravoverføring | Direkte koding | PRD → Kode | **PRD → Feature Design → System Design → Kode** |
+| Menneskelig involvering | Minimal | Ved oppstart | **I hver fase** |
+| Prosessfullstendighet | Svak | Middels | **Fullstendig ingeniørarbeidsflyt** |
+| Team-samarbeid | Vanskelig å dele | Personlig effektivitet | **Team kunnskapsdeling** |
+| Kontekststyring | Enkelt instans | Enkelt instans-løkke | **Sub-Agent auto-dispatch** |
+| Iterasjonsstyring | Blandet | Oppgaveliste | **Krav som prosjekt, uavhengig iterasjon** |
+| Determinisme | Lav | Middels | **Høy (progressiv offentliggjøring)** |
+
+---
+
+## Rask Start
+
+### Forutsetninger
+
+- Node.js >= 16.0.0
+- Støttede IDE-er: Qoder (standard), Cursor, Claude Code
+
+> **Merk**: Adapterne for Cursor og Claude Code er ikke testet i faktiske IDE-miljøer (implementert på kodenivå og verifisert gjennom E2E-tester, men ennå ikke testet i faktisk Cursor/Claude Code).
+
+### 1. Installer SpecCrew
+
+```bash
+npm install -g speccrew
+```
+
+### 2. Initialiser Prosjekt
+
+Naviger til prosjektets rotkatalog og kjør initialiseringskommandoen:
+
+```bash
+cd /path/to/your-project
+
+# Bruker Qoder som standard
+speccrew init
+
+# Eller spesifiser IDE
+speccrew init --ide qoder
+speccrew init --ide cursor
+speccrew init --ide claude
+```
+
+Etter initialisering vil følgende bli generert i prosjektet ditt:
+- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 Agent-rolledefinisjoner
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 Skill-arbeidsflyter
+- `speccrew-workspace/` — Arbeidsområde (iterasjonskataloger, kunnskapsbase, dokumentmaler)
+- `.speccrewrc` — SpecCrew-konfigurasjonsfil
+
+For å oppdatere Agenter og Skills for en spesifikk IDE senere:
+
+```bash
+speccrew update --ide cursor
+speccrew update --ide claude
+```
+
+### 3. Start Utviklingsarbeidsflyt
+
+Følg standard ingeniørarbeidsflyt trinn for trinn:
+
+1. **PRD**: Produktleder Agent analyserer krav og genererer produktkravdokument
+2. **Feature Design**: Feature Designer Agent genererer feature design dokument + API kontrakt
+3. **System Design**: System Designer Agent genererer system design dokumenter per plattform (frontend/backend/mobil/desktop)
+4. **Dev**: System Utvikler Agent implementerer utvikling per plattform parallelt
+5. **System Test**: Testleder Agent koordinerer trefase-testing (tilfelledesign → kodegenerering → utførelsesrapport)
+6. **Archive**: Arkiver iterasjon
+
+> Hver fases leveranser krever menneskelig bekreftelse før fortsettelse til neste fase.
+
+### 4. Andre CLI-kommandoer
+
+```bash
+speccrew list       # List opp installerte agenter og skills
+speccrew doctor     # Diagnostiser miljø og installasjonsstatus
+speccrew update     # Oppdater agenter og skills til nyeste versjon
+speccrew uninstall  # Avinstaller SpecCrew (--all fjerner også arbeidsområde)
+```
+
+📖 **Detaljert Guide**: Etter installasjon, sjekk [Kom-i-gang-guiden](docs/GETTING-STARTED.no.md) for fullstendig arbeidsflyt og agent-samtaleguide.
+
+---
+
+## Katalogstruktur
+
+```
+your-project/
+├── .qoder/                          # IDE-konfigurasjonskatalog (Qoder-eksempel)
+│   ├── agents/                      # 7 rolle-Agenter
+│   │   ├── speccrew-team-leader.md       # Teamleder: Global planlegging og iterasjonsstyring
+│   │   ├── speccrew-product-manager.md   # Produktleder: Kravanalyse og PRD
+│   │   ├── speccrew-feature-designer.md  # Feature Designer: Feature Design + API Kontrakt
+│   │   ├── speccrew-system-designer.md   # System Designer: System design per plattform
+│   │   ├── speccrew-system-developer.md  # System Utvikler: Parallell utvikling per plattform
+│   │   ├── speccrew-test-manager.md      # Testleder: Trefase-testkoordinering
+│   │   └── speccrew-task-worker.md       # Oppgave-arbeider: Parallell underoppgave-utførelse
+│   └── skills/                      # 38 Skills (gruppert etter funksjon)
+│       ├── speccrew-pm-*/                # Produktstyring (kravanalyse, evaluering)
+│       ├── speccrew-fd-*/                # Feature Design (Feature Design, API Kontrakt)
+│       ├── speccrew-sd-*/                # System Design (frontend/backend/mobil/desktop)
+│       ├── speccrew-dev-*/               # Utvikling (frontend/backend/mobil/desktop)
+│       ├── speccrew-test-*/              # Testing (tilfelledesign/kodegenerering/utførelsesrapport)
+│       ├── speccrew-knowledge-bizs-*/    # Forretningskunnskap (API-analyse/UI-analyse/modulklassifisering osv.)
+│       ├── speccrew-knowledge-techs-*/   # Teknisk kunnskap (tech-stack-generering/konvensjoner/indeks osv.)
+│       ├── speccrew-knowledge-graph-*/   # Kunnskapsgraf (lese/skrive/spørring)
+│       └── speccrew-*/                   # Verktøy (diagnostikk/tidsstempler/arbeidsflyt osv.)
+│
+└── speccrew-workspace/              # Arbeidsområde (generert under initialisering)
+    ├── docs/                        # Styringsdokumenter
+    │   ├── configs/                 # Konfigurasjonsfiler (plattform-mapping, tech-stack-mapping osv.)
+    │   ├── rules/                   # Regelkonfigurasjoner
+    │   └── solutions/               # Løsningsdokumenter
+    │
+    ├── iterations/                  # Iterasjonsprosjekter (dynamisk generert)
+    │   └── {nummer}-{type}-{navn}/
+    │       ├── 00.docs/             # Originale krav
+    │       ├── 01.product-requirement/ # Produktkrav
+    │       ├── 02.feature-design/   # Feature design
+    │       ├── 03.system-design/    # System design
+    │       ├── 04.development/      # Utviklingsfase
+    │       ├── 05.system-test/      # Systemtesting
+    │       └── 06.delivery/         # Leveransefase
+    │
+    ├── iteration-archives/          # Iterasjonsarkiver
+    │
+    └── knowledges/                  # Kunnskapsbase
+        ├── base/                    # Base/metadata
+        │   ├── diagnosis-reports/   # Diagnoserapporter
+        │   ├── sync-state/          # Synkroniseringsstatus
+        │   └── tech-debts/          # Teknisk gjeld
+        ├── bizs/                    # Forretningskunnskap
+        │   └── {platform-type}/{module-name}/
+        └── techs/                   # Teknisk kunnskap
+            └── {platform-id}/
+```
+
+---
+
+## Kjerne Design-prinsipper
+
+1. **Specification-Driven**: Skriv spesifikasjoner først, og la koden "vokse" fra dem
+2. **Progressiv Offentliggjøring**: Agenter starter fra minimale inngangspunkter og laster informasjon på forespørsel
+3. **Menneskelig Bekreftelse**: Hver fases utdata krever menneskelig bekreftelse for å forhindre AI-avvik
+4. **Kontekst-isolasjon**: Store oppgaver deles inn i små, kontekst-isolerte underoppgaver
+5. **Sub-Agent-samarbeid**: Komplekse oppgaver sender automatisk Sub-Agenter for å unngå enkelt Agent-kontekstutvidelse
+6. **Rask Iterasjon**: Hvert krav som uavhengig prosjekt for rask leveranse og verifisering
+7. **Kunnskapsdeling**: Alle konfigurasjoner er versjonskontrollert med kildekode
+
+---
+
+## Brukstilfeller
+
+### ✅ Anbefalt For
+- Mellomstore til store prosjekter som krever standardiserte arbeidsflyter
+- Team-samarbeid programvareutvikling
+- Legacy-prosjekt ingeniør-transformasjon
+- Produkter som krever langsiktig vedlikehold
+
+### ❌ Ikke Egnet For
+- Personlig rask prototype-validering
+- Utforskende prosjekter med svært usikre krav
+- Engangsskripter eller verktøy
+
+---
+
+## Mer Informasjon
+
+- **Agent Kunnskapskart**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
+- **npm**: https://www.npmjs.com/package/speccrew
+- **GitHub**: https://github.com/charlesmu99/speccrew
+- **Gitee**: https://gitee.com/amutek/speccrew
+- **Qoder IDE**: https://qoder.com/
+
+---
+
+> **SpecCrew handler ikke om å erstatte utviklere, men om å automatisere de kjedelige delene slik at team kan fokusere på mer verdifullt arbeide.**