kenaz 0.3.18 → 0.3.20

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

@@ -1,712 +0,0 @@
-# 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)