kenaz 0.0.0-stage → 0.3.2

package/core/.system/pipeline/README.md

@@ -0,0 +1,712 @@
+# Pipeline System - 舊任務系統 ⚠️ LEGACY
+
+> **專案位置**: `dev/pipeline/`
+> **系統類型**: 傳統任務管理系統（JSON + YAML）
+> **適用場景**: Multi-Agent 並行開發、排程自動化
+> **狀態**: ⚠️ **Legacy System**（相容支援，逐步淘汰）
+
+---
+
+## ⚠️ Legacy System 說明
+
+**此系統處於遷移階段，建議新開發使用 `.collaboration/` 新任務系統。**
+
+### 系統狀態
+
+| 狀態 | 說明 |
+|------|------|
+| ⚠️ **Legacy** | 傳統系統，保留供排程器與 Multi-Agent 並行開發使用 |
+| ✅ **相容支援** | 目前仍可使用，但功能凍結，不再新增特性 |
+| 🔄 **逐步淘汰** | 未來將全面遷移到 `.collaboration/` 新系統 |
+
+### 何時使用此系統
+
+| 場景 | 使用此系統 | 使用新系統 |
+|------|-----------|-----------|
+| **自動化排程** | ✅ 是 | ❌ 否（功能未完整） |
+| **Multi-Agent 並行開發** | ✅ 是（支援路徑鎖定） | ❌ 否（無衝突檢測） |
+| **手動協作流程** | ⚠️ 可以（但不推薦） | ✅ 是（更簡單） |
+| **簡單任務流程** | ⚠️ 可以（但過重） | ✅ 是（更輕量） |
+
+### 遷移指引
+
+**新開發建議**：
+- ✅ 手動協作、簡單任務 → 使用 [`.collaboration/` 新系統](../.system/collaboration/README.md)
+- ⚠️ 自動化排程、並行開發 → 暫時使用此系統（待新系統功能補齊後遷移）
+
+**查詢任務時必須兩邊都查**：
+```bash
+# 新系統查詢
+node .collaboration/core/task-api.js get TASK_XXX
+
+# 舊系統查詢
+cat dev/pipeline/TASK_QUEUE.json
+ls dev/pipeline/completed/TASK_XXX_*.yaml
+```
+
+**遷移工具**：
+```bash
+# 新系統 → 舊系統（JSON 匯出供排程器使用）
+node .collaboration/core/migrate-legacy.js export
+
+# 舊系統 → 新系統（未來全面遷移時使用）
+node .collaboration/core/migrate-legacy.js import
+```
+
+**相關文檔**：
+- 新系統完整文檔：[`.system/collaboration/README.md`](../collaboration/README.md)
+- 新舊系統差異對照：[`.system/collaboration/README.md#詳細差異對照`](../collaboration/README.md#詳細差異對照)
+- 遷移路線圖：[`.system/collaboration/README.md#遷移方向`](../collaboration/README.md#遷移方向)
+
+---
+
+## 📋 系統概述
+
+Pipeline 系統是 Kenaz AI 的傳統任務管理系統，使用 **JSON 索引 + YAML 任務卡** 的雙軌制設計，支援多 Agent 並行開發與依賴管理。
+
+### 與新系統的對比
+
+| 特性 | Pipeline System（舊） | Collaboration System（新） |
+|------|---------------------|--------------------------|
+| **任務格式** | JSON 索引 + YAML 檔案 | YAML + 目錄即狀態 |
+| **狀態管理** | TASK_QUEUE.json 集中式 | 目錄結構分散式 |
+| **適用場景** | 排程器、Multi-Agent | 手動協作、簡單流程 |
+| **Python 模組** | orchestrator/（豐富） | task-api.js（輕量） |
+| **路徑鎖定** | ✅ lock_manager.py | ❌ 無 |
+| **依賴解析** | ✅ dependency_resolver.py | ⚠️ 基礎支援 |
+
+**選擇建議**：
+- 需要自動化排程 → 使用 Pipeline System
+- 需要並行開發 → 使用 Pipeline System（支援路徑鎖定）
+- 手動協作流程 → 使用 Collaboration System（更簡單）
+
+---
+
+## 📁 目錄結構
+
+```
+dev/pipeline/
+├── README.md                   # 快速開始指南
+├── WORKFLOW_GUIDE.md           # 完整使用指南（20 分鐘）
+├── PROGRESS.md                 # 進度追蹤文件
+├── TASK_QUEUE.json             # 任務佇列（JSON 索引）⭐
+├── PIPELINE_CONFIG.json        # Pipeline 配置
+├── AGENT_STATE.json            # Agent 狀態記錄
+├── LOCK_STATE.json             # 路徑鎖定狀態
+├── DASHBOARD_HEARTBEAT.json    # Dashboard 心跳檢測
+│
+├── tasks/                      # 待處理任務卡（YAML）
+│   ├── TASK_180_*.yaml
+│   └── ...
+│
+├── completed/                  # 已完成任務（YAML 封存）
+│   ├── TASK_066_*.yaml
+│   └── ...
+│
+├── logs/                       # 執行日誌（按日期）
+│   ├── 20260218_*.log
+│   └── ...
+│
+├── orchestrator/               # Python 編排模組 ⭐
+│   ├── __init__.py
+│   ├── task_queue.py           # 任務佇列管理
+│   ├── dependency_resolver.py  # 依賴解析
+│   ├── lock_manager.py         # 路徑鎖定機制
+│   ├── agent_assigner.py       # Agent 分配邏輯
+│   └── ...
+│
+├── docs/                       # 系統文檔
+│   └── multi-agent-coordination.md
+│
+├── plans/                      # 執行計劃
+└── backups/                    # 任務備份
+```
+
+---
+
+## 🔑 核心文件
+
+### 1. TASK_QUEUE.json（任務佇列索引）
+
+**用途**：集中式任務索引，記錄所有任務的狀態、依賴、路徑範圍。
+
+**結構**：
+```json
+{
+  "version": "1.0.0",
+  "project": "kenaz-dashboard",
+  "last_updated": "2026-02-15T12:30:00+08:00",
+  "statistics": {
+    "total": 8,
+    "pending": 0,
+    "in_progress": 0,
+    "completed": 8,
+    "blocked": 0,
+    "cancelled": 0
+  },
+  "tasks": [
+    {
+      "id": "TASK_180",
+      "title": "移除 Quick Actions 的 Single Agent Panel",
+      "status": "completed",
+      "priority": "P2",
+      "agent_type": "frontend",
+      "dependencies": [],
+      "scope_paths": [
+        "dashboard/src/components/quick-actions/..."
+      ],
+      "completed_at": "2026-02-15T01:42:14.000000+08:00"
+    }
+  ],
+  "metadata": {
+    "created_at": "2026-02-13T14:43:10.345+08:00",
+    "source_spec": "dev/PRODUCT_SPEC.md"
+  }
+}
+```
+
+**關鍵字段**：
+| 字段 | 說明 | 範例 |
+|------|------|------|
+| `id` | 任務唯一 ID | `TASK_180` |
+| `status` | 任務狀態 | `pending`, `in_progress`, `completed`, `blocked`, `cancelled` |
+| `priority` | 優先級 | `P0`（最高）到 `P3`（最低） |
+| `agent_type` | 執行 Agent | `frontend`, `backend`, `developer_team` |
+| `dependencies` | 依賴任務 ID 列表 | `["TASK_147"]` |
+| `scope_paths` | 修改的文件/目錄路徑 | `["CLAUDE.md"]` |
+
+**更新規則**：
+- 任務完成時，**必須**更新 `status` 為 `completed`
+- **必須**填寫 `completed_at`、`completed_by`、`git_commit`
+- **必須**重新計算 `statistics` 統計數據
+
+### 2. tasks/ 目錄（待處理任務卡）
+
+**用途**：存放待執行任務的 YAML 定義文件。
+
+**命名規則**：`TASK_XXX_<slug>.yaml`
+
+**YAML 格式**：
+```yaml
+id: "TASK_180"
+title: "移除 Quick Actions 的 Single Agent Panel"
+description: "清理 Single Agent Panel 組件和相關 hooks"
+priority: "P2"
+status: "pending"
+agent_type: "frontend"
+source: "F-020"
+feature_ids: ["F-020"]
+dependencies: []
+scope_paths:
+  - "dashboard/src/components/quick-actions/scripts-sections/SchedulerSection.tsx"
+  - "dashboard/src/components/quick-actions/SingleAgentCard.tsx"
+requirements:
+  - "移除 SingleAgentCard.tsx 組件"
+  - "移除 use-single-agent.ts hook"
+acceptance_criteria:
+  - "SingleAgentCard.tsx 已刪除"
+  - "SchedulerSection.tsx 無引用錯誤"
+estimated_hours: 0.5
+complexity: "simple"
+```
+
+**完成後流程**：
+1. 任務完成 → 更新 TASK_QUEUE.json status
+2. **必須**將 YAML 文件移動到 `completed/` 目錄
+3. 更新 PROGRESS.md 統計數據
+
+### 3. orchestrator/ 模組（Python 編排）
+
+**用途**：提供任務管理、依賴解析、路徑鎖定等進階功能。
+
+#### 3.1 task_queue.py（任務佇列管理）
+
+**核心類別**：
+- `TaskQueue`: 任務佇列管理器
+- `Task`: 任務資料模型
+- `TaskStatus`: 任務狀態枚舉
+- `TaskPriority`: 優先級枚舉
+
+**主要功能**：
+```python
+from dev.pipeline.orchestrator.task_queue import TaskQueue, TaskStatus
+
+# 載入任務佇列
+queue = TaskQueue("dev/pipeline/TASK_QUEUE.json")
+
+# 取得下一個待執行任務（按優先級排序）
+next_task = queue.get_next_task()
+
+# 更新任務狀態
+queue.update_status("TASK_180", TaskStatus.COMPLETED)
+
+# 儲存變更
+queue.save()
+
+# 取得統計數據
+stats = queue.get_statistics()
+# {'total': 8, 'pending': 0, 'completed': 8, ...}
+```
+
+**特色**：
+- ✅ JSON Schema 驗證
+- ✅ 優先級排序（P0 > P1 > P2 > P3）
+- ✅ 依賴關係檢查
+- ✅ 統計數據自動計算
+
+#### 3.2 dependency_resolver.py（依賴解析）
+
+**核心類別**：
+- `DependencyResolver`: 依賴關係解析器
+- `DependencyType`: 依賴類型（HARD/SOFT）
+
+**主要功能**：
+```python
+from dev.pipeline.orchestrator.dependency_resolver import DependencyResolver
+
+resolver = DependencyResolver()
+
+# 加入任務與依賴
+resolver.add_task("TASK_147", dependencies=[], status="completed")
+resolver.add_task("TASK_148", dependencies=["TASK_147"], status="pending")
+
+# 取得可執行的任務（所有依賴已滿足）
+ready = resolver.get_ready_tasks()  # ["TASK_148"]
+
+# 檢查循環依賴
+has_cycles = not resolver.validate_no_cycles()
+
+# 取得關鍵路徑（最長依賴鏈）
+critical_path = resolver.get_critical_path()
+
+# 取得拓撲排序（執行順序）
+order = resolver.get_execution_order()
+
+# 視覺化依賴圖
+print(resolver.visualize())
+```
+
+**特色**：
+- ✅ 拓撲排序（Kahn's algorithm）
+- ✅ 循環依賴檢測（DFS）
+- ✅ 關鍵路徑計算（動態規劃）
+- ✅ 依賴圖視覺化（ASCII tree）
+- ✅ Blocked 狀態傳播（依賴阻塞時自動標記）
+
+#### 3.3 lock_manager.py（路徑鎖定機制）
+
+**核心類別**：
+- `PathLockManager`: 路徑鎖定管理器
+- `LockType`: 鎖定類型（DIRECTORY/FILE/PREFIX）
+
+**主要功能**：
+```python
+from dev.pipeline.orchestrator.lock_manager import PathLockManager
+
+manager = PathLockManager("dev/pipeline/LOCK_STATE.json")
+
+# 嘗試取得鎖定
+paths = ["src/components/", "src/utils/helpers.ts"]
+if manager.acquire(paths, agent_id="agent_1", task_id="TASK_180"):
+    # 執行工作
+    ...
+    # 完成後釋放
+    manager.release("agent_1")
+
+# 檢查衝突（並行任務分配前）
+conflicts = manager.get_conflicts(["src/api/auth.py"])
+if conflicts:
+    print(f"路徑衝突: {conflicts}")
+
+# 清理孤兒鎖定（處理 Agent crash）
+cleaned = manager.cleanup_orphan_locks(timeout_minutes=60)
+```
+
+**鎖定類型**：
+| 類型 | 說明 | 範例 |
+|------|------|------|
+| DIRECTORY | 鎖定整個目錄樹 | `src/components/` |
+| FILE | 鎖定單一文件 | `src/utils/helpers.ts` |
+| PREFIX | 鎖定匹配前綴的所有路徑 | `src/api/*` |
+
+**衝突檢測規則**：
+- 路徑包含或被包含 = 衝突
+- `src/api/` 衝突 `src/api/auth.py`（目錄包含文件）
+- `src/api/*` 衝突 `src/api/auth.py`（前綴匹配）
+
+**特色**：
+- ✅ 多粒度鎖定（目錄/文件/前綴）
+- ✅ 衝突檢測（並行任務安全）
+- ✅ 持久化狀態（LOCK_STATE.json）
+- ✅ 孤兒鎖定清理（處理 Agent crash）
+
+---
+
+## 🔄 任務狀態機
+
+```
+pending → in_progress → completed
+    ↓           ↓
+  blocked   blocked
+```
+
+**狀態轉換規則**：
+| 從 | 到 | 條件 |
+|---|---|------|
+| `pending` | `in_progress` | Agent 開始執行 |
+| `in_progress` | `completed` | 任務成功完成，驗收標準通過 |
+| `in_progress` | `blocked` | 遇到阻礙（依賴失敗、Bug、外部因素） |
+| `pending` | `blocked` | 依賴任務失敗 |
+| `blocked` | `pending` | 阻礙解除 |
+| `*` | `cancelled` | 任務取消 |
+
+---
+
+## 🚀 使用方式
+
+### 1. 查看進度
+
+```bash
+# 查看 PROGRESS.md（人類可讀）
+cat dev/pipeline/PROGRESS.md
+
+# 查看任務佇列（JSON）
+cat dev/pipeline/TASK_QUEUE.json
+
+# 驗證任務佇列語法
+python dev/pipeline/orchestrator/task_queue.py dev/pipeline/TASK_QUEUE.json
+```
+
+### 2. Python API 使用
+
+```python
+from dev.pipeline.orchestrator.task_queue import TaskQueue, TaskStatus
+from dev.pipeline.orchestrator.dependency_resolver import DependencyResolver, create_resolver_from_task_queue
+from dev.pipeline.orchestrator.lock_manager import PathLockManager
+
+# === 任務佇列操作 ===
+queue = TaskQueue()
+next_task = queue.get_next_task()
+queue.update_status("TASK_180", TaskStatus.COMPLETED)
+queue.save()
+
+# === 依賴解析 ===
+resolver = create_resolver_from_task_queue(queue)
+ready_tasks = resolver.get_ready_tasks()
+critical_path = resolver.get_critical_path()
+
+# === 路徑鎖定 ===
+lock_manager = PathLockManager()
+if lock_manager.acquire(["src/api/"], "agent_1", "TASK_180"):
+    # 執行任務
+    ...
+    lock_manager.release("agent_1")
+```
+
+### 3. 與排程器整合
+
+Pipeline 系統與以下排程器整合：
+
+| 排程器 | 路徑 | 用途 |
+|--------|------|------|
+| **Single Agent** | `dev/scripts/START_DEV_AGENT.bat` | 單 Agent 自動化開發 |
+| **Multi-Agent** | `dev/scripts/START_MULTI_AGENT.bat` | 多 Agent 並行開發 |
+| **Self-Enhancement** | Dashboard UI | 自我增強迭代模式 |
+
+**排程器流程**：
+```
+1. 排程器啟動 → 讀取 TASK_QUEUE.json
+2. 取得 ready tasks → 依賴已滿足 + 無路徑衝突
+3. 分配給 Agent → 透過路徑鎖定防止衝突
+4. Agent 執行完成 → 更新 TASK_QUEUE.json + 移動 YAML
+5. 自動啟動下一輪 → 循環執行
+```
+
+---
+
+## 📊 統計與監控
+
+### PROGRESS.md 統計區塊
+
+```markdown
+## Statistics
+
+### Current Queue Status（舊系統 TASK_QUEUE.json）
+```
+Active Tasks: 0
+Pending: 0 (0%)
+In Progress: 0 (0%)
+Completed: 8 (100%)
+Blocked: 0 (0%)
+```
+
+### Historical Record (from .memory/ + completed/)
+```
+Completed Tasks: 187+
+Total Historical: 187+
+```
+```
+
+### Python 統計查詢
+
+```python
+queue = TaskQueue()
+stats = queue.get_statistics()
+# {
+#   'total': 8,
+#   'pending': 0,
+#   'in_progress': 0,
+#   'completed': 8,
+#   'blocked': 0,
+#   'cancelled': 0
+# }
+
+resolver = create_resolver_from_task_queue(queue)
+resolver_stats = resolver.get_statistics()
+# {
+#   'total_tasks': 8,
+#   'total_edges': 5,
+#   'status_counts': {'completed': 8},
+#   'has_cycles': False,
+#   'critical_path_length': 3,
+#   'critical_path_duration': 5.0,
+#   'ready_tasks_count': 0
+# }
+```
+
+---
+
+## ⚙️ 配置文件
+
+### PIPELINE_CONFIG.json
+
+```json
+{
+  "version": "1.0.0",
+  "settings": {
+    "max_parallel_agents": 3,
+    "task_timeout_minutes": 60,
+    "lock_timeout_minutes": 60,
+    "auto_cleanup_orphan_locks": true
+  },
+  "agent_types": {
+    "frontend": { "max_concurrent": 2 },
+    "backend": { "max_concurrent": 2 },
+    "qa": { "max_concurrent": 1 }
+  }
+}
+```
+
+---
+
+## 🔗 相關文檔
+
+| 文檔 | 路徑 | 說明 |
+|------|------|------|
+| **快速開始** | `dev/pipeline/README.md` | 5 分鐘快速上手 |
+| **完整指南** | `dev/pipeline/WORKFLOW_GUIDE.md` | 20 分鐘深入教學 |
+| **Lead Agent 流程** | `CLAUDE.md` | 12 步開發流程 |
+| **Pipeline 規則** | `.rule/pipeline/task-execution.yaml` | PPL-101 至 PPL-112 |
+| **新任務系統** | `.system/collaboration/README.md` | Collaboration 系統文檔 |
+
+---
+
+## 🆚 新舊系統共存
+
+目前專案**同時運行兩套系統**，查詢時需兩邊都查：
+
+| 系統 | 路徑 | ID 範圍 | 查詢方式 |
+|------|------|---------|---------|
+| **新系統** | `.collaboration/tasks/{status}/` | TASK_151~196 | `node .collaboration/core/task-api.js list` |
+| **舊系統** | `dev/pipeline/` | TASK_134~187 | `cat dev/pipeline/TASK_QUEUE.json` |
+
+**Migration 工具**：
+```bash
+# 新系統 → 舊系統（JSON 匯出）
+node .collaboration/core/migrate-legacy.js export
+
+# 舊系統 → 新系統（YAML 匯入）
+node .collaboration/core/migrate-legacy.js import
+```
+
+---
+
+## 📝 最佳實踐
+
+### 1. 任務完成後的標準流程
+
+```bash
+# 1. 更新 TASK_QUEUE.json（Python）
+python << EOF
+from dev.pipeline.orchestrator.task_queue import TaskQueue, TaskStatus
+queue = TaskQueue()
+queue.update_status("TASK_180", TaskStatus.COMPLETED)
+queue.save()
+EOF
+
+# 2. 移動任務文件到 completed/
+mv dev/pipeline/tasks/TASK_180_*.yaml dev/pipeline/completed/
+
+# 3. 更新 PROGRESS.md
+# （手動或透過 Agent 更新統計數據）
+
+# 4. 驗證一致性
+python dev/pipeline/orchestrator/task_queue.py dev/pipeline/TASK_QUEUE.json
+```
+
+### 2. 並行開發時的衝突避免
+
+```python
+# 使用路徑鎖定防止衝突
+lock_manager = PathLockManager()
+
+# 分配 TASK_A（修改 src/api/）
+conflicts_A = lock_manager.get_conflicts(["src/api/"])
+if not conflicts_A:
+    lock_manager.acquire(["src/api/"], "agent_1", "TASK_A")
+
+# 分配 TASK_B（修改 src/components/）
+conflicts_B = lock_manager.get_conflicts(["src/components/"])
+if not conflicts_B:
+    lock_manager.acquire(["src/components/"], "agent_2", "TASK_B")
+
+# TASK_A 和 TASK_B 可以並行執行，無路徑衝突 ✅
+```
+
+### 3. 定期清理孤兒鎖定
+
+```bash
+# 每 1 小時執行一次
+python << EOF
+from dev.pipeline.orchestrator.lock_manager import PathLockManager
+manager = PathLockManager()
+cleaned = manager.cleanup_orphan_locks(timeout_minutes=60)
+print(f"清理了 {cleaned} 個孤兒鎖定")
+EOF
+```
+
+---
+
+## 🐛 常見問題
+
+### Q1: TASK_QUEUE.json 格式錯誤
+
+**症狀**：JSON 解析失敗
+
+**解決方案**：
+```bash
+# 驗證 JSON 語法
+node -e "JSON.parse(require('fs').readFileSync('dev/pipeline/TASK_QUEUE.json', 'utf8'))"
+
+# 自動修復（移除 BOM + 格式化）
+node .failure/tools/fix_json.js dev/pipeline/TASK_QUEUE.json
+```
+
+### Q2: 任務卡與 TASK_QUEUE.json 不同步
+
+**症狀**：YAML 文件與 JSON 索引狀態不一致
+
+**解決方案**：
+```bash
+# 使用驗證腳本
+.\dev\scripts\validate_pipeline.ps1
+
+# 自動修復
+.\dev\scripts\fix_pipeline.ps1
+```
+
+### Q3: 路徑鎖定衝突
+
+**症狀**：無法取得路徑鎖定
+
+**檢查衝突**：
+```python
+lock_manager = PathLockManager()
+conflicts = lock_manager.get_conflicts(["src/api/"])
+for c in conflicts:
+    print(f"衝突路徑: {c['conflicting_path']}")
+    print(f"持有者: {c['held_by_agent']} (TASK: {c['held_by_task']})")
+```
+
+**強制釋放**（謹慎使用）：
+```python
+lock_manager.force_release("src/api/")
+```
+
+---
+
+## 🔐 安全性注意事項
+
+### 1. JSON 編碼問題
+
+- ⚠️ **BOM 問題**：Windows 編輯器可能產生 UTF-8 with BOM，導致 JSON 解析失敗
+- ✅ **解決方案**：使用 `.failure/tools/fix_json.js` 工具
+
+### 2. 並行寫入
+
+- ⚠️ **Race Condition**：多 Agent 同時修改 TASK_QUEUE.json 會導致數據損壞
+- ✅ **解決方案**：透過路徑鎖定機制保護關鍵文件
+
+### 3. 孤兒鎖定
+
+- ⚠️ **Agent Crash**：Agent 崩潰會留下孤兒鎖定，阻塞其他任務
+- ✅ **解決方案**：定期執行 `cleanup_orphan_locks()`
+
+---
+
+## 📈 未來規劃（遷移方向）
+
+### ⚠️ Legacy System 淘汰計劃
+
+**目標**：全面遷移到 `.collaboration/` 新系統，淘汰此 Legacy System。
+
+**階段 1：雙軌制運行**（當前階段）
+- ✅ 兩套系統並存，保持相容
+- ✅ 新任務優先建立在 Collaboration 系統
+- ✅ Formation 系統已支援三層 fallback（新系統 → 舊 YAML → 舊 JSON）
+- ⚠️ 此 Legacy System 功能凍結，不再新增特性
+
+**階段 2：功能補齊**（計劃中）
+- [ ] 實現路徑鎖定機制（移植 `lock_manager.py` 到 Node.js）
+- [ ] 增強依賴解析（拓撲排序、循環檢測、關鍵路徑）
+- [ ] 建立驗證工具（`validate_collaboration.js`）
+- [ ] 統計查詢增強（依賴圖、執行時間預估）
+
+**階段 3：排程器遷移**（計劃中）
+- [ ] 更新 Single-Agent 排程器使用新系統
+- [ ] 更新 Multi-Agent 排程器使用新系統
+- [ ] 保留此 Legacy System 的 Python orchestrator 模組作為參考實現
+
+**階段 4：全面遷移 & Legacy System 封存**（計劃中）
+- [ ] 將 `dev/pipeline/TASK_QUEUE.json` 中的任務匯入新系統
+- [ ] 封存此 Legacy System 文件至 `.legacy/pipeline/`
+- [ ] 更新 CLAUDE.md、規則文檔移除 Legacy System 引用
+- [ ] 移除排程器對 TASK_QUEUE.json 的依賴
+
+### 依賴項（阻礙遷移的功能）
+
+| 功能 | 依賴此 Legacy System | 新系統狀態 | 預計完成 |
+|------|---------------------|-----------|---------|
+| **路徑鎖定** | `lock_manager.py` | ❌ 未實現 | 階段 2 |
+| **依賴解析（進階）** | `dependency_resolver.py` | ⚠️ 基礎支援 | 階段 2 |
+| **Single-Agent 排程器** | `START_DEV_AGENT.bat` | ❌ 未遷移 | 階段 3 |
+| **Multi-Agent 排程器** | `START_MULTI_AGENT.bat` | ❌ 未遷移 | 階段 3 |
+| **Dashboard Scheduler** | Tauri API | ⚠️ 部分支援 | 階段 3 |
+
+### 何時可以停用此 Legacy System？
+
+當以下條件全部滿足時，可安全淘汰：
+1. ✅ 新系統支援路徑鎖定機制（防止並行衝突）
+2. ✅ 新系統支援進階依賴解析（拓撲排序、循環檢測）
+3. ✅ 所有排程器已遷移到新系統
+4. ✅ 無 `dev/pipeline/TASK_QUEUE.json` 的殘留依賴
+
+**預計時間**：2026 Q2 完成階段 2，2026 Q3 完成階段 3-4。
+
+---
+
+**版本**: 1.0.0 (Legacy)
+**最後更新**: 2026-02-19
+**維護者**: Developer Team（凍結維護，僅 Bug 修復）
+**相關任務**: TASK_195（建立文檔）, TASK_198（標記為 Legacy）
+**新系統文檔**: [`.system/collaboration/README.md`](../collaboration/README.md)