speccrew 0.1.12 → 0.2.1

package/README.fr.md

@@ -41,6 +41,58 @@ En intégrant des Agents et des Skills dans des projets existants, les équipes
 
 ---
 
+## ✨ Caractéristiques Principales
+
+### 🏭 Équipe Logicielle Virtuelle
+Génération en un clic de **7 rôles d'Agents professionnels** + **30+ flux de travail de Skills**, construisant une équipe logicielle virtuelle complète :
+- **Team Leader** - Planification globale et gestion des itérations
+- **Product Manager** - Analyse des exigences et génération de PRD
+- **Feature Designer** - Conception de fonctionnalités + contrats API
+- **System Designer** - Conception de systèmes Frontend/Backend/Mobile/Desktop
+- **System Developer** - Développement parallèle multi-plateforme
+- **Test Manager** - Coordination des tests en trois phases
+- **Task Worker** - Exécution parallèle de sous-tâches
+
+### 📐 Modélisation ISA-95 en Six Étapes
+Basé sur la méthodologie de modélisation **ISA-95** standard international, standardisant la transformation des exigences métier en systèmes logiciels :
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Chaque étape correspond à des diagrammes UML spécifiques (cas d'utilisation, séquence, classes)
+- Les exigences métier sont "affinées étape par étape", sans perte d'information
+- Les sorties sont directement utilisables pour le développement
+
+### 📚 Système de Base de Connaissances
+Architecture de base de connaissances à trois niveaux garantissant que l'IA travaille toujours basée sur la "source unique de vérité" :
+
+| Niveau | Répertoire | Contenu | Objectif |
+|--------|------------|---------|----------|
+| L1 Connaissance Système | `knowledge/techs/` | Stack technique, architecture, conventions | L'IA comprend les limites techniques du projet |
+| L2 Connaissance Métier | `knowledge/bizs/` | Fonctionnalités des modules, flux métier, entités | L'IA comprend la logique métier |
+| L3 Artefacts d'Itération | `iterations/iXXX/` | PRD, documents de conception, rapports de test | Chaîne complète de traçabilité pour les exigences actuelles |
+
+### 🔄 Pipeline de Connaissances en Quatre Étapes
+**Architecture de génération automatisée de connaissances**, générant automatiquement la documentation métier/technique à partir du code source :
+```
+Étape 1 : Analyser le code source → Générer la liste des modules
+Étape 2 : Analyse parallèle → Extraire les fonctionnalités (multi-Worker parallèle)
+Étape 3 : Résumé parallèle → Compléter les aperçus des modules (multi-Worker parallèle)
+Étape 4 : Agrégation système → Générer le panorama du système
+```
+- Supporte **synchronisation complète** et **synchronisation incrémentielle** (basé sur Git diff)
+- Une personne optimise, l'équipe partage
+
+### 🔧 Harness Cadre de Mise en Œuvre Pratique
+**Cadre d'exécution standardisé**, garantit que les documents de conception se transforment avec précision en instructions de développement exécutables :
+- **Principe du manuel d'opération** : Skill comme SOP, étapes claires, continues et autonomes
+- **Contrat d'entrée/sortie** : Définition claire des interfaces, exécution rigoureuse comme pseudocode
+- **Architecture de divulgation progressive** : Chargement des informations par couches, éviter la surcharge de contexte
+- **Délégation de Sous-Agent** : Division automatique des tâches complexes, exécution parallèle pour garantir la qualité
+
+---
+
 ## 8 Problèmes Principaux Résolus
 
 ### 1. L'IA Ignore la Documentation de Projet Existante (Lacune de Connaissances)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Après l'initialisation, les éléments suivants seront générés dans votre projet :
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 définitions de rôles Agent
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 flux de travail Skill
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ flux de travail Skill
 - `speccrew-workspace/` — Espace de travail (répertoires d'itération, base de connaissances, modèles de documents)
 - `.speccrewrc` — Fichier de configuration SpecCrew
 
@@ -213,7 +265,22 @@ Suivez le flux de travail d'ingénierie standard étape par étape :
 
 > Les livrables de chaque phase nécessitent une confirmation humaine avant de passer à la phase suivante.
 
-### 4. Autres Commandes CLI
+### 4. Mettre à Jour SpecCrew
+
+Lorsque SpecCrew publie une nouvelle version, deux étapes sont nécessaires pour terminer la mise à jour :
+
+```bash
+# Step 1: 更新全局 CLI 工具到最新版本
+npm install -g speccrew@latest
+
+# Step 2: 同步项目中的 Agents 和 Skills 到最新版本
+cd /path/to/your-project
+speccrew update
+```
+
+> **Note** : `npm install -g speccrew@latest` met à jour l'outil CLI lui-même, tandis que `speccrew update` met à jour les fichiers de définition des Agents et Skills dans le projet. Les deux étapes doivent être exécutées pour terminer la mise à jour complète.
+
+### 5. Autres Commandes CLI
 
 ```bash
 speccrew list       # Lister les agents et skills installés
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer : Développement parallèle par plateforme
 │   │   ├── speccrew-test-manager.md      # Test Manager : Coordination de test en trois phases
 │   │   └── speccrew-task-worker.md       # Task Worker : Exécution parallèle de sous-tâches
-│   └── skills/                      # 38 Skills (groupés par fonction)
+│   └── skills/                      # 30+ Skills (groupés par fonction)
 │       ├── speccrew-pm-*/                # Gestion Produit (analyse d'exigences, évaluation)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, Contrat API)
 │       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)

package/README.it.md

@@ -41,6 +41,58 @@ Integrando Agent e Skill nei progetti esistenti, i team possono rapidamente iniz
 
 ---
 
+## ✨ Caratteristiche Principali
+
+### 🏭 Team Software Virtuale
+Generazione con un clic di **7 ruoli di Agent professionali** + **30+ workflow di Skill**, costruendo un team software virtuale completo:
+- **Team Leader** - Pianificazione globale e gestione iterazioni
+- **Product Manager** - Analisi requisiti e generazione PRD
+- **Feature Designer** - Design funzionalità + contratti API
+- **System Designer** - Design sistemi Frontend/Backend/Mobile/Desktop
+- **System Developer** - Sviluppo parallelo multi-piattaforma
+- **Test Manager** - Coordinamento test in tre fasi
+- **Task Worker** - Esecuzione parallela sotto-attività
+
+### 📐 Modellazione ISA-95 a Sei Fasi
+Basato sulla metodologia di modellazione **ISA-95** standard internazionale, standardizzando la trasformazione dei requisiti di business in sistemi software:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Ogni fase corrisponde a diagrammi UML specifici (casi d'uso, sequenza, classi)
+- I requisiti di business sono "raffinati passo dopo passo", senza perdita di informazioni
+- Gli output sono direttamente utilizzabili per lo sviluppo
+
+### 📚 Sistema di Knowledge Base
+Architettura di knowledge base a tre livelli che assicura che l'IA lavori sempre basata sulla "singola fonte di verità":
+
+| Livello | Directory | Contenuto | Scopo |
+|---------|-----------|-----------|-------|
+| L1 Conoscenza Sistema | `knowledge/techs/` | Stack tecnologico, architettura, convenzioni | IA comprende confini tecnici del progetto |
+| L2 Conoscenza Business | `knowledge/bizs/` | Funzionalità moduli, flussi business, entità | IA comprende logica business |
+| L3 Artefatti Iterazione | `iterations/iXXX/` | PRD, documenti design, report test | Catena completa di tracciabilità per requisiti attuali |
+
+### 🔄 Pipeline di Conoscenze a Quattro Fasi
+**Architettura di generazione automatizzata delle conoscenze**, generazione automatica di documentazione business/tecnica dal codice sorgente:
+```
+Fase 1: Scansione codice sorgente → Genera lista moduli
+Fase 2: Analisi parallela → Estrai funzionalità (multi-Worker parallelo)
+Fase 3: Riepilogo parallelo → Completa panoramica moduli (multi-Worker parallelo)
+Fase 4: Aggregazione sistema → Genera panorama sistema
+```
+- Supporta **sincronizzazione completa** e **sincronizzazione incrementale** (basato su Git diff)
+- Una persona ottimizza, il team condivide
+
+### 🔧 Harness Framework di Implementazione Pratica
+**Framework di esecuzione standardizzato**, garantisce che i documenti di design si trasformino con precisione in istruzioni di sviluppo eseguibili:
+- **Principio del manuale di operazione**: Skill come SOP, passaggi chiari, continui e autocontenuti
+- **Contratto di input/output**: Definizione chiara delle interfacce, esecuzione rigorosa come pseudocodice
+- **Architettura di divulgazione progressiva**: Caricamento delle informazioni a livelli, evitare sovraccarico di contesto
+- **Delega di Sub-Agent**: Divisione automatica di attività complesse, esecuzione parallela per garantire qualità
+
+---
+
 ## 8 Problemi Principali Risolti
 
 ### 1. L'IA Ignora la Documentazione del Progetto Esistente (Lacuna di Conoscenza)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Dopo l'inizializzazione, saranno generati nel progetto:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 definizioni di ruoli Agent
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 workflow Skill
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ workflow Skill
 - `speccrew-workspace/` — Workspace (directory iterazione, base di conoscenza, template documenti)
 - `.speccrewrc` — File di configurazione SpecCrew
 
@@ -213,7 +265,22 @@ Seguire il workflow di ingegneria standard passo dopo passo:
 
 > I deliverable di ogni fase richiedono conferma umana prima di procedere alla fase successiva.
 
-### 4. Altri Comandi CLI
+### 4. Aggiornare SpecCrew
+
+Quando SpecCrew rilascia una nuova versione, sono necessari due passaggi per completare l'aggiornamento:
+
+```bash
+# Step 1: 更新全局 CLI 工具到最新版本
+npm install -g speccrew@latest
+
+# Step 2: 同步项目中的 Agents 和 Skills 到最新版本
+cd /path/to/your-project
+speccrew update
+```
+
+> **Nota**: `npm install -g speccrew@latest` aggiorna lo strumento CLI stesso, mentre `speccrew update` aggiorna i file di definizione degli Agent e degli Skill nel progetto. Entrambi i passaggi devono essere eseguiti per completare l'aggiornamento completo.
+
+### 5. Altri Comandi CLI
 
 ```bash
 speccrew list       # Elenca agent e skill installati
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer: Sviluppo parallelo per piattaforma
 │   │   ├── speccrew-test-manager.md      # Test Manager: Coordinamento testing in tre fasi
 │   │   └── speccrew-task-worker.md       # Task Worker: Esecuzione parallela sotto-attività
-│   └── skills/                      # 38 Skill (raggruppate per funzione)
+│   └── skills/                      # 30+ Skill (raggruppate per funzione)
 │       ├── speccrew-pm-*/                # Gestione Prodotto (analisi requisiti, valutazione)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, Contratto API)
 │       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)

package/README.ja.md

@@ -41,6 +41,58 @@ SpecCrewは組み込み型の仮想AI開発チームフレームワークです
 
 ---
 
+## ✨ 主な特徴
+
+### 🏭 仮想ソフトウェアチーム
+**7つの専門エージェントロール** + **30+のスキルワークフロー**をワンクリックで生成し、完全な仮想ソフトウェアチームを構築：
+- **Team Leader** - 全局スケジューリングとイテレーション管理
+- **Product Manager** - 要件分析とPRD出力
+- **Feature Designer** - 機能設計 + API契約
+- **System Designer** - フロントエンド/バックエンド/モバイル/デスクトップシステム設計
+- **System Developer** - マルチプラットフォーム並列開発
+- **Test Manager** - 3段階テスト調整
+- **Task Worker** - サブタスク並列実行
+
+### 📐 ISA-95 六段階モデリング
+国際標準 **ISA-95** モデリング方法論に基づき、ビジネス要件からソフトウェアシステムへの標準化された変換：
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- 各段階は明確なUML図（ユースケース図、シーケンス図、クラス図など）に対応
+- ビジネス要件は「段階的に詳細化」され、情報損失なし
+- 出力物は開発に直接使用可能
+
+### 📚 ナレッジベースシステム
+AIが常に「単一の信頼できる情報源」に基づいて作業することを保証する3層ナレッジベースアーキテクチャ：
+
+| レイヤー | ディレクトリ | コンテンツ | 目的 |
+|----------|-------------|-----------|------|
+| L1 システム知識 | `knowledge/techs/` | 技術スタック、アーキテクチャ、規約 | AIがプロジェクトの技術的境界を理解 |
+| L2 ビジネス知識 | `knowledge/bizs/` | モジュール機能、ビジネスフロー、エンティティ | AIがビジネスロジックを理解 |
+| L3 イテレーション成果物 | `iterations/iXXX/` | PRD、設計ドキュメント、テストレポート | 現在の要件の完全なトレーサビリティチェーン |
+
+### 🔄 四段階ナレッジパイプライン
+ソースコードからビジネステクニカルドキュメントを自動生成する**自動ナレッジ生成アーキテクチャ**：
+```
+Stage 1: ソースコードスキャン → モジュールリスト生成
+Stage 2: 並列分析 → 機能抽出（マルチWorker並列）
+Stage 3: 並列要約 → モジュール概要完成（マルチWorker並列）
+Stage 4: システム集約 → システムパノラマ生成
+```
+- **フル同期**と**増分同期**（Git diffベース）をサポート
+- 一人が最適化、チームが共有
+
+### 🔧 Harness 実践的実装フレームワーク
+**標準化された実行フレームワーク**、設計ドキュメントを正確に実行可能な開発指示に変換：
+- **操作マニュアル原則**：SkillはSOP、明確で連続的かつ自己完結的なステップ
+- **入出力契約**：明確なインターフェース定義、擬似コードのように厳密な実行
+- **段階的開示アーキテクチャ**：情報を階層的に読み込み、コンテキスト過多を回避
+- **サブエージェント委譲**：複雑なタスクを自動分割、並列実行で品質を確保
+
+---
+
 ## 解決する8つのコア問題
 
 ### 1. AIが既存プロジェクトドキュメントを無視する（知識の断絶）
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 初期化後、プロジェクトに以下が生成されます：
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7つのエージェント役割定義
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38のスキルワークフロー
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+のスキルワークフロー
 - `speccrew-workspace/` — ワークスペース（反復ディレクトリ、ナレッジベース、ドキュメントテンプレート）
 - `.speccrewrc` — SpecCrew設定ファイル
 
@@ -213,7 +265,22 @@ speccrew update --ide claude
 
 > 各フェーズの成果物は次のフェーズに進む前に人間の確認が必要です。
 
-### 4. その他のCLIコマンド
+### 4. SpecCrewの更新
+
+SpecCrewが新バージョンをリリースした場合、更新を完了するには2つのステップが必要です：
+
+```bash
+# Step 1: 更新全局 CLI 工具到最新版本
+npm install -g speccrew@latest
+
+# Step 2: 同步项目中的 Agents 和 Skills 到最新版本
+cd /path/to/your-project
+speccrew update
+```
+
+> **注意**: `npm install -g speccrew@latest` はCLIツール自体を更新し、`speccrew update` はプロジェクト内のAgentとSkill定義ファイルを更新します。完全な更新を完了するには、両方のステップを実行する必要があります。
+
+### 5. その他のCLIコマンド
 
 ```bash
 speccrew list       # インストール済みのエージェントとスキルを一覧表示
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # システム開発者：プラットフォーム別並行開発
 │   │   ├── speccrew-test-manager.md      # テストマネージャー：3フェーズテスト調整
 │   │   └── speccrew-task-worker.md       # タスクワーカー：並行サブタスク実行
-│   └── skills/                      # 38のスキル（機能別グループ化）
+│   └── skills/                      # 30+のスキル（機能別グループ化）
 │       ├── speccrew-pm-*/                # プロダクト管理（要件分析、評価）
 │       ├── speccrew-fd-*/                # 機能設計（機能設計、API契約）
 │       ├── speccrew-sd-*/                # システム設計（フロントエンド/バックエンド/モバイル/デスクトップ）

package/README.ko.md

@@ -41,6 +41,58 @@ Agent와 Skill을 기존 프로젝트에 통합함으로써 프로젝트 문서
 
 ---
 
+## ✨ 주요 특징
+
+### 🏭 가상 소프트웨어 팀
+**7개 전문 Agent 역할** + **30+개 Skill 워크플로우**를 원클릭으로 생성하여 완전한 가상 소프트웨어 팀 구축:
+- **Team Leader** - 전역 스케줄링 및 이터레이션 관리
+- **Product Manager** - 요구사항 분석 및 PRD 출력
+- **Feature Designer** - 기능 설계 + API 계약
+- **System Designer** - 프론트엔드/백엔드/모바일/데스크톱 시스템 설계
+- **System Developer** - 멀티플랫폼 병렬 개발
+- **Test Manager** - 3단계 테스트 조정
+- **Task Worker** - 하위 작업 병렬 실행
+
+### 📐 ISA-95 6단계 모델링
+국제 표준 **ISA-95** 모델링 방법론을 기반으로 비즈니스 요구사항에서 소프트웨어 시스템으로의 표준화된 전환:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- 각 단계는 명확한 UML 다이어그램(유스 케이스, 시퀀스, 클래스 다이어그램 등)에 대응
+- 비즈니스 요구사항 "단계별 정제", 정보 손실 없음
+- 출력물은 개발에 직접 사용 가능
+
+### 📚 지식 베이스 시스템
+AI가 항상 "단일 진실 공급원"을 기반으로 작업하도록 보장하는 3계층 지식 베이스 아키텍처:
+
+| 계층 | 디렉토리 | 내용 | 목적 |
+|------|----------|------|------|
+| L1 시스템 지식 | `knowledge/techs/` | 기술 스택, 아키텍처, 규약 | AI가 프로젝트 기술 경계 이해 |
+| L2 비즈니스 지식 | `knowledge/bizs/` | 모듈 기능, 비즈니스 흐름, 엔티티 | AI가 비즈니스 로직 이해 |
+| L3 이터레이션 산출물 | `iterations/iXXX/` | PRD, 설계 문서, 테스트 보고서 | 현재 요구사항 완전 추적성 체인 |
+
+### 🔄 4단계 지식 파이프라인
+소스 코드에서 비즈니스/기술 문서를 자동 생성하는 **자동화된 지식 생성 아키텍처**:
+```
+Stage 1: 소스 코드 스캔 → 모듈 목록 생성
+Stage 2: 병렬 분석 → 기능 추출 (다중 Worker 병렬)
+Stage 3: 병렬 요약 → 모듈 개요 완성 (다중 Worker 병렬)
+Stage 4: 시스템 집계 → 시스템 파노라마 생성
+```
+- **전체 동기화** 및 **증분 동기화** 지원 (Git diff 기반)
+- 한 사람이 최적화하면 팀이 공유
+
+### 🔧 Harness 실전 적용 프레임워크
+**표준화된 실행 프레임워크**, 설계 문서가 실행 가능한 개발 지시사항으로 정확하게 변환되도록 보장:
+- **운영 매뉴얼 원칙**: Skill은 SOP, 단계가 명확하고 연속적이며 자체 포함
+- **입출력 계약**: 인터페이스를 명확히 정의, 의사코드처럼 엄격하게 실행
+- **단계별 공개 아키텍처**: 정보를 계층적으로 로드, 일회성 컨텍스트 과부하 방지
+- **하위 Agent 위임**: 복잡한 작업 자동 분할, 병렬 실행으로 품질 보장
+
+---
+
 ## 8가지 핵심 문제 해결
 
 ### 1. AI가 기존 프로젝트 문서를 무시함 (지식 단절)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 초기화 후 프로젝트에 다음이 생성됩니다:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7개 Agent 역할 정의
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38개 Skill 워크플로우
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+개 Skill 워크플로우
 - `speccrew-workspace/` — 작업 공간 (반복 디렉토리, 지식 기반, 문서 템플릿)
 - `.speccrewrc` — SpecCrew 구성 파일
 
@@ -213,7 +265,22 @@ speccrew update --ide claude
 
 > 각 단계의 산출물은 다음 단계로 진행하기 전 사용자 확인이 필요합니다.
 
-### 4. 기타 CLI 명령
+### 4. SpecCrew 업데이트
+
+새로운 버전의 SpecCrew가 출시되면 다음 두 단계를 완료하여 업데이트하세요:
+
+```bash
+# Step 1: Update the global CLI tool to the latest version
+npm install -g speccrew@latest
+
+# Step 2: Sync Agents and Skills in your project to the latest version
+cd /path/to/your-project
+speccrew update
+```
+
+> **참고**: `npm install -g speccrew@latest`는 CLI 도구 자체를 업데이트하고, `speccrew update`는 프로젝트의 Agent와 Skill 정의 파일을 업데이트합니다. 완전한 업데이트를 위해서는 두 단계 모두 필요합니다.
+
+### 5. 기타 CLI 명령
 
 ```bash
 speccrew list       # 설치된 agent와 skill 나열
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # 시스템 개발자: 플랫폼별 병렬 개발
 │   │   ├── speccrew-test-manager.md      # 테스트 관리자: 3단계 테스트 조정
 │   │   └── speccrew-task-worker.md       # 작업자: 병렬 하위 작업 실행
-│   └── skills/                      # 38개 Skill (기능별 그룹화)
+│   └── skills/                      # 30+개 Skill (기능별 그룹화)
 │       ├── speccrew-pm-*/                # 제품 관리 (요구사항 분석, 평가)
 │       ├── speccrew-fd-*/                # 기능 설계 (Feature Design, API 계약)
 │       ├── speccrew-sd-*/                # 시스템 설계 (프론트엔드/백엔드/모바일/데스크톱)

package/README.md

@@ -41,6 +41,58 @@ SpecCrew 是一套嵌入式的虚拟 AI 开发团队框架。它将专业的软
 
 ---
 
+## ✨ 核心亮点
+
+### 🏭 虚拟软件团队
+一键生成 **7 个专业 Agent 角色** + **30+ 个 Skill 工作流**，构建完整虚拟软件团队：
+- **Team Leader** - 全局调度与迭代管理
+- **Product Manager** - 需求分析与 PRD 输出
+- **Feature Designer** - 功能设计 + API 契约
+- **System Designer** - 前端/后端/移动端/桌面端系统设计
+- **System Developer** - 多端并行开发
+- **Test Manager** - 三阶段测试协调
+- **Task Worker** - 子任务并行执行
+
+### 📐 ISA-95 六段式建模
+基于国际标准 **ISA-95** 建模方法论，实现业务需求到软件系统的标准化转化：
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- 每个阶段对应明确的 UML 图（用例图、序列图、类图等）
+- 业务需求"逐级细化"，无信息丢失
+- 输出物可直接用于开发
+
+### 📚 知识库体系
+三层次知识库架构，确保 AI 始终基于"事实来源"工作：
+
+| 层级 | 目录 | 内容 | 作用 |
+|------|------|------|------|
+| L1 系统知识 | `knowledge/techs/` | 技术栈、架构、开发规约 | AI 理解项目技术边界 |
+| L2 业务知识 | `knowledge/bizs/` | 模块功能、业务流程、实体关系 | AI 理解业务逻辑 |
+| L3 迭代产物 | `iterations/iXXX/` | PRD、设计文档、测试报告 | 当前需求完整追溯链 |
+
+### 🔄 四阶段知识流水线
+**自动化知识生成架构**，从源代码自动生成业务/技术文档：
+```
+Stage 1: 扫描源码 → 生成模块清单
+Stage 2: 并行分析 → 提取功能特性（多 Worker 并行）
+Stage 3: 并行汇总 → 完善模块概览（多 Worker 并行）
+Stage 4: 系统聚合 → 生成系统全景图
+```
+- 支持 **全量同步** 和 **增量同步**（基于 Git diff）
+- 一人优化，团队共享
+
+### 🔧 Harness 实战落地框架
+**标准化执行框架**，确保设计文档精准转化为可执行的开发指令：
+- **操作手册原则**：Skill 即 SOP，步骤清晰、连续、自包含
+- **输入输出契约**：明确定义接口，像伪代码一样严谨执行
+- **逐级披露架构**：信息分层加载，避免一次性上下文过载
+- **子 Agent 委派**：复杂任务自动拆分，并行执行确保质量
+
+---
+
 ## 解决 8 个核心问题
 
 ### 1. AI 忽略现有项目文档（知识断层）
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 初始化完成后，项目中会生成：
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 个 Agent 角色定义
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 个 Skill 工作流
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ 个 Skill 工作流
 - `speccrew-workspace/` — 工作区（迭代目录、知识库、文档模板）
 - `.speccrewrc` — SpecCrew 配置文件
 
@@ -213,7 +265,22 @@ speccrew update --ide claude
 
 > 每个阶段产出物需人工确认后方可进入下一阶段。
 
-### 4. 其他 CLI 命令
+### 4. 更新 SpecCrew
+
+当 SpecCrew 发布新版本时，需要两步完成更新：
+
+```bash
+# Step 1: 更新全局 CLI 工具到最新版本
+npm install -g speccrew@latest
+
+# Step 2: 同步项目中的 Agents 和 Skills 到最新版本
+cd /path/to/your-project
+speccrew update
+```
+
+> **注意**：`npm install -g speccrew@latest` 更新的是 CLI 工具本身，`speccrew update` 更新的是项目中的 Agent 和 Skill 定义文件。两步都需要执行才能完成完整更新。
+
+### 5. 其他 CLI 命令
 
 ```bash
 speccrew list       # 列出已安装的 agents 和 skills

package/README.no.md

@@ -41,6 +41,58 @@ Ved å integrere Agenter og Skills i eksisterende prosjekter, kan team raskt ini
 
 ---
 
+## ✨ Nøkkelfunksjoner
+
+### 🏭 Virtuelt Programvareteam
+Ett-klikks generering av **7 profesjonelle Agent-roller** + **30+ Skill-arbeidsflyter**, bygging av et komplett virtuelt programvareteam:
+- **Team Leader** - Global planlegging og iterasjonshåndtering
+- **Product Manager** - Kravanalyse og PRD-utdata
+- **Feature Designer** - Funksjonsdesign + API-kontrakter
+- **System Designer** - Systemdesign for Frontend/Backend/Mobil/Desktop
+- **System Developer** - Multiplattform parallellutvikling
+- **Test Manager** - Trefaset testkoordinering
+- **Task Worker** - Parallell underoppgaveutførelse
+
+### 📐 ISA-95 Sekstrinns Modellering
+Basert på internasjonal **ISA-95** modelleringsmetodikk, standardisering av transformasjonen fra forretningskrav til programvaresystemer:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Hvert trinn tilsvarer spesifikke UML-diagrammer (use case, sekvens, klassediagrammer)
+- Forretningskrav "foredles trinn for trinn" uten informasjonstap
+- Uttak er direkte brukbar for utvikling
+
+### 📚 Kunnskapsbasesystem
+Trenivå kunnskapsbasearkitektur som sikrer at AI alltid jobber basert på "den eneste sannhetskilden":
+
+| Nivå | Katalog | Innhold | Formål |
+|------|---------|---------|--------|
+| L1 Systemkunnskap | `knowledge/techs/` | Tech-stack, arkitektur, konvensjoner | AI forstår prosjektets tekniske grenser |
+| L2 Forretningskunnskap | `knowledge/bizs/` | Modulfunksjoner, forretningsflyter, enheter | AI forstår forretningslogikk |
+| L3 Iterasjonsartefakter | `iterations/iXXX/` | PRD, designdokumenter, testrapporter | Full sporbarhetskjede for gjeldende krav |
+
+### 🔄 Firetrinns Kunnskapspipeline
+**Automatisert kunnskapsproduksjonsarkitektur**, automatisk generering av forretnings/teknisk dokumentasjon fra kildekode:
+```
+Trinn 1: Skann kildekode → Generer modulliste
+Trinn 2: Parallell analyse → Trekk ut funksjoner (multi-Worker parallelt)
+Trinn 3: Parallell oppsummering → Fullfør moduloversikter (multi-Worker parallelt)
+Trinn 4: Systemaggregering → Generer systempanorama
+```
+- Støtter **full synkronisering** og **inkrementell synkronisering** (basert på Git diff)
+- En person optimaliserer, team deler
+
+### 🔧 Harness Praktisk Implementeringsrammeverk
+**Standardisert utførelsesrammeverk**, sikrer at designdokumenter presist transformeres til kjørbare utviklingsinstruksjoner:
+- **Driftshåndbok-prinsipp**: Skill er SOP, trinn er klare, sammenhengende og selvstendige
+- **Inn- og utdatakontrakt**: Tydelig definerte grensesnitt, utføres like strengt som pseudokode
+- **Progressiv avsløringsarkitektur**: Informasjon lastes lagvis, unngår engangskontekst-overbelastning
+- **Sub-Agent-delegering**: Komplekse oppgaver deles automatisk, parallell utførelse sikrer kvalitet
+
+---
+
 ## 8 Kjerne-problemer Løst
 
 ### 1. AI Ignorerer Eksisterende Prosjektdokumentasjon (Kunnskapshull)
@@ -189,7 +241,7 @@ 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
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ Skill-arbeidsflyter
 - `speccrew-workspace/` — Arbeidsområde (iterasjonskataloger, kunnskapsbase, dokumentmaler)
 - `.speccrewrc` — SpecCrew-konfigurasjonsfil
 
@@ -213,7 +265,22 @@ Følg standard ingeniørarbeidsflyt trinn for trinn:
 
 > Hver fases leveranser krever menneskelig bekreftelse før fortsettelse til neste fase.
 
-### 4. Andre CLI-kommandoer
+### 4. Oppdater SpecCrew
+
+Når en ny versjon av SpecCrew slippes, fullfør oppdateringen i to trinn:
+
+```bash
+# Step 1: Update the global CLI tool to the latest version
+npm install -g speccrew@latest
+
+# Step 2: Sync Agents and Skills in your project to the latest version
+cd /path/to/your-project
+speccrew update
+```
+
+> **Merk**: `npm install -g speccrew@latest` oppdaterer selve CLI-verktøyet, mens `speccrew update` oppdaterer Agent- og Skill-definisjonsfilene i prosjektet ditt. Begge trinnene er nødvendige for en fullstendig oppdatering.
+
+### 5. Andre CLI-kommandoer
 
 ```bash
 speccrew list       # List opp installerte agenter og skills
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── 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)
+│   └── skills/                      # 30+ 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)