# 階段一：檔案分類清單

> 共 101 個 .md 檔案，按建議位置分類。
> 信心度：確定/不確定 | 原因

---

## 📌 根目錄 — 保留（核心配置）

| 檔案 | 判定 | 原因 |
|------|------|------|
| CLAUDE.md | ✅ 保留 | 項目規範入口，cc 必讀 |
| README.md | ✅ 保留 | 對外項目說明 |
| DECISIONS.md | ⚠️ → docs/2-architecture/decisions/ | 架構決策歷史，應歸檔 |
| BACKLOG.md | ⚠️ → docs/3-specs/ | 需求清單，隨 SDD 更新 |
| BETA_TEST.md | ⚠️ → docs/5-records/test-reports/ | 測試記錄 |
| RELEASE-CHECKLIST.md | ✅ → docs/4-guides/ | 操作手冊 |
| CONTRIBUTING.md | ✅ → docs/6-user/ | 對外開發指南 |
| AGENTS.md | ⚠️ → docs/4-guides/ | Agent 用法指南 |

---

## 📦 .agents/specs/ → docs/3-specs/

（高優先，直接搬家，保留目錄結構）

### arcrun-core-mvp/
- requirements.md ✅
- design.md ✅
- tasks.md ✅

### arcrun-platform-evolution/
- requirements.md ✅
- design.md ✅
- tasks.md ✅

### arcrun/ （主線）
- arcrun.md ✅
- auth-recipe.md ✅

### arcrun/credential-primitives-wasm/
- design.md ✅
- tasks.md ✅

### arcrun/frontend-redesign/
- requirements.md ✅
- design.md ✅
- tasks.md ✅
- design-source/SOURCE_README.md ✅
- design-source/design-chat.md ✅

### arcrun/kbdb-base/
- design.md ✅
- tasks.md ✅

### arcrun/landing-page.md ✅

### arcrun/sdk-and-website/
- design.md ✅
- requirements.md ✅
- tasks.md ✅
- config-layering.md ✅
- mcp-account-source.md ✅
- self-hosted-init.md ✅

### component-gatekeeping/
- requirements.md ✅
- design.md ✅
- tasks.md ✅
- recipe-push-gatekeeping.md ✅

### component-registry-canon/
- design.md ✅
- tasks.md ✅

### data-exfil-warning/
- requirements.md ✅
- design.md ✅
- tasks.md ✅

### llm-interface/
- requirements.md ✅
- design.md ✅
- tasks.md ✅

### recipe-system/
- design.md ✅
- tasks.md ✅

### resumable-workflow/
- design.md ✅
- tasks.md ✅

### user-cc-harness/
- design.md ✅
- tasks.md ✅

---

## 🏗️ .claude/rules/ → docs/2-architecture/

（高優先，技術棧 + 架構規範）

| 檔案 | 目標位置 | 說明 |
|------|---------|------|
| 00-sdd-protocol.md | docs/2-architecture/ | SDD 協議（流程規範） |
| 01-tech-stack.md | docs/2-architecture/ | 技術棧硬限制（三層語言） |
| 02-forbidden.md | docs/2-architecture/ | 禁止行為（hook 強制） |
| 03-component-architecture.md | docs/2-architecture/ | 零件架構定義（R2/binding/URL） |
| 04-current-progress.md | docs/2-architecture/ | 當前進度（動態，常更新） |
| 05-deploy-convention.md | docs/4-guides/deploy/ | 部署慣例（操作手冊） |
| 06-mindset.md | docs/2-architecture/ | 設計哲學（為什麼層） |
| 07-thin-shell.md | docs/2-architecture/ | 薄殼原則鐵律 |

---

## 📋 docs/ 現有 → 重新分類

### docs/incidents/ → docs/5-records/incidents/
- 2026-05-13-cypher-outbound-522.md ✅
- 2026-05-13-chain-ctx-propagation.md ✅
- 2026-05-13-nested-foreach-iterable.md ✅
- 2026-05-29-encryption-key-drift.md ✅
- README.md ✅

### docs/ 根目錄
| 檔案 | 新位置 | 說明 |
|------|--------|------|
| pre-customer-checklist-2026-06-07.md | docs/5-records/test-reports/ | 測試檢查清單 |
| 壓測-recipe-library-2026-06-07.md | docs/5-records/test-reports/ | 壓測報告 |

### docs/user_requirements/ → docs/6-user/ 或 docs/3-specs/
（需求源，可適度歸檔，但常引用）

- credential_parts.md → docs/3-specs/
- wishlist.md → docs/6-user/
- u6u-plan.md → docs/3-specs/ （歷史規劃）
- u6u_design.md → docs/3-specs/
- u6u_system_spec.md → docs/3-specs/
- 其他 ADR → docs/2-architecture/decisions/

---

## 🛠️ 專案子目錄內的文件

### cli/
- CHANGELOG.md → docs/5-records/（版本歷史）
- harness/ → 保留（bundled into npm package）

### landing/
- CLAUDE.md → 保留（子項目規範）
- README.md → 保留（對外說明）
- AGENTS.md → docs/4-guides/ （agent 文件）

### mcp/
- README.md → 保留（對外說明）
- GUIDE.md → docs/4-guides/mcp-setup.md
- dev/review.md → docs/4-guides/mcp-development.md

### registry/
- examples/README.md → docs/4-guides/workflow-examples.md
- examples/*/description.md → docs/4-guides/examples/ （搬進）
- skills/README.md → docs/4-guides/
- skills/*.md → docs/4-guides/skills/ （搬進）
- components/*/README.md → docs/4-guides/components/ （有名字的元件文件）

### tests/
- TEST_CASES.md → docs/5-records/test-reports/

---

## 📊 統計

| 類別 | 件數 | 狀態 |
|------|------|------|
| docs/1-vision/ | 0（待補） | 待建 |
| docs/2-architecture/ | ~20 | 從 .claude/rules + DECISIONS |
| docs/3-specs/ | ~40 | 從 .agents/specs + user_requirements |
| docs/4-guides/ | ~15 | 從 registry/skills + README 類 |
| docs/5-records/ | ~10 | 從 incidents + test-reports |
| docs/6-user/ | ~5 | 從 CONTRIBUTING + user_requirements |
| .claude/wiki/ | 4+N | 待建 |
| 保留根目錄 | 3 | CLAUDE.md, README.md, .claude/ |

---

## ⏭️ 下一步

確認上述分類無誤後，進行階段二（逐一讀文件，建 wiki）。
