docs: initialize shared Hermes project memory

.hermes/shared-memory/document-map.md

@@ -0,0 +1,100 @@
+# 文档地图与阅读索引
+
+> 用途：根据 `README.md`、`AGENTS.md` 和 `docs/` 下文档索引整理团队记忆入口，帮助本地 Hermes 快速选择应该读哪些资料。
+
+## 全局入口
+
+| 场景 | 优先阅读 |
+| --- | --- |
+| 建立项目背景 | `README.md`、`AGENTS.md`、`.hermes/shared-memory/project-overview.md` |
+| 找文档分类 | `docs/README.md` |
+| 开发方法论 | `docs/experience/README.md` |
+| 查风险与历史问题 | `docs/audits/README.md` |
+| 做玩法/交互/系统设计 | `docs/design/README.md` |
+| 做技术实现/后端/部署 | `docs/technical/README.md` |
+| 排期与拆阶段 | `docs/planning/README.md` |
+| 查脚本/Function/prompt/职责地图 | `docs/reference/README.md` |
+| 查埋点 SQL | `docs/tracking/README.md` |
+| 查运营/任务/钱包对账 SQL | `docs/operations/README.md` |
+| 查 PRD | `docs/prd/` |
+
+## docs 分类规则
+
+- `experience/`：方法论、交接经验、长期有效的开发结论。
+- `audits/`：现状扫描、问题定位、是否达标的审查类文档。
+- `design/`：玩法机制、叙事关系、系统结构设计。
+- `technical/`：技术选型、实现路线、竞品/产品形态拆解。
+- `planning/`：阶段优先级与推进顺序。
+- `reference/`：目录、速查、检索辅助。
+- `tracking/`：埋点原始事实和聚合投影查询。
+- `operations/`：后台运营核查、对账和排障查询。
+- `prd/`：产品需求与阶段计划。
+
+## 推荐阅读顺序
+
+通用复杂任务：
+
+1. `AGENTS.md`
+2. `.hermes/shared-memory/`
+3. `docs/README.md`
+4. `docs/experience/README.md`
+5. `docs/audits/README.md`
+6. 任务对应分类下的 README 和具体文档
+
+后端 / 数据真相 / SpacetimeDB：
+
+1. `docs/technical/CURRENT_BACKEND_IMPLEMENTATION_BASELINE_2026-04-25.md`
+2. `docs/technical/SERVER_RS_DDD_FULL_REFACTOR_2026-04-28.md`
+3. `docs/technical/SERVER_RS_DDD_G1_CONTRACT_AND_ROUTE_MATRIX_2026-04-29.md`
+4. `docs/technical/SERVER_RS_DDD_PARALLEL_TASKLIST_2026-04-29.md`
+5. `docs/technical/SPACETIMEDB_SCHEMA_CHANGE_CONSTRAINTS.md`
+6. `docs/technical/SPACETIMEDB_TABLE_CATALOG.md`
+7. 具体模块方案文档
+
+生产部署 / 服务器 / Jenkins：
+
+1. `docs/technical/PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md`
+2. 需要迁移时再看 `SPACETIMEDB_JSON_STRING_MIGRATION_PROCEDURE_2026-04-27.md`
+3. 历史 Jenkins / CORS / 本地远端脚本文档只作追溯，不作为当前入口
+
+RPG 创作与运行时链路：
+
+1. `docs/reference/RPG_CREATION_AND_RUNTIME_SCRIPT_RESPONSIBILITY_MAP_2026-04-28.md`
+2. `docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md`
+3. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md`
+4. 相关工作包 progress / closure 文档
+
+移动端 UI / 游戏 UI：
+
+1. `docs/experience/MOBILE_UI_DEV_EXPERIENCE.md`
+2. `UI_CODING_STANDARD.md`
+3. 相关 `docs/design/` 文档
+
+创作 Agent / 自定义世界：
+
+1. `docs/design/CUSTOM_WORLD_CREATOR_INPUT_AND_AI_BOUNDARY_DESIGN_2026-04-06.md`
+2. `docs/design/CUSTOM_WORLD_CREATOR_MANUAL_AI_SYSTEM_BALANCE_DESIGN_2026-04-12.md`
+3. `docs/design/CUSTOM_WORLD_CREATOR_PURE_AGENT_COMPARISON_AND_CONVERSION_DESIGN_2026-04-12.md`
+4. `docs/technical/UNIFIED_CREATION_AGENT_CHAT_FRAMEWORK_2026-04-22.md`
+5. 相关 `SPACETIMEDB_CUSTOM_WORLD_*` 技术方案
+
+拼图 / 大鱼 / Match3D：
+
+- 拼图：优先看 `PUZZLE_CREATION_AND_RUNTIME_MINIMAL_IMPLEMENTATION_2026-04-22.md`、`PUZZLE_RUNTIME_FRONTEND_LOGIC_REHOME_2026-05-02.md` 和相关 Puzzle 技术文档。
+- 大鱼吃小鱼：优先看 `BIG_FISH_CREATION_AND_RUNTIME_MINIMAL_IMPLEMENTATION_2026-04-22.md` 和相关 Big Fish 技术/经验文档。
+- 抓大鹅 Match3D：优先看 `docs/prd/AI_NATIVE_MATCH3D_CREATOR_AND_GAMEPLAY_SYSTEM_PRD_2026-04-30.md`、`MATCH3D_CREATION_AND_RUNTIME_MINIMAL_IMPLEMENTATION_2026-04-30.md` 和相关 Match3D 技术文档。
+
+个人任务 / 埋点 / 运营查询：
+
+1. `docs/technical/PROFILE_TASK_AND_TRACKING_SYSTEM_2026-05-03.md`
+2. `docs/technical/RUNTIME_PROFILE_TASK_SCOPE_2026-05-04.md`
+3. `docs/technical/ANALYTICS_DATE_DIMENSION_IMPLEMENTATION_2026-05-04.md`
+4. `docs/tracking/TRACKING_QUERY_PLAYBOOK_2026-05-03.md`
+5. `docs/operations/PROFILE_TASK_QUERY_PLAYBOOK_2026-05-03.md`
+
+## 文档维护规则
+
+- 新增工程实现时，如果已有对应文档，必须同步更新。
+- 如果没有对应文档，新文档放入 `docs/` 下合适分类。
+- `.hermes/shared-memory/` 只保留跨任务、跨成员、高频使用的摘要和索引。
+- 如果文档与代码冲突，先确认代码事实，再更新过期文档和共享记忆。