diff --git a/.gitignore b/.gitignore
index f38a9a7..cc801b9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -28,8 +28,8 @@ yarn-error.log*
 
 # ---------- 子游戏共享框架的 junction（指向 YouleNexus 真源，按机器重建） ----------
 # 由 scripts/setup-links 在每台机器上重建，不入库
-games/*/assets/framework
-games/*/assets/framework.meta
+cocoscreator_projects/games/*/assets/framework
+cocoscreator_projects/games/*/assets/framework.meta
 
 # ---------- cocos-creator-mcp 扩展：本地依赖与构建产物 ----------
 # clone 后在该目录跑 `npm install && npm run build` 重新生成
diff --git a/cocoscreator_projects/YouleNexus/assets/framework/README.md b/cocoscreator_projects/YouleNexus/assets/framework/README.md
new file mode 100644
index 0000000..8b48024
--- /dev/null
+++ b/cocoscreator_projects/YouleNexus/assets/framework/README.md
@@ -0,0 +1,6 @@
+# framework — 框架真源（唯一权威副本）
+
+各子游戏工程的 `assets/framework` 是指向**本目录**的 junction（见 `scripts/setup-links.mjs`）。
+六层结构（依赖严格单向，详见 spec §3）：core / net / protocol / platform / ui / sdk。
+
+协议相关实现一律以 `docs/protocol/` 为唯一信息源（spec §0.1），不在代码或注释中内联复制协议字段。
diff --git a/cocoscreator_projects/YouleNexus/assets/framework/core/.gitkeep b/cocoscreator_projects/YouleNexus/assets/framework/core/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/cocoscreator_projects/YouleNexus/assets/framework/net/.gitkeep b/cocoscreator_projects/YouleNexus/assets/framework/net/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/cocoscreator_projects/YouleNexus/assets/framework/platform/.gitkeep b/cocoscreator_projects/YouleNexus/assets/framework/platform/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/cocoscreator_projects/YouleNexus/assets/framework/protocol/.gitkeep b/cocoscreator_projects/YouleNexus/assets/framework/protocol/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/cocoscreator_projects/YouleNexus/assets/framework/sdk/.gitkeep b/cocoscreator_projects/YouleNexus/assets/framework/sdk/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/cocoscreator_projects/YouleNexus/assets/framework/ui/.gitkeep b/cocoscreator_projects/YouleNexus/assets/framework/ui/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/cocoscreator_projects/games/.gitkeep b/cocoscreator_projects/games/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/cocoscreator_projects/package.json b/cocoscreator_projects/package.json
new file mode 100644
index 0000000..792e90b
--- /dev/null
+++ b/cocoscreator_projects/package.json
@@ -0,0 +1,13 @@
+{
+  "name": "youle-monorepo-tools",
+  "private": true,
+  "type": "module",
+  "version": "0.1.0",
+  "scripts": {
+    "test": "node --test scripts/test/",
+    "setup-links": "node scripts/setup-links.mjs",
+    "new-game": "node scripts/new-game.mjs",
+    "check-cocos": "node scripts/check-cocos-version.mjs",
+    "bump-cocos": "node scripts/bump-cocos.mjs"
+  }
+}