Leo/Arcrun
1
0
Fork 0
Code Issues 49 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
Files
9f777ff43e47f1053b4bd8a18d994dff00a13500
Arcrun/system-dev/docs/5-records/2026-06-08-wiki-migration.md
T
uncle6me-web 5d00e71275 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>
2026-07-03 07:13:33 +08:00

5.1 KiB
Raw Blame History

階段一：檔案分類清單

共 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 View Git Blame Copy Permalink