diff --git a/docs_v1.0/M5_workspace/2026-05-07_git_sync_setup.md b/docs_v1.0/M5_workspace/2026-05-07_git_sync_setup.md
new file mode 100644
index 0000000..c9d9a83
--- /dev/null
+++ b/docs_v1.0/M5_workspace/2026-05-07_git_sync_setup.md
@@ -0,0 +1,54 @@
+# M5/M4 Git 同步設定
+
+## 現狀
+
+`/Users/accusys/momentry_core_0.1` 已初始化 git，`docs_v1.0/` 已 commit（519 files）。
+
+## M4 取得文件
+
+```bash
+# 從 M5 clone 僅 docs 目錄
+git clone --depth 1 accusys@192.168.110.201:/Users/accusys/momentry_core_0.1/.git momentry_docs
+cd momentry_docs
+git sparse-checkout set docs_v1.0/
+```
+
+之後更新：
+```bash
+git pull
+```
+
+## 目錄結構說明
+
+```
+docs_v1.0/
+├── API_V1.0.0/             # M5 正式文件（spec、release、deploy、test）
+│   ├── TRACE/               # Trace API Reference
+│   ├── DEPLOY/              # 部署方案（Embedding、LLM）
+│   ├── INTERNAL/            # 內部設計（processors、agents、vector spec）
+│   │   └── AGENTS/          # 5W1H+ Agent、Identity Agent
+│   ├── RELEASE/             # Release 驗證、progress report
+│   └── TEST_RESULTS/        # API 測試結果
+├── M4_workspace/            # M4 工作記錄
+├── M5_workspace/            # M5 工作記錄
+└── REFERENCE/               # 歷史參考文件
+```
+
+## 協作方式
+
+| 動作 | 方式 |
+|------|------|
+| M5 更新正式文件 | `git add docs_v1.0/API_V1.0.0/` → `git commit` → M4 `git pull` |
+| M4 發 Issue/Review | `git add docs_v1.0/M4_workspace/` → `git commit` → M5 `git pull` |
+| M5 回覆 | 同上，寫到 `docs_v1.0/M5_workspace/` |
+
+## EmbeddingGemma 部署（已就緒）
+
+| 機器 | 狀態 |
+|------|------|
+| M5 (192.168.110.201:11436) | ✅ 已啟動（Python MPS） |
+| M4 (localhost:11436) | ✅ 已啟動 |
+
+Portal embed client 加 retry：先 call M5，失敗 call M4 local。
+
+詳細部署：`API_V1.0.0/DEPLOY/EMBEDDING_DEPLOYMENT_V1.0.0.md`