speccrew 0.1.11 → 0.2.0

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)

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