chore: D22 落地——docs/SDD/wiki/CLAUDE.md 進 repo（Gitea private 預設全 push）
頂層 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>
This commit is contained in:
uncle6me-web
@@ -0,0 +1,189 @@
|
||||
# 階段一：檔案分類清單
|
||||
|
||||
> 共 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）。
|
||||
Reference in New Issue
Block a user