# 3. Specs — 需求 + SDD + 進度

> 各子系統的設計文檔 + 任務清單。

## 進行中（必讀）

| 目錄 | Phase | 狀態 |
|------|-------|------|
| **portal-auth/** | — | **現行 active**（唯一，D35 單一活性） |
| **arcrun/kbdb-base/** | Phase 7 | 上線完成 + 待處理（§8） |

> 「進行中」以各 design.md frontmatter `status: active` 為唯一判準：`bash system-dev/scripts/sdd-active-check.sh`。

## 已封存（archive/，closed）

| 目錄 | 封存日 | 備註 |
|------|-------|------|
| **archive/credential-primitives-wasm/** | 2026-07-21 | 主線達成（cypher-executor TS 無 credential/auth 邏輯）。現行做法＝CF Workers Secrets + D1 目錄。殘留缺口 `auth_mtls` 未實作、7.6 端到端未驗 → 要做需另立新 SDD |

## 主線

| 目錄 | 內容 | 狀態 |
|------|------|------|
| **arcrun-core-mvp/** | MVP 整體架構 | 基礎完成 |
| **arcrun/auth-recipe.md** | Auth recipe 系統 | 穩定 |
| **arcrun/landing-page.md** | Landing page | 設計中 |
| **arcrun/sdk-and-website/** | SDK + MCP + 文檔 | 進行中 |
| **arcrun-platform-evolution/** | 長期演化規劃 | 路線圖 |

## 安全 & 基礎設施

| 目錄 | 用途 |
|------|------|
| **component-gatekeeping/** | 零件投稿 gatekeeping（PR + CI） |
| **component-registry-canon/** | registry 規範化（dead storage cleanup） |
| **data-exfil-warning/** | 資料外流警示 API 層實作 |

## 未來

| 目錄 | 用途 |
|------|------|
| **llm-interface/** | AI 操盤手體驗改進（mira dogfood 痛點） |
| **recipe-system/** | recipe 長期規範（§5 onwards） |
| **resumable-workflow/** | workflow 暫停恢復（Phase 6） |
| **user-cc-harness/** | CC harness 安裝 + 配置（Phase 7） |

---

## 讀 SDD 的順序

新任務開始：
1. `docs/3-specs/arcrun/arcrun.md`（全景進度）
2. 對應子系統的 `design.md`（設計背景）
3. 同目錄的 `tasks.md`（細節任務 + 依賴）

---

更新時間：2026-06-08