speccrew 0.1.12 → 0.2.1

package/README.bn.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/` | টেক স্ট্যাক, আর্কিটেকচার, কনভেনশন | AI প্রকল্পের প্রযুক্তিগত সীমানা বোঝে |
+| L2 ব্যবসায়িক জ্ঞান | `knowledge/bizs/` | মডিউল ফাংশন, ব্যবসায়িক প্রবাহ, সত্তা | AI ব্যবসায়িক যুক্তি বোঝে |
+| L3 ইটারেশন আর্টিফ্যাক্ট | `iterations/iXXX/` | PRD, ডিজাইন ডকুমেন্ট, পরীক্ষার প্রতিবেদন | বর্তমান প্রয়োজনীয়তার জন্য সম্পূর্ণ ট্রেসেবিলিটি চেইন |
+
+### 🔄 চার-পর্যায়ের জ্ঞান পাইপলাইন
+**স্বয়ংক্রিয় জ্ঞান উৎপাদন আর্কিটেকচার**, সোর্স কোড থেকে ব্যবসায়িক/প্রযুক্তিগত ডকুমেন্টেশনের স্বয়ংক্রিয় উৎপাদন:
+```
+পর্যায় 1: সোর্স কোড স্ক্যান → মডিউল তালিকা তৈরি
+পর্যায় 2: সমান্তরাল বিশ্লেষণ → বৈশিষ্ট্য বের করা (মাল্টি-ওয়ার্কার সমান্তরাল)
+পর্যায় 3: সমান্তরাল সারাংশ → মডিউল ওভারভিউ সম্পূর্ণ করা (মাল্টি-ওয়ার্কার সমান্তরাল)
+পর্যায় 4: সিস্টেম সংযোজন → সিস্টেম প্যানোরামা তৈরি
+```
+- **পূর্ণ সিঙ্কronization** এবং **ইনক্রিমেন্টাল সিঙ্কronization** সমর্থন করে (Git diff ভিত্তিক)
+- একজন ব্যক্তি অপ্টিমাইজ করে, টিম শেয়ার করে
+
+### 🔧 Harness বাস্তবায়ন কাঠামো
+**স্ট্যান্ডার্ডাইজড এক্সিকিউশন ফ্রেমওয়ার্ক**, ডিজাইন ডকুমেন্টকে নির্ভুলভাবে এক্সিকিউটেবল ডেভেলপমেন্ট নির্দেশাবলীতে রূপান্তর নিশ্চিত করে:
+- **অপারেশন ম্যানুয়াল নীতি**: Skill হল SOP, ধাপগুলি স্পষ্ট, ধারাবাহিক, স্বয়ংসম্পূর্ণ
+- **ইনপুট-আউটপুট চুক্তি**: ইন্টারফেস স্পষ্টভাবে সংজ্ঞায়িত, সিউডোকোডের মতো কঠোরভাবে কার্যকর
+- **গ্র্যাডুয়াল ডিসক্লোজার আর্কিটেকচার**: তথ্য স্তরে স্তরে লোড হয়, একবারে অত্যধিক প্রসঙ্গ এড়ায়
+- **সাব-এজেন্ট ডেলিগেশন**: জটিল কাজ স্বয়ংক্রিয়ভাবে বিভক্ত হয়, সমান্তরাল কার্যকরীকরণ গুণমান নিশ্চিত করে
+
+---
+
 ## ৮টি মূল সমস্যা সমাধান
 
 ### ১. AI বিদ্যমান প্রকল্প ডকুমেন্টেশন উপেক্ষা করে (জ্ঞান ব্যবধান)

package/README.bs.md

@@ -41,6 +41,58 @@ Integracijom Agenata i Vještina u postojeće projekte, timovi mogu brzo inicija
 
 ---
 
+## ✨ Ključne Karakteristike
+
+### 🏭 Virtuelni Softverski Tim
+Jednoklik generisanje **7 profesionalnih uloga Agenata** + **30+ tokova rada Vještina**, izgradnja kompletnog virtuelnog softverskog tima:
+- **Team Leader** - Globalno planiranje i upravljanje iteracijama
+- **Product Manager** - Analiza zahtjeva i PRD output
+- **Feature Designer** - Dizajn funkcionalnosti + API ugovori
+- **System Designer** - Dizajn sistema Frontend/Backend/Mobilni/Desktop
+- **System Developer** - Multiplatformski paralelni razvoj
+- **Test Manager** - Koordinacija testiranja u tri faze
+- **Task Worker** - Paralelno izvršavanje podzadataka
+
+### 📐 ISA-95 Šestostepeno Modeliranje
+Bazirano na međunarodnoj metodologiji modeliranja **ISA-95**, standardizacija transformacije poslovnih zahtjeva u softverske sisteme:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Svaki stepen odgovara specifičnim UML dijagramima (use case, sequence, class diagrams)
+- Poslovni zahtjevi se "pročišćavaju korak po korak", bez gubitka informacija
+- Rezultati su direktno upotrebljivi za razvoj
+
+### 📚 Sistem Baze Znanja
+Troslojna arhitektura baze znanja koja osigurava da AI uvijek radi bazirano na "jednom izvoru istine":
+
+| Sloj | Direktorij | Sadržaj | Svrha |
+|------|------------|---------|-------|
+| L1 Sistemsko Znanje | `knowledge/techs/` | Tech stack, arhitektura, konvencije | AI razumije tehničke granice projekta |
+| L2 Poslovno Znanje | `knowledge/bizs/` | Funkcionalnosti modula, poslovni tokovi, entiteti | AI razumije poslovnu logiku |
+| L3 Artefakti Iteracija | `iterations/iXXX/` | PRD, dizajn dokumenti, test izvještaji | Kompletni lanac praćenja za trenutne zahtjeve |
+
+### 🔄 Četvorostepeni Pipeline Znanja
+**Automatizovana arhitektura generisanja znanja**, automatsko generisanje poslovne/tehničke dokumentacije iz izvornog koda:
+```
+Stepen 1: Skeniranje izvornog koda → Generisanje liste modula
+Stepen 2: Paralelna analiza → Ekstrakcija funkcionalnosti (multi-Worker paralelno)
+Stepen 3: Paralelno sažimanje → Dopuna pregleda modula (multi-Worker paralelno)
+Stepen 4: Sistemska agregacija → Generisanje panorame sistema
+```
+- Podržava **potpunu sinhronizaciju** i **inkrementalnu sinhronizaciju** (bazirano na Git diff)
+- Jedna osoba optimizira, tim dijeli
+
+### 🔧 Harness Okvir za Praktičnu Implementaciju
+**Standardizovani okvir za izvršavanje**, osigurava preciznu transformaciju dizajn dokumenata u izvršne razvojne instrukcije:
+- **Princip operativnog priručnika**: Skill je SOP, koraci jasni, kontinuirani, samodovoljni
+- **Ugovor o ulazima i izlazima**: jasno definisani interfejsi, strogo izvršavanje poput pseudokoda
+- **Arhitektura postepenog otkrivanja**: informacije se učitavaju u slojevima, izbjegava preopterećenje konteksta
+- **Delegiranje sub-agenta**: kompleksni zadaci se automatski dijele, paralelno izvršavanje osigurava kvalitet
+
+---
+
 ## Rješavanje 8 ključnih problema
 
 ### 1. AI ignoriše postojeću dokumentaciju projekta (jaz u znanju)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Nakon inicijalizacije, u projektu će biti generisano:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 definicija uloga Agenata
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 tokova rada Vještina
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ tokova rada Vještina
 - `speccrew-workspace/` — Radni prostor (direktoriji iteracija, baza znanja, predlošci dokumenata)
 - `.speccrewrc` — Konfiguracioni fajl SpecCrew
 
@@ -213,7 +265,22 @@ Prati standardni inženjerski tok rada korak po korak:
 
 > Rezultati svake faze zahtijevaju ljudsku potvrdu prije prelaska na sljedeću fazu.
 
-### 4. Druge CLI komande
+### 4. Ažuriranje SpecCrew-a
+
+Kada SpecCrew objavi novu verziju, potrebne su dvije koraka za dovršetak ažuriranja:
+
+```bash
+# Step 1: 更新全局 CLI 工具到最新版本
+npm install -g speccrew@latest
+
+# Step 2: 同步项目中的 Agents 和 Skills 到最新版本
+cd /path/to/your-project
+speccrew update
+```
+
+> **Napomena**: `npm install -g speccrew@latest` ažurira sam CLI alat, dok `speccrew update` ažurira datoteke definicija Agenta i Skillova u projektu. Oba koraka su potrebna za potpuno ažuriranje.
+
+### 5. Druge CLI komande
 
 ```bash
 speccrew list       # Izlistaj instalirane agente i vještine
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer: Paralelni razvoj po platformama
 │   │   ├── speccrew-test-manager.md      # Test Manager: Koordinacija trofaznog testiranja
 │   │   └── speccrew-task-worker.md       # Task Worker: Paralelno izvršavanje podzadataka
-│   └── skills/                      # 38 Vještina (grupisanih po funkciji)
+│   └── skills/                      # 30+ Vještina (grupisanih po funkciji)
 │       ├── speccrew-pm-*/                # Upravljanje proizvodom (analiza zahtjeva, evaluacija)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, API ugovor)
 │       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)

package/README.da.md

@@ -41,6 +41,58 @@ Ved at integrere Agents og Skills i eksisterende projekter kan teams hurtigt ini
 
 ---
 
+## ✨ Nøglefunktioner
+
+### 🏭 Virtuelt Softwareteam
+Et-kliks generering af **7 professionelle Agent-roller** + **30+ Skill-workflows**, opbygning af et komplet virtuelt softwareteam:
+- **Team Leader** - Global planlægning og iterationshåndtering
+- **Product Manager** - Kravanalyse og PRD-output
+- **Feature Designer** - Feature-design + API-kontrakter
+- **System Designer** - Frontend/Backend/Mobil/Desktop-systemdesign
+- **System Developer** - Multiplatform-paralleludvikling
+- **Test Manager** - Trefaset-testkoordinering
+- **Task Worker** - Parallel underopgaveudførelse
+
+### 📐 ISA-95 Sekstrins Modellering
+Baseret på international **ISA-95** modelleringsmetodik, standardisering af transformationen fra forretningskrav til softwaresystemer:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Hvert trin svarer til specifikke UML-diagrammer (use case, sekvens, klassediagrammer)
+- Forretningskrav "forfines trin for trin" uden informationstab
+- Outputs er direkte brugbare til udvikling
+
+### 📚 Videnbase-system
+Trenivå videnbase-arkitektur, der sikrer, at AI altid arbejder baseret på "den eneste sandhedskilde":
+
+| Niveau | Bibliotek | Indhold | Formål |
+|--------|-----------|---------|--------|
+| L1 Systemviden | `knowledge/techs/` | Tech-stack, arkitektur, konventioner | AI forstår projektets tekniske grænser |
+| L2 Forretningsviden | `knowledge/bizs/` | Modulfunktioner, forretningsflows, enheder | AI forstår forretningslogik |
+| L3 Iterationsartefakter | `iterations/iXXX/` | PRD, designdokumenter, testrapporter | Komplet sporbarhedskæde for aktuelle krav |
+
+### 🔄 Firetrins Videnspipeline
+**Automatiseret vidensgenereringsarkitektur**, automatisk generering af forretnings/teknisk dokumentation fra kildekode:
+```
+Trin 1: Scan kildekode → Generer modulliste
+Trin 2: Parallel analyse → Uddrag features (multi-Worker-parallel)
+Trin 3: Parallel opsummering → Færdiggør moduloversigter (multi-Worker-parallel)
+Trin 4: Systemaggregering → Generer systempanorama
+```
+- Understøtter **fuld synkronisering** og **inkrementel synkronisering** (baseret på Git diff)
+- En person optimerer, team deler
+
+### 🔧 Harness Praktisk Implementeringsramme
+**Standardiseret eksekveringsramme**, sikrer præcis transformation af designdokumenter til eksekverbare udviklingsinstruktioner:
+- **Operationsmanual-princip**: Skill er SOP, trin er klare, kontinuerlige, selvstændige
+- **Input-output-kontrakt**: grænseflader tydeligt defineret, streng eksekvering som pseudokode
+- **Gradvis offentliggørelsesarkitektur**: information indlæses lag for lag, undgår engangskontekst-overbelastning
+- **Underagent-delegering**: komplekse opgaver opdeles automatisk, parallelt eksekvering sikrer kvalitet
+
+---
+
 ## 8 Kerne-problemer Løst
 
 ### 1. AI Ignorerer Eksisterende Projektdokumentation (Videnskløft)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Efter initialisering vil følgende blive genereret i dit projekt:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 Agent-rolledefinitioner
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 Skill-workflows
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ Skill-workflows
 - `speccrew-workspace/` — Arbejdsområde (iterationsmapper, vidensbase, dokumentskabeloner)
 - `.speccrewrc` — SpecCrew-konfigurationsfil
 
@@ -213,7 +265,22 @@ Følg standard engineering-workflow trin for trin:
 
 > Hver phases leverancer kræver menneskelig bekræftelse før fortsættelse til næste fase.
 
-### 4. Andre CLI-kommandoer
+### 4. Opdatering af SpecCrew
+
+Når SpecCrew udgiver en ny version, kræves der to trin for at fuldføre opdateringen:
+
+```bash
+# Step 1: 更新全局 CLI 工具到最新版本
+npm install -g speccrew@latest
+
+# Step 2: 同步项目中的 Agents 和 Skills 到最新版本
+cd /path/to/your-project
+speccrew update
+```
+
+> **Bemærkning**: `npm install -g speccrew@latest` opdaterer selve CLI-værktøjet, mens `speccrew update` opdaterer Agent- og Skill-definitionsfilerne i projektet. Begge trin skal udføres for at fuldføre den komplette opdatering.
+
+### 5. Andre CLI-kommandoer
 
 ```bash
 speccrew list       # List installerede agents og skills
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer: Parallelt udvikling pr. platform
 │   │   ├── speccrew-test-manager.md      # Test Manager: Tre-fase testkoordinering
 │   │   └── speccrew-task-worker.md       # Opgavemedarbejder: Parallelt underopgave-eksekvering
-│   └── skills/                      # 38 Skills (grupperet efter funktion)
+│   └── skills/                      # 30+ Skills (grupperet efter funktion)
 │       ├── speccrew-pm-*/                # Produktstyring (kravanalyse, evaluering)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, API Kontrakt)
 │       ├── speccrew-sd-*/                # System Design (frontend/backend/mobil/desktop)

package/README.de.md

@@ -41,6 +41,58 @@ Durch die Integration von Agents und Skills in bestehende Projekte können Teams
 
 ---
 
+## ✨ Hauptmerkmale
+
+### 🏭 Virtuelles Softwareteam
+Ein-Klick-Generierung von **7 professionellen Agent-Rollen** + **30+ Skill-Workflows**, Aufbau eines vollständigen virtuellen Softwareteams:
+- **Team Leader** - Globale Planung und Iterationsmanagement
+- **Product Manager** - Anforderungsanalyse und PRD-Erstellung
+- **Feature Designer** - Feature-Design + API-Verträge
+- **System Designer** - Frontend/Backend/Mobile/Desktop-Systemdesign
+- **System Developer** - Multiplattform-Parallelentwicklung
+- **Test Manager** - Dreiphasen-Testkoordination
+- **Task Worker** - Parallele Unteraufgabenausführung
+
+### 📐 ISA-95 Sechs-Stufen-Modellierung
+Basierend auf der internationalen **ISA-95** Modellierungsmethodik, Standardisierung der Transformation von Geschäftsanforderungen zu Softwaresystemen:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Jede Stufe entspricht bestimmten UML-Diagrammen (Anwendungsfälle, Sequenz, Klassendiagramme)
+- Geschäftsanforderungen werden "schrittweise verfeinert", ohne Informationsverlust
+- Ausgaben sind direkt für die Entwicklung verwendbar
+
+### 📚 Wissensdatenbank-System
+Dreischichtige Wissensdatenbank-Architektur, die sicherstellt, dass KI immer basierend auf der "einzigen Wahrheitsquelle" arbeitet:
+
+| Ebene | Verzeichnis | Inhalt | Zweck |
+|-------|-------------|---------|----------|
+| L1 Systemwissen | `knowledge/techs/` | Tech-Stack, Architektur, Konventionen | KI versteht technische Projektgrenzen |
+| L2 Geschäftswissen | `knowledge/bizs/` | Modulfeatures, Geschäftsabläufe, Entitäten | KI versteht Geschäftslogik |
+| L3 Iterationsartefakte | `iterations/iXXX/` | PRD, Design-Dokumente, Testberichte | Vollständige Rückverfolgbarkeitskette für aktuelle Anforderungen |
+
+### 🔄 Vier-Stufen-Wissenspipeline
+**Automatisierte Wissensgenerierungsarchitektur**, automatische Generierung von Geschäfts-/Technikdokumentation aus Quellcode:
+```
+Stufe 1: Quellcode scannen → Modulliste generieren
+Stufe 2: Parallele Analyse → Features extrahieren (Multi-Worker-parallel)
+Stufe 3: Parallele Zusammenfassung → Modulübersichten vervollständigen (Multi-Worker-parallel)
+Stufe 4: Systemaggregation → Systempanorama generieren
+```
+- Unterstützt **Voll-Synchronisierung** und **Inkrementelle Synchronisierung** (basierend auf Git diff)
+- Eine Person optimiert, Team teilt
+
+### 🔧 Harness Praktisches Implementierungsframework
+**Standardisiertes Ausführungsframework**, stellt sicher, dass Design-Dokumente präzise in ausführbare Entwicklungsanweisungen umgewandelt werden:
+- **Betriebsanleitungs-Prinzip**: Skill ist SOP, Schritte sind klar, fortlaufend, in sich geschlossen
+- **Input-Output-Vertrag**: Schnittstellen klar definiert, strenge Ausführung wie Pseudocode
+- **Progressive-Disclosure-Architektur**: Informationen werden schichtweise geladen, vermeidet einmalige Kontextüberlastung
+- **Sub-Agent-Delegierung**: komplexe Aufgaben werden automatisch aufgeteilt, parallele Ausführung sichert Qualität
+
+---
+
 ## 8 Kernprobleme gelöst
 
 ### 1. KI ignoriert bestehende Projektdokumentation (Wissenslücke)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Nach der Initialisierung werden in Ihrem Projekt generiert:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 Agent-Rollendefinitionen
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 Skill-Workflows
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ Skill-Workflows
 - `speccrew-workspace/` — Workspace (Iterationsverzeichnisse, Wissensbasis, Dokumentvorlagen)
 - `.speccrewrc` — SpecCrew-Konfigurationsdatei
 
@@ -213,7 +265,22 @@ Folgen Sie dem Standard-Engineering-Workflow Schritt für Schritt:
 
 > Die Liefergegenstände jeder Phase erfordern menschliche Bestätigung vor dem Fortfahren zur nächsten Phase.
 
-### 4. Andere CLI-Befehle
+### 4. SpecCrew Aktualisieren
+
+Wenn SpecCrew eine neue Version veröffentlicht, sind zwei Schritte erforderlich, um das Update abzuschließen:
+
+```bash
+# Step 1: 更新全局 CLI 工具到最新版本
+npm install -g speccrew@latest
+
+# Step 2: 同步项目中的 Agents 和 Skills 到最新版本
+cd /path/to/your-project
+speccrew update
+```
+
+> **Hinweis**: `npm install -g speccrew@latest` aktualisiert das CLI-Tool selbst, während `speccrew update` die Agent- und Skill-Definitionsdateien im Projekt aktualisiert. Beide Schritte müssen ausgeführt werden, um das vollständige Update abzuschließen.
+
+### 5. Andere CLI-Befehle
 
 ```bash
 speccrew list       # Installierte Agents und Skills auflisten
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer: Parallele Entwicklung nach Plattform
 │   │   ├── speccrew-test-manager.md      # Test Manager: Dreiphasige Testkoordination
 │   │   └── speccrew-task-worker.md       # Task Worker: Parallele Unteraufgabenausführung
-│   └── skills/                      # 38 Skills (nach Funktion gruppiert)
+│   └── skills/                      # 30+ Skills (nach Funktion gruppiert)
 │       ├── speccrew-pm-*/                # Produktmanagement (Anforderungsanalyse, Bewertung)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, API Vertrag)
 │       ├── speccrew-sd-*/                # System Design (Frontend/Backend/Mobile/Desktop)

package/README.el.md

@@ -41,6 +41,58 @@
 
 ---
 
+## ✨ Βασικά Χαρακτηριστικά
+
+### 🏭 Εικονική Ομάδα Λογισμικού
+Δημιουργία με ένα κλικ **7 επαγγελματικών ρόλων Agent** + **30+ ροών εργασίας Skills**, δημιουργία μιας πλήρους εικονικής ομάδας λογισμικού:
+- **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/` | Tech stack, αρχιτεκτονική, συμβάσεις | Η AI καταλαβαίνει τα τεχνικά όρια του έργου |
+| L2 Επιχειρηματική Γνώση | `knowledge/bizs/` | Λειτουργίες αρθρωμάτων, επιχειρηματικές ροές, οντότητες | Η AI καταλαβαίνει την επιχειρηματική λογική |
+| L3 Τεχνουργήματα Επανάληψης | `iterations/iXXX/` | PRD, έγγραφα σχεδιασμού, αναφορές δοκιμών | Πλήρης αλυσίδα ιχνηλασιμότητας για τρέχουσες απαιτήσεις |
+
+### 🔄 Αγωγός Γνώσης Τεσσάρων Σταδίων
+**Αυτοματοποιημένη αρχιτεκτονική δημιουργίας γνώσης**, αυτόματη δημιουργία επιχειρηματικής/τεχνικής τεκμηρίωσης από πηγαίο κώδικα:
+```
+Στάδιο 1: Σάρωση πηγαίου κώδικα → Δημιουργία λίστας αρθρωμάτων
+Στάδιο 2: Παράλληλη ανάλυση → Εξαγωγή λειτουργιών (πολλαπλοί Worker παράλληλα)
+Στάδιο 3: Παράλληλη σύνοψη → Ολοκλήρωση επισκοπήσεων αρθρωμάτων (πολλαπλοί Worker παράλληλα)
+Στάδιο 4: Συσσωμάτωση συστήματος → Δημιουργία πανοράματος συστήματος
+```
+- Υποστηρίζει **πλήρη συγχρονισμό** και **επαυξητικό συγχρονισμό** (βασισμένο σε Git diff)
+- Ένα άτομο βελτιστοποιεί, η ομάδα μοιράζεται
+
+### 🔧 Harness Πλαίσιο Υλοποίησης
+**Τυποποιημένο πλαίσιο εκτέλεσης**, διασφαλίζει την ακριβή μετατροπή των εγγράφων σχεδιασμού σε εκτελέσιμες οδηγίες ανάπτυξης:
+- **Αρχή εγχειριδίου λειτουργίας**: Το Skill είναι SOP, με σαφή, συνεχή και αυτοπεριεχόμενα βήματα
+- **Συμβόλαιο εισόδου/εξόδου**: Καθορισμός σαφών διεπαφών, εκτέλεση με αυστηρότητα όπως ο ψευδοκώδικας
+- **Αρχιτεκτονική σταδιακής αποκάλυψης**: Φόρτωση πληροφοριών σε επίπεδα, αποφυγή υπερφόρτωσης πλαισίου
+- **Ανάθεση σε Sub-Agent**: Αυτόματος διαχωρισμός πολύπλοκων εργασιών, παράλληλη εκτέλεση για διασφάλιση ποιότητας
+
+---
+
 ## 8 Βασικά Προβλήματα που Λύνονται
 
 ### 1. Η AI Αγνοεί την Υπάρχουσα Τεκμηρίωση Έργου (Κενό Γνώσης)

package/README.en.md

@@ -41,6 +41,58 @@ By integrating Agents and Skills into existing projects, teams can quickly initi
 
 ---
 
+## ✨ Key Highlights
+
+### 🏭 Virtual Software Team
+One-click generation of **7 professional Agent roles** + **30+ Skill workflows**, building a complete virtual software team:
+- **Team Leader** - Global scheduling and iteration management
+- **Product Manager** - Requirements analysis and PRD output
+- **Feature Designer** - Feature design + API contracts
+- **System Designer** - Frontend/Backend/Mobile/Desktop system design
+- **System Developer** - Multi-platform parallel development
+- **Test Manager** - Three-phase test coordination
+- **Task Worker** - Parallel sub-task execution
+
+### 📐 ISA-95 Six-Stage Modeling
+Based on international **ISA-95** modeling methodology, standardizing the transformation from business requirements to software systems:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Each stage corresponds to specific UML diagrams (use case, sequence, class diagrams)
+- Business requirements are "refined step by step" with no information loss
+- Outputs are directly usable for development
+
+### 📚 Knowledge Base System
+Three-tier knowledge base architecture ensuring AI always works based on the "single source of truth":
+
+| Layer | Directory | Content | Purpose |
+|-------|-----------|---------|----------|
+| L1 System Knowledge | `knowledge/techs/` | Tech stack, architecture, conventions | AI understands project technical boundaries |
+| L2 Business Knowledge | `knowledge/bizs/` | Module features, business flows, entities | AI understands business logic |
+| L3 Iteration Artifacts | `iterations/iXXX/` | PRD, design docs, test reports | Complete traceability chain for current requirements |
+
+### 🔄 Four-Stage Knowledge Pipeline
+**Automated knowledge generation architecture**, auto-generating business/technical documentation from source code:
+```
+Stage 1: Scan source code → Generate module list
+Stage 2: Parallel analysis → Extract features (multi-Worker parallel)
+Stage 3: Parallel summarization → Complete module overviews (multi-Worker parallel)
+Stage 4: System aggregation → Generate system panorama
+```
+- Supports **full sync** and **incremental sync** (based on Git diff)
+- One person optimizes, team shares
+
+### 🔧 Harness Execution Framework
+**Standardized execution framework** ensuring design documents are accurately transformed into executable development instructions:
+- **SOP Principle**: Skills as standard operating procedures—clear, continuous, self-contained steps
+- **Input/Output Contracts**: Well-defined interfaces for rigorous, pseudocode-like execution
+- **Progressive Disclosure**: Layered information architecture preventing context overload
+- **Sub-Agent Dispatch**: Automatic task decomposition with parallel execution for quality assurance
+
+---
+
 ## 8 Core Problems Solved
 
 ### 1. AI Ignores Existing Project Documentation (Knowledge Gap)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 After initialization, the following will be generated in your project:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 Agent role definitions
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 Skill workflows
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ Skill workflows
 - `speccrew-workspace/` — Workspace (iteration directories, knowledge base, document templates)
 - `.speccrewrc` — SpecCrew configuration file
 
@@ -213,7 +265,22 @@ Follow the standard engineering workflow step by step:
 
 > Each phase's deliverables require human confirmation before proceeding to the next phase.
 
-### 4. Other CLI Commands
+### 4. Update SpecCrew
+
+When a new version of SpecCrew is released, complete the update in two steps:
+
+```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
+```
+
+> **Note**: `npm install -g speccrew@latest` updates the CLI tool itself, while `speccrew update` updates the Agent and Skill definition files in your project. Both steps are required for a complete update.
+
+### 5. Other CLI Commands
 
 ```bash
 speccrew list       # List installed agents and skills

package/README.es.md

@@ -41,6 +41,58 @@ Al integrar Agentes y Skills en proyectos existentes, los equipos pueden inicial
 
 ---
 
+## ✨ Características Principales
+
+### 🏭 Equipo de Software Virtual
+Generación con un clic de **7 roles de Agentes profesionales** + **30+ flujos de trabajo de Skills**, construyendo un equipo de software virtual completo:
+- **Team Leader** - Planificación global y gestión de iteraciones
+- **Product Manager** - Análisis de requisitos y generación de PRD
+- **Feature Designer** - Diseño de funciones + contratos API
+- **System Designer** - Diseño de sistemas Frontend/Backend/Móvil/Escritorio
+- **System Developer** - Desarrollo paralelo multiplataforma
+- **Test Manager** - Coordinación de pruebas en tres fases
+- **Task Worker** - Ejecución paralela de subtareas
+
+### 📐 Modelado ISA-95 de Seis Etapas
+Basado en la metodología de modelado **ISA-95** estándar internacional, estandarizando la transformación de requisitos de negocio a sistemas de software:
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- Cada etapa corresponde a diagramas UML específicos (casos de uso, secuencia, clases)
+- Los requisitos de negocio se "refinan paso a paso", sin pérdida de información
+- Los resultados son directamente utilizables para el desarrollo
+
+### 📚 Sistema de Base de Conocimientos
+Arquitectura de base de conocimientos de tres niveles que asegura que la IA siempre trabaje basada en la "fuente única de verdad":
+
+| Nivel | Directorio | Contenido | Propósito |
+|-------|------------|-----------|-----------|
+| L1 Conocimiento del Sistema | `knowledge/techs/` | Stack tecnológico, arquitectura, convenciones | IA entiende límites técnicos del proyecto |
+| L2 Conocimiento de Negocio | `knowledge/bizs/` | Funciones de módulos, flujos de negocio, entidades | IA entiende lógica de negocio |
+| L3 Artefactos de Iteración | `iterations/iXXX/` | PRD, documentos de diseño, informes de prueba | Cadena completa de trazabilidad para requisitos actuales |
+
+### 🔄 Pipeline de Conocimientos de Cuatro Etapas
+**Arquitectura de generación automatizada de conocimientos**, generando automáticamente documentación de negocio/técnica desde código fuente:
+```
+Etapa 1: Escanear código fuente → Generar lista de módulos
+Etapa 2: Análisis paralelo → Extraer funciones (multi-Worker paralelo)
+Etapa 3: Resumen paralelo → Completar vistas de módulos (multi-Worker paralelo)
+Etapa 4: Agregación del sistema → Generar panorama del sistema
+```
+- Soporta **sincronización completa** e **sincronización incremental** (basado en Git diff)
+- Una persona optimiza, el equipo comparte
+
+### 🔧 Harness Marco de Implementación Práctica
+**Marco de ejecución estandarizado**, asegura que los documentos de diseño se transformen con precisión en instrucciones de desarrollo ejecutables:
+- **Principio del manual de operaciones**: Skill como SOP, pasos claros, continuos y autocontenidos
+- **Contrato de entrada/salida**: Definición clara de interfaces, ejecución rigurosa como pseudocódigo
+- **Arquitectura de revelación progresiva**: Carga de información en capas, evitando sobrecarga de contexto
+- **Delegación de Sub-Agent**: División automática de tareas complejas, ejecución paralela para asegurar calidad
+
+---
+
 ## 8 Problemas Principales Resueltos
 
 ### 1. La IA Ignora la Documentación Existente del Proyecto (Brecha de Conocimiento)
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 Después de la inicialización, se generarán en su proyecto:
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 definiciones de roles Agent
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 flujos de trabajo Skill
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ flujos de trabajo Skill
 - `speccrew-workspace/` — Espacio de trabajo (directorios de iteración, base de conocimientos, plantillas de documentos)
 - `.speccrewrc` — Archivo de configuración de SpecCrew
 
@@ -213,7 +265,22 @@ Siga el flujo de trabajo de ingeniería estándar paso a paso:
 
 > Los entregables de cada fase requieren confirmación humana antes de proceder a la siguiente fase.
 
-### 4. Otros Comandos CLI
+### 4. Actualizar SpecCrew
+
+Cuando SpecCrew lanza una nueva versión, se requieren dos pasos para completar la actualización:
+
+```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` actualiza la herramienta CLI en sí, mientras que `speccrew update` actualiza los archivos de definición de Agent y Skill en el proyecto. Ambos pasos deben ejecutarse para completar la actualización completa.
+
+### 5. Otros Comandos CLI
 
 ```bash
 speccrew list       # Listar agents y skills instalados
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # System Developer: Desarrollo paralelo por plataforma
 │   │   ├── speccrew-test-manager.md      # Test Manager: Coordinación de pruebas de tres fases
 │   │   └── speccrew-task-worker.md       # Task Worker: Ejecución paralela de subtareas
-│   └── skills/                      # 38 Skills (agrupados por función)
+│   └── skills/                      # 30+ Skills (agrupados por función)
 │       ├── speccrew-pm-*/                # Gestión de Producto (análisis de requisitos, evaluación)
 │       ├── speccrew-fd-*/                # Feature Design (Feature Design, Contrato API)
 │       ├── speccrew-sd-*/                # System Design (frontend/backend/móvil/escritorio)