speccrew 0.1.12 → 0.2.1

package/README.pl.md

@@ -41,6 +41,58 @@ Poprzez integrację Agentów i Skilli z istniejącymi projektami, zespoły mogą
 
 ---
 
+## ✨ Kluczowe Cechy
+
+### 🏭 Wirtualny Zespół Software'owy
+Jednoklikowe generowanie **7 profesjonalnych ról Agentów** + **30+ workflowów Skilli**, budowanie kompletnego wirtualnego zespołu software'owego:
+- **Team Leader** - Globalne planowanie i zarządzanie iteracjami
+- **Product Manager** - Analiza wymagań i generowanie PRD
+- **Feature Designer** - Projektowanie funkcji + kontrakty API
+- **System Designer** - Projektowanie systemów Frontend/Backend/Mobilny/Desktop
+- **System Developer** - Równoległy rozwój multiplatformowy
+- **Test Manager** - Koordynacja testów w trzech fazach
+- **Task Worker** - Równoległe wykonywanie podzadań
+
+### 📐 Modelowanie ISA-95 Sześciostopniowe
+Oparte na międzynarodowej metodyce modelowania **ISA-95**, standaryzacja transformacji wymagań biznesowych w systemy software'owe:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Każdy stopień odpowiada określonym diagramom UML (przypadki użycia, sekwencje, diagramy klas)
+- Wymagania biznesowe są "udokładniane krok po kroku", bez utraty informacji
+- Wyniki są bezpośrednio użyteczne do rozwoju
+
+### 📚 System Bazy Wiedzy
+Trójpoziomowa architektura bazy wiedzy zapewniająca, że AI zawsze pracuje w oparciu o "pojedyncze źródło prawdy":
+
+| Poziom | Katalog | Zawartość | Cel |
+|--------|---------|-----------|------|
+| L1 Wiedza Systemowa | `knowledge/techs/` | Stack technologiczny, architektura, konwencje | AI rozumie granice techniczne projektu |
+| L2 Wiedza Biznesowa | `knowledge/bizs/` | Funkcje modułów, przepływy biznesowe, encje | AI rozumie logikę biznesową |
+| L3 Artefakty Iteracji | `iterations/iXXX/` | PRD, dokumenty projektowe, raporty testowe | Pełny łańcuch śledzenia dla bieżących wymagań |
+
+### 🔄 Czterostopniowy Pipeline Wiedzy
+**Zautomatyzowana architektura generowania wiedzy**, automatyczne generowanie dokumentacji biznesowej/technicznej z kodu źródłowego:
+```
+Stopień 1: Skanowanie kodu źródłowego → Generowanie listy modułów
+Stopień 2: Analiza równoległa → Ekstrakcja funkcji (wielu Workerów równolegle)
+Stopień 3: Podsumowanie równoległe → Uzupełnienie przeglądów modułów (wielu Workerów równolegle)
+Stopień 4: Agregacja systemu → Generowanie panoramy systemu
+```
+- Obsługuje **pełną synchronizację** i **synchronizację inkrementalną** (opartą na Git diff)
+- Jedna osoba optymalizuje, zespół dzieli się
+
+### 🔧 Harness Praktyczne Ramy Wdrożeniowe
+**Zestandaryzowane ramy wykonawcze**, zapewniające precyzyjną transformację dokumentów projektowych w wykonywalne instrukcje deweloperskie:
+- **Zasada podręcznika operacyjnego**: Skill to SOP, kroki są jasne, ciągłe i samowystarczalne
+- **Kontrakt wejścia-wyjścia**: Jasno zdefiniowane interfejsy, wykonywane tak rygorystycznie jak pseudokod
+- **Architektura progresywnego ujawniania**: Informacje ładowane warstwowo, unikanie jednorazowego przeciążenia kontekstu
+- **Delegowanie sub-Agentów**: Złożone zadania automatycznie podzielone, równoległe wykonanie zapewnia jakość
+
+---
+
 ## 8 Rozwiązanych Problemów Rdzeniowych
 
 ### 1. AI Ignoruje Istniejącą Dokumentację Projektu (Luka Wiedzy)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Po inicjalizacji w projekcie zostaną wygenerowane:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 definicji ról Agentów
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 workflow Skilli
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ workflow Skilli
 - `speccrew-workspace/` — Przestrzeń robocza (katalogi iteracji, baza wiedzy, szablony dokumentów)
 - `.speccrewrc` — Plik konfiguracyjny SpecCrew
 
@@ -213,7 +265,22 @@ Podążaj za standardowym workflow inżynieryjnym krok po kroku:
 
 > Deliverable każdej fazy wymaga ludzkiego potwierdzenia przed przejściem do następnej fazy.
 
-### 4. Inne Komendy CLI
+### 4. Zaktualizuj SpecCrew
+
+Gdy zostanie wydana nowa wersja SpecCrew, ukończ aktualizację w dwóch krokach:
+
+```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
+```
+
+> **Uwaga**: `npm install -g speccrew@latest` aktualizuje samo narzędzie CLI, podczas gdy `speccrew update` aktualizuje pliki definicji Agentów i Skilli w Twoim projekcie. Oba kroki są wymagane dla pełnej aktualizacji.
+
+### 5. Inne Komendy CLI
 
 ```bash
 speccrew list       # Wylistuj zainstalowane agenty i skille
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer: Równoległy rozwój według platformy
 │   │   ├── speccrew-test-manager.md      # Test Manager: Koordynacja testów trójfazowych
 │   │   └── speccrew-task-worker.md       # Task Worker: Równoległa egzekucja podzadań
-│   └── skills/                      # 38 Skilli (zgrupowane według funkcji)
+│   └── skills/                      # 30+ Skilli (zgrupowane według funkcji)
 │       ├── speccrew-pm-*/                # Zarządzanie Produktem (analiza wymagań, ewaluacja)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, Kontrakt API)
 │       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)

package/README.pt-BR.md

@@ -41,6 +41,58 @@ Ao integrar Agents e Skills em projetos existentes, as equipes podem inicializar
 
 ---
 
+## ✨ Destaques Principais
+
+### 🏭 Equipe de Software Virtual
+Geração com um clique de **7 papéis de Agentes profissionais** + **30+ fluxos de trabalho de Skills**, construindo uma equipe de software virtual completa:
+- **Team Leader** - Planejamento global e gerenciamento de iterações
+- **Product Manager** - Análise de requisitos e geração de PRD
+- **Feature Designer** - Design de funcionalidades + contratos API
+- **System Designer** - Design de sistemas Frontend/Backend/Mobile/Desktop
+- **System Developer** - Desenvolvimento paralelo multiplataforma
+- **Test Manager** - Coordenação de testes em três fases
+- **Task Worker** - Execução paralela de subtarefas
+
+### 📐 Modelagem ISA-95 de Seis Estágios
+Baseado na metodologia de modelagem internacional **ISA-95**, padronizando a transformação de requisitos de negócio em sistemas de software:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Cada estágio corresponde a diagramas UML específicos (casos de uso, sequência, classes)
+- Requisitos de negócio são "refinados passo a passo", sem perda de informação
+- Saídas são diretamente utilizáveis para desenvolvimento
+
+### 📚 Sistema de Base de Conhecimento
+Arquitetura de base de conhecimento de três níveis garantindo que a IA sempre trabalhe baseada na "fonte única da verdade":
+
+| Nível | Diretório | Conteúdo | Propósito |
+|-------|-----------|----------|-----------|
+| L1 Conhecimento do Sistema | `knowledge/techs/` | Stack tecnológico, arquitetura, convenções | IA entende limites técnicos do projeto |
+| L2 Conhecimento de Negócio | `knowledge/bizs/` | Funcionalidades de módulos, fluxos de negócio, entidades | IA entende lógica de negócio |
+| L3 Artefatos de Iteração | `iterations/iXXX/` | PRD, documentos de design, relatórios de teste | Cadeia completa de rastreabilidade para requisitos atuais |
+
+### 🔄 Pipeline de Conhecimento de Quatro Estágios
+**Arquitetura de geração automatizada de conhecimento**, geração automática de documentação de negócio/técnica a partir do código-fonte:
+```
+Estágio 1: Escanear código-fonte → Gerar lista de módulos
+Estágio 2: Análise paralela → Extrair funcionalidades (multi-Worker paralelo)
+Estágio 3: Resumo paralelo → Completar visões gerais de módulos (multi-Worker paralelo)
+Estágio 4: Agregação do sistema → Gerar panorama do sistema
+```
+- Suporta **sincronização completa** e **sincronização incremental** (baseado em Git diff)
+- Uma pessoa otimiza, equipe compartilha
+
+### 🔧 Harness Framework de Implementação Prática
+**Framework de execução padronizado**, garantindo que documentos de design sejam transformados com precisão em instruções de desenvolvimento executáveis:
+- **Princípio do manual de operações**: Skill é SOP, etapas são claras, contínuas e autossuficientes
+- **Contrato de entrada-saída**: Interfaces claramente definidas, executadas com o rigor de pseudocódigo
+- **Arquitetura de revelação progressiva**: Informações carregadas em camadas, evitando sobrecarga de contexto única
+- **Delegação de sub-Agent**: Tarefas complexas divididas automaticamente, execução paralela garante qualidade
+
+---
+
 ## 8 Problemas Principais Resolvidos
 
 ### 1. IA Ignora Documentação de Projeto Existente (Lacuna de Conhecimento)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Após a inicialização, os seguintes itens serão gerados no projeto:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 definições de papéis de Agent
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 fluxos de trabalho de Skill
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ fluxos de trabalho de Skill
 - `speccrew-workspace/` — Espaço de trabalho (diretórios de iteração, base de conhecimento, templates de documentos)
 - `.speccrewrc` — Arquivo de configuração do SpecCrew
 
@@ -213,7 +265,22 @@ Siga o fluxo de trabalho de engenharia padrão passo a passo:
 
 > Os entregáveis de cada fase requerem confirmação humana antes de prosseguir para a próxima fase.
 
-### 4. Outros Comandos CLI
+### 4. Atualizar SpecCrew
+
+Quando uma nova versão do SpecCrew for lançada, complete a atualização em duas etapas:
+
+```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
+```
+
+> **Nota**: `npm install -g speccrew@latest` atualiza a própria ferramenta CLI, enquanto `speccrew update` atualiza os arquivos de definição de Agent e Skill no seu projeto. Ambas as etapas são necessárias para uma atualização completa.
+
+### 5. Outros Comandos CLI
 
 ```bash
 speccrew list       # Listar agents e skills instalados
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer: Desenvolvimento paralelo por plataforma
 │   │   ├── speccrew-test-manager.md      # Test Manager: Coordenação de testes em três fases
 │   │   └── speccrew-task-worker.md       # Task Worker: Execução paralela de subtarefas
-│   └── skills/                      # 38 Skills (agrupadas por função)
+│   └── skills/                      # 30+ Skills (agrupadas por função)
 │       ├── speccrew-pm-*/                # Gestão de Produto (análise de requisitos, avaliação)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, Contrato API)
 │       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)

package/README.ru.md

@@ -41,6 +41,58 @@ SpecCrew — это встраиваемый фреймворк виртуаль
 
 ---
 
+## ✨ Ключевые особенности
+
+### 🏭 Виртуальная команда разработки
+Генерация в один клик **7 профессиональных ролей Агентов** + **30+ рабочих процессов Навыков**, создание полной виртуальной команды разработки:
+- **Team Leader** - Глобальное планирование и управление итерациями
+- **Product Manager** - Анализ требований и генерация PRD
+- **Feature Designer** - Проектирование функций + API-контракты
+- **System Designer** - Проектирование систем Frontend/Backend/Mobile/Desktop
+- **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-диаграммам (use case, sequence, class diagrams)
+- Бизнес-требования "уточняются поэтапно", без потери информации
+- Результаты непосредственно пригодны для разработки
+
+### 📚 Система базы знаний
+Трехуровневая архитектура базы знаний, гарантирующая, что ИИ всегда работает на основе "единого источника истины":
+
+| Уровень | Каталог | Содержимое | Назначение |
+|---------|---------|-----------|------------|
+| L1 Системные знания | `knowledge/techs/` | Технологический стек, архитектура, соглашения | ИИ понимает технические границы проекта |
+| L2 Бизнес-знания | `knowledge/bizs/` | Функции модулей, бизнес-процессы, сущности | ИИ понимает бизнес-логику |
+| L3 Артефакты итераций | `iterations/iXXX/` | PRD, проектные документы, отчеты о тестировании | Полная цепочка отслеживания для текущих требований |
+
+### 🔄 Четырехэтапный конвейер знаний
+**Автоматизированная архитектура генерации знаний**, автоматическая генерация бизнес/технической документации из исходного кода:
+```
+Этап 1: Сканирование исходного кода → Генерация списка модулей
+Этап 2: Параллельный анализ → Извлечение функций (много Worker параллельно)
+Этап 3: Параллельное обобщение → Завершение обзоров модулей (много Worker параллельно)
+Этап 4: Системная агрегация → Генерация панорамы системы
+```
+- Поддерживает **полную синхронизацию** и **инкрементальную синхронизацию** (на основе Git diff)
+- Один оптимизирует, команда использует
+
+### 🔧 Harness Практическая структура внедрения
+**Стандартизированная структура исполнения**, обеспечивающая точное преобразование проектных документов в выполнимые инструкции по разработке:
+- **Принцип операционного руководства**: Skill — это СОП, шаги чёткие, последовательные и самодостаточные
+- **Контракт входа-выхода**: Чётко определённые интерфейсы, выполняемые так же строго, как псевдокод
+- **Архитектура прогрессивного раскрытия**: Информация загружается по слоям, избегая разовой перегрузки контекста
+- **Делегирование суб-Агентов**: Сложные задачи автоматически разделяются, параллельное выполнение обеспечивает качество
+
+---
+
 ## Решение 8 ключевых проблем
 
 ### 1. ИИ игнорирует существующую документацию проекта (разрыв знаний)
@@ -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, выполните обновление в два шага:
+
+```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` обновляет файлы определений Агентов и Навыков в вашем проекте. Для полного обновления необходимы оба шага.
+
+### 5. Другие команды CLI
 
 ```bash
 speccrew list       # Список установленных агентов и навыков
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer: Параллельная разработка по платформам
 │   │   ├── speccrew-test-manager.md      # Test Manager: Координация трёхфазного тестирования
 │   │   └── speccrew-task-worker.md       # Task Worker: Параллельное выполнение подзадач
-│   └── skills/                      # 38 Навыков (сгруппированных по функциям)
+│   └── skills/                      # 30+ Навыков (сгруппированных по функциям)
 │       ├── speccrew-pm-*/                # Управление продуктом (анализ требований, оценка)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, API контракт)
 │       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)

package/README.th.md

@@ -41,6 +41,58 @@ SpecCrew เป็นเฟรมเวิร์กทีมพัฒนา AI
 
 ---
 
+## ✨ จุดเด่นหลัก
+
+### 🏭 ทีมซอฟต์แวร์เสมือน
+การสร้างด้วยคลิกเดียว **7 บทบาท Agent มืออาชีพ** + **30+ เวิร์กโฟลว์ Skill** สร้างทีมซอฟต์แวร์เสมือนที่สมบูรณ์:
+- **Team Leader** - การวางแผนระดับโลกและการจัดการการทำซ้ำ
+- **Product Manager** - การวิเคราะห์ความต้องการและผลลัพธ์ PRD
+- **Feature Designer** - การออกแบบฟีเจอร์ + สัญญา API
+- **System Designer** - การออกแบบระบบ Frontend/Backend/Mobile/Desktop
+- **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 เฉพาะ (use case, sequence, class)
+- ความต้องการทางธุรกิจ "ถูกกลั่นกรองทีละขั้นตอน" โดยไม่สูญเสียข้อมูล
+- ผลลัพธ์สามารถนำไปใช้ในการพัฒนาได้โดยตรง
+
+### 📚 ระบบฐานความรู้
+สถาปัตยกรรมฐานความรู้สามชั้นที่รับรองว่า AI ทำงานอิงตาม "แหล่งความจริงเดียว" เสมอ:
+
+| ชั้น | ไดเรกทอรี | เนื้อหา | วัตถุประสงค์ |
+|------|-----------|---------|-------------|
+| L1 ความรู้ระบบ | `knowledge/techs/` | Stack เทคโนโลยี, สถาปัตยกรรม, ข้อตกลง | AI เข้าใจขอบเขตทางเทคนิคของโปรเจกต์ |
+| L2 ความรู้ธุรกิจ | `knowledge/bizs/` | ฟังก์ชันโมดูล, การไหลทางธุรกิจ, เอนทิตี | AI เข้าใจตรรกะทางธุรกิจ |
+| L3 สิ่งซ้ำการทำซ้ำ | `iterations/iXXX/` | PRD, เอกสารการออกแบบ, รายงานการทดสอบ | โซ่การติดตามที่สมบูรณ์สำหรับความต้องการปัจจุบัน |
+
+### 🔄 ไปป์ไลน์ความรู้สี่ขั้นตอน
+**สถาปัตยกรรมการสร้างความรู้โดยอัตโนมัติ** การสร้างเอกสารธุรกิจ/เทคนิคโดยอัตโนมัติจากรหัสต้นฉบับ:
+```
+ขั้นตอนที่ 1: สแกนรหัสต้นฉบับ → สร้างรายการโมดูล
+ขั้นตอนที่ 2: การวิเคราะห์ขนาน → สกัดฟีเจอร์ (multi-Worker ขนาน)
+ขั้นตอนที่ 3: การสรุปขนาน → ทำให้ภาพรวมโมดูลสมบูรณ์ (multi-Worker ขนาน)
+ขั้นตอนที่ 4: การรวมระบบ → สร้างภาพพาโนรามาของระบบ
+```
+- รองรับ **การซิงค์แบบเต็ม** และ **การซิงค์แบบเพิ่ม** (อิงตาม Git diff)
+- คนเดียวปรับปรุง ทีมแชร์
+
+### 🔧 Harness กรอบการลงมือปฏิบัติจริง
+**กรอบการดำเนินการมาตรฐาน** เพื่อให้แน่ใจว่าเอกสารการออกแบบถูกแปลงเป็นคำสั่งพัฒนาที่ปฏิบัติได้อย่างแม่นยำ:
+- **หลักคู่มือการดำเนินการ**: Skill คือ SOP ขั้นตอนชัดเจน ต่อเนื่อง และครบถ้วนในตัวเอง
+- **สัญญาอินพุต-เอาต์พุต**: กำหนดอินเทอร์เฟซชัดเจน ปฏิบัติอย่างเคร่งครัดเหมือน pseudocode
+- **สถาปัตยกรรมการเปิดเผยแบบก้าวหน้า**: โหลดข้อมูลแบบเลเยอร์ หลีกเลี่ยงการโหลดบริบทมากเกินไปในครั้งเดียว
+- **การมอบหมาย Sub-Agent**: แยกงานอัตโนมัติสำหรับงานที่ซับซ้อน ดำเนินการแบบขนานเพื่อรับประกันคุณภาพ
+
+---
+
 ## แก้ปัญหาหลัก 8 ประการ
 
 ### 1. AI เพิกเฉยต่อเอกสารโปรเจกต์ที่มีอยู่ (ช่องว่างความรู้)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 หลังจากการเริ่มต้น สิ่งต่อไปนี้จะถูกสร้างในโปรเจกต์ของคุณ:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — นิยามบทบาท Agent 7 ตัว
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — เวิร์กโฟลว์ Skill 38 ตัว
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — เวิร์กโฟลว์ Skill 30+ ตัว
 - `speccrew-workspace/` — พื้นที่ทำงาน (ไดเรกทอรีวนซ้ำ, ฐานความรู้, เทมเพลตเอกสาร)
 - `.speccrewrc` — ไฟล์การกำหนดค่า SpecCrew
 
@@ -213,7 +265,22 @@ speccrew update --ide claude
 
 > ผลลัพธ์ของแต่ละเฟสต้องการการยืนยันจากมนุษย์ก่อนดำเนินการต่อไปยังเฟสถัดไป
 
-### 4. คำสั่ง CLI อื่นๆ
+### 4. อัปเดต SpecCrew
+
+เมื่อมีการเปิดตัว SpecCrew เวอร์ชันใหม่ ให้ทำการอัปเดตให้เสร็จสิ้นใน 2 ขั้นตอน:
+
+```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 ที่ติดตั้ง

package/README.tr.md

@@ -41,6 +41,58 @@ Mevcut projelere Agent'ları ve Skill'leri entegre ederek, ekipler proje doküma
 
 ---
 
+## ✨ Ana Özellikler
+
+### 🏭 Sanal Yazılım Ekibi
+Tek tıkla **7 profesyonel Agent rolü** + **30+ Skill iş akışı** oluşturma, eksiksiz bir sanal yazılım ekibi oluşturma:
+- **Team Leader** - Global planlama ve iterasyon yönetimi
+- **Product Manager** - Gereksinim analizi ve PRD çıktısı
+- **Feature Designer** - Özellik tasarımı + API sözleşmeleri
+- **System Designer** - Frontend/Backend/Mobil/Desktop sistem tasarımı
+- **System Developer** - Çoklu platform paralel geliştirme
+- **Test Manager** - Üç aşamalı test koordinasyonu
+- **Task Worker** - Alt görev paralel yürütme
+
+### 📐 ISA-95 Altı Aşamalı Modelleme
+Uluslararası **ISA-95** modelleme metodolojisine dayalı, iş gereksinimlerinden yazılım sistemlerine dönüşümün standartlaştırılması:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Her aşama belirli UML diyagramlarına karşılık gelir (use case, sequence, class)
+- İş gereksinimleri "adım adım rafine edilir", bilgi kaybı olmadan
+- Çıktılar geliştirme için doğrudan kullanılabilir
+
+### 📚 Bilgi Tabanı Sistemi
+AI'nın her zaman "tek gerçek kaynağına" dayanarak çalışmasını sağlayan üç katmanlı bilgi tabanı mimarisi:
+
+| Katman | Dizin | İçerik | Amaç |
+|--------|-------|--------|------|
+| L1 Sistem Bilgisi | `knowledge/techs/` | Tech stack, mimari, sözleşmeler | AI projenin teknik sınırlarını anlar |
+| L2 İş Bilgisi | `knowledge/bizs/` | Modül işlevleri, iş akışları, varlıklar | AI iş mantığını anlar |
+| L3 İterasyon Eserleri | `iterations/iXXX/` | PRD, tasarım belgeleri, test raporları | Mevcut gereksinimler için eksiksiz izlenebilirlik zinciri |
+
+### 🔄 Dört Aşamalı Bilgi Hattı
+**Otomatik bilgi üretimi mimarisi**, kaynak koddan iş/teknik dokümantasyonun otomatik olarak oluşturulması:
+```
+Aşama 1: Kaynak kod tarama → Modül listesi oluşturma
+Aşama 2: Paralel analiz → Özellik çıkarma (çoklu Worker paralel)
+Aşama 3: Paralel özetleme → Modül görünümlerini tamamlama (çoklu Worker paralel)
+Aşama 4: Sistem agregasyonu → Sistem panoraması oluşturma
+```
+- **Tam senkronizasyon** ve **artımlı senkronizasyon** destekler (Git diff tabanlı)
+- Bir kişi optimize eder, ekip paylaşır
+
+### 🔧 Harness Pratik Uygulama Çerçevesi
+**Standartlaştırılmış yürütme çerçevesi**, tasarım belgelerinin yürütülebilir geliştirme talimatlarına hassas bir şekilde dönüştürülmesini sağlar:
+- **Operasyonel kılavuz ilkesi**: Skill bir SOP'dur, adımlar net, ardışık ve kendi kendine yeten
+- **Girdi-çıktı sözleşmesi**: Arayüzleri açıkça tanımlar, pseudocode gibi titizlikle yürütür
+- **Aşamalı açıklama mimarisi**: Bilgileri katmanlı yükler, tek seferde bağlam aşırı yüklenmesini önler
+- **Alt Agent delege etme**: Karmaşık görevleri otomatik böler, paralel yürütme kaliteyi güvence altına alır
+
+---
+
 ## Çözülen 8 Temel Sorun
 
 ### 1. AI Mevcut Proje Dokümantasyonunu Görmezden Gelir (Bilgi Boşluğu)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Başlatmadan sonra projenizde şu dosyalar oluşturulacaktır:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 Agent rol tanımı
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 Skill iş akışı
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ Skill iş akışı
 - `speccrew-workspace/` — Çalışma alanı (iterasyon dizinleri, bilgi tabanı, doküman şablonları)
 - `.speccrewrc` — SpecCrew yapılandırma dosyası
 
@@ -213,7 +265,22 @@ Standart mühendislik iş akışını adım adım takip edin:
 
 > Her aşamanın teslim edilebilirleri bir sonraki aşamaya geçmeden önce insan onayı gerektirir.
 
-### 4. Diğer CLI Komutları
+### 4. SpecCrew'ü Güncelle
+
+SpecCrew'un yeni bir sürümü yayınlandığında, güncellemeyi iki adımda tamamlayın:
+
+```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
+```
+
+> **Not**: `npm install -g speccrew@latest` CLI aracının kendisini güncellerken, `speccrew update` projenizdeki Agent ve Skill tanım dosyalarını günceller. Tam bir güncelleme için her iki adım da gereklidir.
+
+### 5. Diğer CLI Komutları
 
 ```bash
 speccrew list       # Yüklü agent'ları ve skill'leri listele

package/README.uk.md

@@ -41,6 +41,58 @@ SpecCrew — це вбудований фреймворк віртуальної
 
 ---
 
+## ✨ Ключові особливості
+
+### 🏭 Віртуальна команда розробки
+Генерація одним кліком **7 професійних ролей Агентів** + **30+ робочих процесів Навичок**, створення повної віртуальної команди розробки:
+- **Team Leader** - Глобальне планування та управління ітераціями
+- **Product Manager** - Аналіз вимог та генерація PRD
+- **Feature Designer** - Проектування функцій + API-контракти
+- **System Designer** - Проектування систем Frontend/Backend/Mobile/Desktop
+- **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-діаграмам (use case, sequence, class diagrams)
+- Бізнес-вимоги "уточнюються поетапно", без втрати інформації
+- Результати безпосередньо придатні для розробки
+
+### 📚 Система бази знань
+Трирівнева архітектура бази знань, що гарантує, що ШІ завжди працює на основі "єдиного джерела істини":
+
+| Рівень | Каталог | Вміст | Призначення |
+|--------|---------|-------|-------------|
+| L1 Системні знання | `knowledge/techs/` | Технологічний стек, архітектура, угоди | ШІ розуміє технічні межі проекту |
+| L2 Бізнес-знання | `knowledge/bizs/` | Функції модулів, бізнес-процеси, сутності | ШІ розуміє бізнес-логіку |
+| L3 Артефакти ітерацій | `iterations/iXXX/` | PRD, проектні документи, звіти про тестування | Повний ланцюжок відстеження для поточних вимог |
+
+### 🔄 Чотириетапний конвеєр знань
+**Автоматизована архітектура генерації знань**, автоматична генерація бізнес/технічної документації з вихідного коду:
+```
+Етап 1: Сканування вихідного коду → Генерація списку модулів
+Етап 2: Паралельний аналіз → Вилучення функцій (багато Worker паралельно)
+Етап 3: Паралельне узагальнення → Завершення оглядів модулів (багато Worker паралельно)
+Етап 4: Системна агрегація → Генерація панорами системи
+```
+- Підтримує **повну синхронізацію** та **інкрементальну синхронізацію** (на основі Git diff)
+- Один оптимізує, команда використовує
+
+### 🔧 Harness Практична структура впровадження
+**Стандартизована структура виконання**, що забезпечує точне перетворення проектних документів у виконувані інструкції з розробки:
+- **Принцип операційного посібника**: Навичка — це SOP, кроки чіткі, послідовні та самодостатні
+- **Контракт введення-виведення**: Чітке визначення інтерфейсів, суворе виконання як pseudocode
+- **Архітектура прогресивного розкриття**: Шаруватезавантаження інформації, уникнення одноразового перевантаження контексту
+- **Делегування суб-Агентів**: Автоматичний поділ складних завдань, паралельне виконання гарантує якість
+
+---
+
 ## Вирішення 8 ключових проблем
 
 ### 1. ШІ ігнорує існуючу документацію проекту (розрив знань)
@@ -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, виконайте оновлення у два кроки:
+
+```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` оновлює файли визначень Агентів та Навичок у вашому проекті. Для повного оновлення необхідні обидва кроки.
+
+### 5. Інші CLI команди
 
 ```bash
 speccrew list       # Список встановлених агентів та навичок

package/README.vi.md

@@ -41,6 +41,58 @@ Bằng cách tích hợp các Agent và Skill vào các dự án hiện có, cá
 
 ---
 
+## ✨ Điểm Nổi Bật Chính
+
+### 🏭 Đội Phần Mềm Ảo
+Tạo bằng một cú nhấp chuột **7 vai trò Agent chuyên nghiệp** + **30+ quy trình Skill**, xây dựng đội phần mềm ảo hoàn chỉnh:
+- **Team Leader** - Lập kế hoạch toàn cầu và quản lý lặp lại
+- **Product Manager** - Phân tích yêu cầu và xuất PRD
+- **Feature Designer** - Thiết kế tính năng + hợp đồng API
+- **System Designer** - Thiết kế hệ thống Frontend/Backend/Mobile/Desktop
+- **System Developer** - Phát triển song song đa nền tảng
+- **Test Manager** - Điều phối kiểm thử ba giai đoạn
+- **Task Worker** - Thực thi tác vụ phụ song song
+
+### 📐 Mô hình hóa ISA-95 Sáu Giai đoạn
+Dựa trên phương pháp luận mô hình hóa quốc tế **ISA-95**, chuẩn hóa chuyển đổi yêu cầu nghiệp vụ thành hệ thống phần mềm:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Mỗi giai đoạn tương ứng với biểu đồ UML cụ thể (use case, sequence, class)
+- Yêu cầu nghiệp vụ được "tinh chế từng bước", không mất thông tin
+- Đầu ra có thể sử dụng trực tiếp cho phát triển
+
+### 📚 Hệ thống Cơ sở Kiến thức
+Kiến trúc cơ sở kiến thức ba tầng đảm bảo AI luôn làm việc dựa trên "nguồn sự thật duy nhất":
+
+| Tầng | Thư mục | Nội dung | Mục đích |
+|------|---------|----------|----------|
+| L1 Kiến thức Hệ thống | `knowledge/techs/` | Stack công nghệ, kiến trúc, quy ước | AI hiểu ranh giới kỹ thuật của dự án |
+| L2 Kiến thức Nghiệp vụ | `knowledge/bizs/` | Chức năng module, luồng nghiệp vụ, thực thể | AI hiểu logic nghiệp vụ |
+| L3 Tạo phẩm Lặp | `iterations/iXXX/` | PRD, tài liệu thiết kế, báo cáo kiểm thử | Chuỗi truy xuất đầy đủ cho yêu cầu hiện tại |
+
+### 🔄 Pipeline Kiến thức Bốn Giai đoạn
+**Kiến trúc tạo kiến thức tự động**, tự động tạo tài liệu nghiệp vụ/kỹ thuật từ mã nguồn:
+```
+Giai đoạn 1: Quét mã nguồn → Tạo danh sách module
+Giai đoạn 2: Phân tích song song → Trích xuất tính năng (nhiều Worker song song)
+Giai đoạn 3: Tóm tắt song song → Hoàn thành tổng quan module (nhiều Worker song song)
+Giai đoạn 4: Tổng hợp hệ thống → Tạo toàn cảnh hệ thống
+```
+- Hỗ trợ **đồng bộ hóa đầy đủ** và **đồng bộ hóa tăng dần** (dựa trên Git diff)
+- Một người tối ưu hóa, cả đội chia sẻ
+
+### 🔧 Harness Khung Thực chiến Triển khai
+**Khung thực thi chuẩn hóa**, đảm bảo tài liệu thiết kế được chuyển đổi chính xác thành các chỉ lệnh phát triển có thể thực thi:
+- **Nguyên tắc sổ tay vận hành**: Skill là SOP, các bước rõ ràng, liên tục và tự chứa
+- **Hợp đồng đầu vào-đầu ra**: Định nghĩa rõ ràng các giao diện, thực thi nghiêm ngặt như pseudocode
+- **Kiến trúc tiết lộ dần dần**: Tải thông tin theo lớp, tránh quá tải ngữ cảnh một lần
+- **Ủy quyền Sub-Agent**: Tự động chia nhỏ tác vụ phức tạp, thực thi song song đảm bảo chất lượng
+
+---
+
 ## Giải quyết 8 Vấn đề Cốt lõi
 
 ### 1. AI Bỏ qua Tài liệu Dự án Hiện có (Khoảng trống Kiến thức)