speccrew 0.1.11 → 0.2.0

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)

package/README.zh-TW.md

@@ -41,6 +41,58 @@ SpecCrew 是一套嵌入式的虛擬 AI 開發團隊框架。它將專業的軟
 
 ---
 
+## ✨ 核心亮點
+
+### 🏭 虛擬軟體團隊
+一鍵生成 **7 個專業 Agent 角色** + **30+ 個 Skill 工作流**，構建完整虛擬軟體團隊：
+- **Team Leader** - 全域排程與迭代管理
+- **Product Manager** - 需求分析與 PRD 輸出
+- **Feature Designer** - 功能設計 + API 契約
+- **System Designer** - 前端/後端/行動端/桌面端系統設計
+- **System Developer** - 多端並行開發
+- **Test Manager** - 三階段測試協調
+- **Task Worker** - 子任務並行執行
+
+### 📐 ISA-95 六段式建模
+基於國際標準 **ISA-95** 建模方法論，實現業務需求到軟體系統的標準化轉化：
+```
+Domain Descriptions → Functions in Domains → Functions of Interest
+     ↓                       ↓                      ↓
+Information Flows → Categories of Information → Information Descriptions
+```
+- 每個階段對應明確的 UML 圖（用例圖、序列圖、類圖等）
+- 業務需求「逐級細化」，無資訊丢失
+- 輸出物可直接用於開發
+
+### 📚 知識庫體系
+三層次知識庫架構，確保 AI 始終基於「事實來源」工作：
+
+| 層級 | 目錄 | 內容 | 作用 |
+|------|------|------|------|
+| L1 系統知識 | `knowledge/techs/` | 技術棧、架構、開發規約 | AI 理解專案技術邊界 |
+| L2 業務知識 | `knowledge/bizs/` | 模組功能、業務流程、實體關係 | AI 理解業務邏輯 |
+| L3 迭代產物 | `iterations/iXXX/` | PRD、設計文檔、測試報告 | 當前需求完整追溯鏈 |
+
+### 🔄 四階段知識流水線
+**自動化知識生成架構**，從原始碼自動生成業務/技術文檔：
+```
+Stage 1: 掃描原始碼 → 生成模組清單
+Stage 2: 並行分析 → 提取功能特性（多 Worker 並行）
+Stage 3: 並行匯總 → 完善模組概覽（多 Worker 並行）
+Stage 4: 系統聚合 → 生成系統全景圖
+```
+- 支援 **全量同步** 和 **增量同步**（基於 Git diff）
+- 一人優化，團隊共享
+
+### 🔧 Harness 實戰落地框架
+**標準化執行框架**，確保設計文檔精準轉化為可執行的開發指令：
+- **操作手冊原則**：Skill 即 SOP，步驟清晰、連續、自包含
+- **輸入輸出契約**：明確定義介面，像偽代碼一樣嚴謹執行
+- **逐級披露架構**：資訊分層載入，避免一次性上下文過載
+- **子 Agent 委派**：複雜任務自動拆分，並行執行確保品質
+
+---
+
 ## 解決 8 個核心問題
 
 ### 1. AI 忽略現有專案文檔（知識斷層）
@@ -189,7 +241,7 @@ speccrew init --ide claude
 
 初始化完成後，專案中會生成：
 - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 個 Agent 角色定義
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 個 Skill 工作流
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ 個 Skill 工作流
 - `speccrew-workspace/` — 工作區（迭代目錄、知識庫、文檔模板）
 - `.speccrewrc` — SpecCrew 配置檔案
 
@@ -213,7 +265,22 @@ speccrew update --ide claude
 
 > 每個階段產出物需人工確認後方可進入下一階段。
 
-### 4. 其他 CLI 命令
+### 4. 更新 SpecCrew
+
+當 SpecCrew 發布新版本時，請分兩步完成更新：
+
+```bash
+# Step 1: 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       # 列出已安裝的 agents 和 skills
@@ -239,7 +306,7 @@ your-project/
 │   │   ├── speccrew-system-developer.md  # 系統開發者：按端並行開發
 │   │   ├── speccrew-test-manager.md      # 測試管理員：三階段測試協調
 │   │   └── speccrew-task-worker.md       # 任務工人：並行子任務執行
-│   └── skills/                      # 38 個 Skill（按職能分組）
+│   └── skills/                      # 30+ 個 Skill（按職能分組）
 │       ├── speccrew-pm-*/                # 產品管理（需求分析、需求評估）
 │       ├── speccrew-fd-*/                # 功能設計（Feature Design、API 契約）
 │       ├── speccrew-sd-*/                # 系統設計（前端/後端/移動端/桌面端）

package/docs/GETTING-STARTED.ar.md

@@ -362,7 +362,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. الأسئلة الشائعة (FAQ)
+## 6. إدارة تقدم سير العمل
+
+يتبع الفريق الافتراضي SpecCrew آلية بوابة مرحلية صارمة حيث يجب تأكيد كل مرحلة من قبل المستخدم قبل المتابعة إلى المرحلة التالية. كما يدعم التنفيذ القابل للاستئناف — عند إعادة التشغيل بعد الانقطاع، يستمر تلقائياً من حيث توقف.
+
+### 6.1 ملفات التقدم ثلاثية الطبقات
+
+يحافظ سير العمل تلقائياً على ثلاثة أنواع من ملفات تقدم JSON، موجودة في دليل التكرار:
+
+| الملف | الموقع | الغرض |
+|-------|--------|--------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | يسجل حالة كل مرحلة من مراحل خط الأنابيب |
+| `.checkpoints.json` | تحت كل دليل مرحلة | يسجل حالة تأكيد نقطة التحقق من المستخدم |
+| `DISPATCH-PROGRESS.json` | تحت كل دليل مرحلة | يسجل التقدم بند لكل بند للمهام المتوازية (متعددة المنصات/الوحدات) |
+
+### 6.2 تدفق حالة المرحلة
+
+تتبع كل مرحلة تدفق الحالة هذا:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: لم يبدأ بعد
+- **in_progress**: قيد التنفيذ حالياً
+- **completed**: اكتمل تنفيذ الوكيل، في انتظار تأكيد المستخدم
+- **confirmed**: أكد المستخدم عبر نقطة التحقق النهائية، يمكن بدء المرحلة التالية
+
+### 6.3 التنفيذ القابل للاستئناف
+
+عند إعادة تشغيل وكيل لمرحلة:
+
+1. **التحقق التلقائي من المنبع**: يتحقق مما إذا كانت المرحلة السابقة مؤكدة، ويحظر ويطالب إذا لم تكن كذلك
+2. **استعادة نقطة التحقق**: يقرأ `.checkpoints.json`، يتخطى نقاط التحقق المتجاوزة، يستمر من نقطة الانقطاع الأخيرة
+3. **استعادة المهمة المتوازية**: يقرأ `DISPATCH-PROGRESS.json`، يعيد تنفيذ المهام ذات الحالة `pending` أو `failed` فقط، يتخطى المهام `completed`
+
+### 6.4 عرض التقدم الحالي
+
+عرض حالة بانوراما خط الأنابيب عبر وكيل قائد الفريق:
+
+```
+@speccrew-team-leader عرض تقدم التكرار الحالي
+```
+
+سيقرأ قائد الفريق ملفات التقدم ويعرض نظرة عامة على الحالة مشابهة لـ:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Confirmed
+  02 Feature Design: 🔄 In Progress (Checkpoint A passed)
+  03 System Design:  ⏳ Pending
+  04 Development:    ⏳ Pending
+  05 System Test:    ⏳ Pending
+```
+
+### 6.5 التوافق العكسي
+
+آلية ملفات التقدم متوافقة تماماً مع الإصدارات السابقة — إذا لم تكن ملفات التقدم موجودة (مثلاً في المشاريع القديمة أو التكرارات الجديدة)، سيقوم جميع الوكلاء بالتنفيذ بشكل طبيعي وفقاً للمنطق الأصلي.
+
+---
+
+## 7. الأسئلة الشائعة (FAQ)
 
 ### س1: ماذا أفعل إذا لم يعمل الوكيل كما هو متوقع؟
 
@@ -390,8 +450,22 @@ iterations/
 
 ### س4: كيفية تحديث إصدار SpecCrew؟
 
-- **التحديث العالمي**: `npm update -g speccrew`
-- **تحديث المشروع**: قم بتشغيل `speccrew update` في دليل المشروع
+يتم التحديث على خطوتين:
+
+```bash
+# الخطوة 1: تحديث أداة CLI العامة
+npm install -g speccrew@latest
+
+# الخطوة 2: مزامنة Agents و Skills في دليل المشروع
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: تحديث أداة CLI نفسها (قد تحتوي النسخة الجديدة على تعريفات Agent/Skill جديدة، إصلاحات أخطاء، إلخ)
+- `speccrew update`: مزامنة ملفات تعريف Agent و Skill في المشروع إلى أحدث إصدار
+- `speccrew update --ide cursor`: تحديث تكوين IDE المحدد فقط
+
+> **ملاحظة**: يجب تنفيذ الخطوتين. تنفيذ `speccrew update` فقط لن يحدث أداة CLI نفسها؛ وتنفيذ `npm install` فقط لن يحدث الملفات في المشروع.
 
 ### س5: كيفية عرض التكرارات التاريخية؟
 
@@ -406,7 +480,7 @@ iterations/
 
 ---
 
-## 7. مرجع سريع
+## 8. مرجع سريع
 
 ### مرجع سريع لبدء الوكلاء
 

package/docs/GETTING-STARTED.bn.md

@@ -361,7 +361,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. প্রায়শই জিজ্ঞাসিত প্রশ্ন (FAQ)
+## 6. ওয়ার্কফ্লো প্রগ্রেস ম্যানেজমেন্ট
+
+SpecCrew ভার্চুয়াল টিম একটি কঠোর স্টেজ-গেটিং মেকানিজম অনুসরণ করে যেখানে প্রতিটি ধাপ অবশ্যই ব্যবহারকারীর দ্বারা নিশ্চিত হতে হবে পরবর্তী ধাপে যাওয়ার আগে। এটি পুনরায় শুরু করার যোগ্য এক্সিকিউশনও সমর্থন করে — বাধার পরে পুনরায় শুরু করলে, এটি স্বয়ংক্রিয়ভাবে যেখানে থেমেছিল সেখান থেকে চালিয়ে যায়।
+
+### 6.1 তিন-স্তরের প্রগ্রেস ফাইল
+
+ওয়ার্কফ্লো স্বয়ংক্রিয়ভাবে তিন ধরনের JSON প্রগ্রেস ফাইল বজায় রাখে, যা ইটারেশন ডিরেক্টরিতে অবস্থিত:
+
+| ফাইল | অবস্থান | উদ্দেশ্য |
+|------|----------|----------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | প্রতিটি পাইপলাইন ধাপের অবস্থা রেকর্ড করে |
+| `.checkpoints.json` | প্রতিটি ধাপ ডিরেক্টরির অধীনে | ব্যবহারকারী চেকপয়েন্ট নিশ্চিতকরণ অবস্থা রেকর্ড করে |
+| `DISPATCH-PROGRESS.json` | প্রতিটি ধাপ ডিরেক্টরির অধীনে | সমান্তরাল কাজের জন্য আইটেম-বাই-আইটেম প্রগ্রেস রেকর্ড করে (বহু-প্ল্যাটফর্ম/বহু-মডিউল) |
+
+### 6.2 ধাপ অবস্থা প্রবাহ
+
+প্রতিটি ধাপ এই অবস্থা প্রবাহ অনুসরণ করে:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: এখনো শুরু হয়নি
+- **in_progress**: বর্তমানে এক্সিকিউট হচ্ছে
+- **completed**: এজেন্ট এক্সিকিউশন সম্পন্ন, ব্যবহারকারীর নিশ্চিতকরণের অপেক্ষায়
+- **confirmed**: ব্যবহারকারী চূড়ান্ত চেকপয়েন্টের মাধ্যমে নিশ্চিত করেছে, পরবর্তী ধাপ শুরু হতে পারে
+
+### 6.3 পুনরায় শুরু করার যোগ্য এক্সিকিউশন
+
+একটি ধাপের জন্য এজেন্ট পুনরায় শুরু করার সময়:
+
+1. **স্বয়ংক্রিয় আপস্ট্রিম চেক**: পূর্ববর্তী ধাপ নিশ্চিত কিনা যাচাই করে, না হলে ব্লক করে এবং অনুরোধ করে
+2. **চেকপয়েন্ট পুনরুদ্ধার**: `.checkpoints.json` পড়ে, অতিক্রান্ত চেকপয়েন্টগুলি এড়িয়ে যায়, শেষ বাধার বিন্দু থেকে চালিয়ে যায়
+3. **সমান্তরাল কাজ পুনরুদ্ধার**: `DISPATCH-PROGRESS.json` পড়ে, শুধুমাত্র `pending` বা `failed` অবস্থার কাজগুলি পুনরায় এক্সিকিউট করে, `completed` কাজগুলি এড়িয়ে যায়
+
+### 6.4 বর্তমান প্রগ্রেস দেখুন
+
+টিম লিডার এজেন্টের মাধ্যমে পাইপলাইন প্যানোরামা অবস্থা দেখুন:
+
+```
+@speccrew-team-leader বর্তমান ইটারেশন প্রগ্রেস দেখুন
+```
+
+টিম লিডার প্রগ্রেস ফাইলগুলি পড়বে এবং অনুরূপ একটি অবস্থা ওভারভিউ দেখাবে:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Confirmed
+  02 Feature Design: 🔄 In Progress (Checkpoint A passed)
+  03 System Design:  ⏳ Pending
+  04 Development:    ⏳ Pending
+  05 System Test:    ⏳ Pending
+```
+
+### 6.5 পশ্চাদগামী সামঞ্জস্যতা
+
+প্রগ্রেস ফাইল মেকানিজম সম্পূর্ণরূপে পশ্চাদগামী সামঞ্জস্যপূর্ণ — যদি প্রগ্রেস ফাইলগুলি বিদ্যমান না থাকে (যেমন, পুরানো প্রকল্পে বা নতুন ইটারেশনে), সমস্ত এজেন্ট মূল যুক্তি অনুযায়ী স্বাভাবিকভাবে এক্সিকিউট করবে।
+
+---
+
+## 7. প্রায়শই জিজ্ঞাসিত প্রশ্ন (FAQ)
 
 ### প্র১: এজেন্ট প্রত্যাশিতভাবে কাজ না করলে কী করবেন?
 
@@ -389,8 +449,22 @@ iterations/
 
 ### প্র৪: SpecCrew সংস্করণ কীভাবে আপডেট করবেন?
 
-- **গ্লোবাল আপডেট**: `npm update -g speccrew`
-- **প্রজেক্ট আপডেট**: প্রজেক্ট ডিরেক্টরিতে `speccrew update` চালান
+আপডেট দুটি ধাপে সম্পন্ন হয়:
+
+```bash
+# ধাপ ১: গ্লোবাল CLI টুল আপডেট করুন
+npm install -g speccrew@latest
+
+# ধাপ ২: প্রজেক্ট ডিরেক্টরিতে Agents এবং Skills সিঙ্ক করুন
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: CLI টুল নিজেই আপডেট করে (নতুন সংস্করণে নতুন Agent/Skill সংজ্ঞা, বাগ ফিক্স ইত্যাদি থাকতে পারে)
+- `speccrew update`: প্রজেক্টের Agent এবং Skill সংজ্ঞা ফাইলগুলি সর্বশেষ সংস্করণে সিঙ্ক করে
+- `speccrew update --ide cursor`: শুধুমাত্র নির্দিষ্ট IDE এর কনফিগারেশন আপডেট করে
+
+> **নোট**: উভয় ধাপই সম্পাদন করতে হবে। শুধুমাত্র `speccrew update` চালালে CLI টুল আপডেট হবে না; শুধুমাত্র `npm install` চালালে প্রজেক্টের ফাইলগুলি আপডেট হবে না।
 
 ### প্র৫: ঐতিহাসিক ইটারেশন কীভাবে দেখবেন?
 
@@ -405,7 +479,7 @@ iterations/
 
 ---
 
-## 7. দ্রুত রেফারেন্স
+## 8. দ্রুত রেফারেন্স
 
 ### এজেন্ট শুরু করার দ্রুত রেফারেন্স
 

package/docs/GETTING-STARTED.bs.md

@@ -361,7 +361,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. Često Postavljana Pitanja (FAQ)
+## 6. Upravljanje Napretkom Radnog Toka
+
+Virtuelni tim SpecCrew slijedi strog mehanizam faznih kapija, gdje svaka faza mora biti potvrđena od strane korisnika prije prelaska na sljedeću. Takođe podržava nastavljivu izvršnost — kada se ponovo pokrene nakon prekida, automatski nastavlja odakle je stao.
+
+### 6.1 Trostruki Fajlovi Napretka
+
+Radni tok automatski održava tri tipa JSON fajlova napretka, lociranih u direktoriju iteracije:
+
+| Fajl | Lokacija | Svrha |
+|------|----------|---------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Bilježi status svake faze pipeline-a |
+| `.checkpoints.json` | Ispod svakog direktorija faze | Bilježi status korisničke potvrde kontrolnih tačaka |
+| `DISPATCH-PROGRESS.json` | Ispod svakog direktorija faze | Bilježi napredak tačka-po-tačka za paralelne zadatke (multi-platforma/multi-modul) |
+
+### 6.2 Tok Statusa Faze
+
+Svaka faza slijedi ovaj tok statusa:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: Još nije započeto
+- **in_progress**: Trenutno se izvršava
+- **completed**: Izvršavanje Agenta završeno, čeka se korisnička potvrda
+- **confirmed**: Korisnik potvrdio kroz konačnu kontrolnu tačku, sljedeća faza može započeti
+
+### 6.3 Nastavljiva Izvršnost
+
+Kada se Agent ponovo pokrene za fazu:
+
+1. **Automatska uzvodna provjera**: Verificira da li je prethodna faza potvrđena, blokira i obavještava ako nije
+2. **Oporavak kontrolnih tačaka**: Čita `.checkpoints.json`, preskače prođene kontrolne tačke, nastavlja od posljednje tačke prekida
+3. **Oporavak paralelnih zadataka**: Čita `DISPATCH-PROGRESS.json`, ponovo izvršava samo zadatke sa `pending` ili `failed` statusom, preskače `completed` zadatke
+
+### 6.4 Pregled Trenutnog Napretka
+
+Prikaži status panorame pipeline-a kroz Team Leader Agent:
+
+```
+@speccrew-team-leader prikaži trenutni napredak iteracije
+```
+
+Team Leader će pročitati fajlove napretka i prikazati pregled statusa sličan:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Potvrđeno
+  02 Feature Design: 🔄 U toku (Kontrolna tačka A prođena)
+  03 System Design:  ⏳ Na čekanju
+  04 Development:    ⏳ Na čekanju
+  05 System Test:    ⏳ Na čekanju
+```
+
+### 6.5 Unazad Kompatibilnost
+
+Mehanizam fajlova napretka je potpuno unazad kompatibilan — ako fajlovi napretka ne postoje (npr. u starijim projektima ili novim iteracijama), svi Agenti će se normalno izvršavati u skladu sa originalnom logikom.
+
+---
+
+## 7. Često Postavljana Pitanja (FAQ)
 
 ### P1: Šta uraditi ako Agent ne radi kako se očekuje?
 
@@ -389,8 +449,22 @@ Svaka iteracija je potpuno izolirana i ne utiče na druge.
 
 ### P4: Kako ažurirati verziju SpecCrew?
 
-- **Globalno Ažuriranje**: `npm update -g speccrew`
-- **Ažuriranje Projekta**: Pokrenite `speccrew update` u direktoriju projekta
+Ažuriranje se vrši u dva koraka:
+
+```bash
+# Korak 1: Ažurirajte globalni CLI alat
+npm install -g speccrew@latest
+
+# Korak 2: Sinhronizirajte Agente i Skill-ove u direktoriju projekta
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: Ažurira sam CLI alat (nova verzija može sadržavati nove definicije Agent/Skill, ispravke bugova, itd.)
+- `speccrew update`: Sinhronizira datoteke definicija Agenta i Skilla u projektu na najnoviju verziju
+- `speccrew update --ide cursor`: Ažurira samo konfiguraciju navedenog IDE-a
+
+> **Napomena**: Obje korake treba izvršiti. Samo izvršavanje `speccrew update` neće ažurirati sam CLI alat; samo izvršavanje `npm install` neće ažurirati datoteke u projektu.
 
 ### P5: Kako pogledati historijske iteracije?
 
@@ -405,7 +479,7 @@ Ponovna inicijalizacija je potrebna u sljedećim situacijama:
 
 ---
 
-## 7. Brza Referenca
+## 8. Brza Referenca
 
 ### Brza Referenca Pokretanja Agenata
 

package/docs/GETTING-STARTED.da.md

@@ -360,7 +360,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. Ofte Stillede Spørgsmål (FAQ)
+## 6. Arbejdsgangsforløbsstyring
+
+Det virtuelle SpecCrew-team følger en streng fase-gate-mekanisme, hvor hver fase skal bekræftes af brugeren før der fortsættes til den næste. Det understøtter også genoptagelig udførelse — når det genstartes efter afbrydelse, fortsætter det automatisk fra hvor det slap.
+
+### 6.1 Tremedlagsforløbsfiler
+
+Arbejdsgangen vedligeholder automatisk tre typer JSON-forløbsfiler, placeret i iterationsmappen:
+
+| Fil | Placering | Formål |
+|------|----------|---------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Registrerer status for hver pipeline-fase |
+| `.checkpoints.json` | Under hver fasemappe | Registrerer brugerens checkpoint-bekræftelsesstatus |
+| `DISPATCH-PROGRESS.json` | Under hver fasemappe | Registrerer punkt-for-punkt forløb for parallelle opgaver (multi-platform/multi-modul) |
+
+### 6.2 Fasestatusforløb
+
+Hver fase følger dette statusforløb:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: Ikke startet endnu
+- **in_progress**: Udføres i øjeblikket
+- **completed**: Agent-udførelse afsluttet, venter på brugerbekræftelse
+- **confirmed**: Bruger bekræftet gennem sidste checkpoint, næste fase kan starte
+
+### 6.3 Genoptagelig Udførelse
+
+Når en Agent genstartes for en fase:
+
+1. **Automatisk opstrømskontrol**: Verificerer om den forrige fase er bekræftet, blokerer og informerer hvis ikke
+2. **Checkpoint-gendannelse**: Læser `.checkpoints.json`, springer over passerede checkpoints, fortsætter fra det sidste afbrydelsespunkt
+3. **Parallel opgavegendannelse**: Læser `DISPATCH-PROGRESS.json`, udfører kun opgaver med `pending` eller `failed` status igen, springer over `completed` opgaver
+
+### 6.4 Vis Nuværende Forløb
+
+Vis pipeline-panorama-status gennem Team Leader Agent:
+
+```
+@speccrew-team-leader vis nuværende iterationsforløb
+```
+
+Team Leader vil læse forløbsfilerne og vise en statusoversigt svarende til:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Bekræftet
+  02 Feature Design: 🔄 I gang (Checkpoint A passeret)
+  03 System Design:  ⏳ Afventer
+  04 Development:    ⏳ Afventer
+  05 System Test:    ⏳ Afventer
+```
+
+### 6.5 Bagudkompatibilitet
+
+Forløbsfilms-mekanismen er fuldt bagudkompatibel — hvis forløbsfiler ikke findes (f.eks. i ældre projekter eller nye iterationer), vil alle Agenter udføre normalt i henhold til den oprindelige logik.
+
+---
+
+## 7. Ofte Stillede Spørgsmål (FAQ)
 
 ### Q1: Hvad hvis agenten ikke fungerer som forventet?
 
@@ -388,8 +448,22 @@ Hver iteration er fuldstændig isoleret og påvirker ikke hinanden.
 
 ### Q4: Hvordan opdateres SpecCrew-versionen?
 
-- **Global opdatering**: `npm update -g speccrew`
-- **Projekt opdatering**: Kør `speccrew update` i projektmappe
+Opdatering sker i to trin:
+
+```bash
+# Trin 1: Opdater det globale CLI-værktøj
+npm install -g speccrew@latest
+
+# Trin 2: Synkroniser Agenter og Skills i projektbiblioteket
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: Opdaterer selve CLI-værktøjet (ny version kan indeholde nye Agent/Skill-definitioner, fejlrettelser osv.)
+- `speccrew update`: Synkroniserer projektets Agent- og Skill-definitionsfilér til den nyeste version
+- `speccrew update --ide cursor`: Opdaterer kun konfigurationen for det angivne IDE
+
+> **Bemærk**: Begge trin skal udføres. Kun at køre `speccrew update` opdaterer ikke selve CLI-værktøjet; kun at køre `npm install` opdaterer ikke filerne i projektet.
 
 ### Q5: Hvordan vises historiske iterationer?
 
@@ -404,7 +478,7 @@ Følgende situationer kræver re-initialisering:
 
 ---
 
-## 7. Hurtigreference
+## 8. Hurtigreference
 
 ### Agent Start Hurtigreferencetabel