uncle6me-web
5d00e71275
頂層 D22 決策（leo 2026-07-03 拍板）：推什麼由開發環境歸屬決定， Gitea private＝除機敏值/build 產物/.github 外全 push。 解 T1.5 卡點：雲端工人 clone 拿得到 credential-store-migration.md，可就地改寫 SDD。 機敏掃描兩輪通過（新增 189 檔約 2.1MB，node_modules/dist/wasm 照舊排除）。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
190 lines
5.1 KiB
Markdown
190 lines
5.1 KiB
Markdown
# 階段一：檔案分類清單
|
||
|
||
> 共 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）。
|