speccrew 0.1.12 → 0.2.1

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
 

package/docs/GETTING-STARTED.de.md

@@ -360,7 +360,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. Häufig gestellte Fragen (FAQ)
+## 6. Workflow-Fortschrittsverwaltung
+
+Das virtuelle SpecCrew-Team folgt einem strengen Stufen-Validierungsmechanismus, bei dem jede Phase vom Benutzer bestätigt werden muss, bevor zur nächsten übergegangen wird. Es unterstützt auch wiederaufnehmbare Ausführung — beim Neustart nach Unterbrechung wird automatisch dort fortgefahren, wo aufgehört wurde.
+
+### 6.1 Drei-Ebenen-Fortschrittsdateien
+
+Der Workflow verwaltet automatisch drei Arten von JSON-Fortschrittsdateien, die im Iterationsverzeichnis liegen:
+
+| Datei | Speicherort | Zweck |
+|-------|-------------|-------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Erfasst den Status jeder Pipeline-Stufe |
+| `.checkpoints.json` | Unter jedem Phasenverzeichnis | Erfasst den Benutzer-Checkpoint-Bestätigungsstatus |
+| `DISPATCH-PROGRESS.json` | Unter jedem Phasenverzeichnis | Erfasst den elementweisen Fortschritt für parallele Aufgaben (Multi-Plattform/Multi-Modul) |
+
+### 6.2 Phasenstatus-Fluss
+
+Jede Phase folgt diesem Statusfluss:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: Noch nicht gestartet
+- **in_progress**: Aktuell in Ausführung
+- **completed**: Agent-Ausführung abgeschlossen, wartet auf Benutzerbestätigung
+- **confirmed**: Vom Benutzer über finalen Checkpoint bestätigt, nächste Phase kann starten
+
+### 6.3 Wiederaufnehmbare Ausführung
+
+Beim Neustart eines Agents für eine Phase:
+
+1. **Automatische vorgelagerte Prüfung**: Überprüft, ob die vorherige Phase bestätigt ist, blockiert und informiert bei Nichtbestätigung
+2. **Checkpoint-Wiederherstellung**: Liest `.checkpoints.json`, überspringt bestandene Checkpoints, fährt ab dem letzten Unterbrechungspunkt fort
+3. **Parallele Aufgaben-Wiederherstellung**: Liest `DISPATCH-PROGRESS.json`, führt nur Aufgaben mit Status `pending` oder `failed` erneut aus, überspringt `completed` Aufgaben
+
+### 6.4 Aktuellen Fortschritt Anzeigen
+
+Den Pipeline-Panorama-Status über den Team Leader Agent anzeigen:
+
+```
+@speccrew-team-leader aktuellen Iterationsfortschritt anzeigen
+```
+
+Der Team Leader liest die Fortschrittsdateien und zeigt eine Statusübersicht ähnlich wie:
+
+```
+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 Abwärtskompatibilität
+
+Der Fortschrittsdatei-Mechanismus ist vollständig abwärtskompatibel — wenn Fortschrittsdateien nicht existieren (z.B. in Legacy-Projekten oder neuen Iterationen), führen alle Agents normal gemäß der ursprünglichen Logik aus.
+
+---
+
+## 7. Häufig gestellte Fragen (FAQ)
 
 ### Q1: Was wenn der Agent nicht wie erwartet funktioniert?
 
@@ -388,8 +448,22 @@ Jede Iteration ist vollständig isoliert und beeinflusst andere nicht.
 
 ### Q4: Wie SpecCrew-Version aktualisieren?
 
-- **Globales Update**: `npm update -g speccrew`
-- **Projekt-Update**: `speccrew update` im Projektverzeichnis ausführen
+Das Update erfolgt in zwei Schritten:
+
+```bash
+# Schritt 1: Globales CLI-Tool aktualisieren
+npm install -g speccrew@latest
+
+# Schritt 2: Agents und Skills im Projektverzeichnis synchronisieren
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: Aktualisiert das CLI-Tool selbst (neue Version kann neue Agent/Skill-Definitionen, Bugfixes usw. enthalten)
+- `speccrew update`: Synchronisiert die Agent- und Skill-Definitionsdateien im Projekt auf die neueste Version
+- `speccrew update --ide cursor`: Aktualisiert nur die Konfiguration der angegebenen IDE
+
+> **Hinweis**: Beide Schritte müssen ausgeführt werden. Nur `speccrew update` auszuführen aktualisiert nicht das CLI-Tool selbst; nur `npm install` auszuführen aktualisiert nicht die Dateien im Projekt.
 
 ### Q5: Wie historische Iterationen ansehen?
 
@@ -404,7 +478,7 @@ Neuinitialisierung ist in folgenden Situationen erforderlich:
 
 ---
 
-## 7. Kurzreferenz
+## 8. Kurzreferenz
 
 ### Agent-Start-Kurzreferenz