diff --git a/README.md b/README.md
index ca0f1224ee..b0306c1398 100644
--- a/README.md
+++ b/README.md
@@ -264,7 +264,16 @@ pnpm dev:web       # frontend
 pnpm dev:backend   # backend
 ```
 
-[dbx-agents](https://github.com/t8y2/dbx-agents) contains driver development projects.
+[dbx-agents](https://github.com/t8y2/dbx-agents) is a separate repository containing JDBC agent driver development projects. For local development, clone it alongside `dbx/` under the same workspace directory and open the parent folder in your IDE:
+
+```bash
+mkdir dbx-workspace && cd dbx-workspace
+git clone https://github.com/t8y2/dbx.git
+git clone https://github.com/t8y2/dbx-agents.git
+# Open dbx-workspace/ in your IDE to work on both projects together
+```
+
+This keeps the two repositories independent (separate git histories) while making it easy to navigate between them during development.
 
 ### Build
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 01c6c5750e..b8f78e512b 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -262,7 +262,14 @@ pnpm dev:web       # 前端
 pnpm dev:backend   # 后端
 ```
 
-[dbx-agents](https://github.com/t8y2/dbx-agents) 存放了驱动开发的工程。
+[dbx-agents](https://github.com/t8y2/dbx-agents) 是独立仓库，存放 JDBC Agent 驱动开发工程。本地开发时建议克隆到 `dbx/` 同级目录下，用 IDE 打开父文件夹即可同时开发两个项目：
+
+```bash
+mkdir dbx-workspace && cd dbx-workspace
+git clone https://github.com/t8y2/dbx.git
+git clone https://github.com/t8y2/dbx-agents.git
+# 用 IDE 打开 dbx-workspace/ 即可同时开发两个项目
+```
 
 ### 构建