【整合】 框架使用规则

rules/30-模块登记规则.md

@@ -1,81 +1,43 @@
 # 模块登记规则
 
-> 本文档是 UnityAI / StrayFog 框架知识库的长期规则，为 Codex (AGENTS.md) 和 Claude Code (CLAUDE.md) 共同引用。
+模块入口、分类和状态统一维护在 [模块索引](../modules/模块索引.md)，其他文档不复制模块清单。
 
-这里定义模块登记口径、状态含义和拆分规则。项目模块总入口统一维护在 [模块索引](../modules/模块索引.md)，本文件不重复维护模块清单。
+## 分类
 
----
+- **核心框架**：运行时系统，例如 UI、资源、事件、实体、对象池和场景。
+- **编辑器工具**：Unity Editor 内的生成器、窗口、菜单和 MCP Bridge。
+- **业务参考**：外部项目案例，仅用于说明框架如何被使用。
 
-## 口径
+## 状态
 
-- **核心框架**：支撑游戏运行的内部系统，例如实体系统、UI 窗口系统、事件系统、资源管理、对象池、场景管理、网络、配置生成。
-- **编辑器工具**：Unity Editor 内使用的生成器、Inspector、菜单、配置工具。
-- **业务参考**：外部实际项目的业务实现示例，仅作参考，不作为框架规范。
+- **未识别**：尚无稳定实现线索。
+- **已识别**：已发现路径或入口，未完成系统梳理。
+- **初步梳理**：职责、路径或基本数据流已记录，仍有待确认项。
+- **待验证**：文档已有结论，尚未通过 Unity、运行时、生成器或日志闭环。
+- **已完成**：当前文档与实现已经验证，后续随代码演进维护。
+- **未发现实现**：按目录和关键词检查后暂未发现实现。
 
----
+## 文档结构
 
-## 唯一事实来源
-
-模块清单、模块状态和模块入口统一维护在：
-
-```text
-modules/模块索引.md
-```
-
-其他规则文档只链接到模块索引或具体模块文档，不再复制模块表。
-
----
-
-## 状态定义
-
-- **未识别**：还没有稳定线索。
-- **已识别**：已发现目录、类、资源或协议线索，但未完成梳理。
-- **初步梳理**：已写入核心路径、职责、数据流或使用规则，仍可能有待确认项。
-- **待验证**：文档已有结论，但需要通过 Unity、运行时、生成器或日志验证。
-- **已完成**：文档和验证都闭环，后续只需随代码演进维护。
-- **未发现实现**：按关键词和目录扫描后暂未发现实现，可作为规划占位。
-
-避免使用“已开始”作为状态；它不能说明到底是只建了文件，还是已经完成了一轮梳理。
-
----
+- 轻量模块使用一个 `README.md`。
+- API 和业务调用较多时增加 `使用指南.md` 或 `开发指南.md`。
+- 特殊限制写入 `注意事项.md`，不创建计划、进度或任务文件。
+- 模块发生大改时，讨论保留在对话中；实现后的稳定结论直接更新现有文档。
+- 模块新增、删除、重命名或状态变化时更新模块索引。
 
 ## 登记规则
 
-- 新增核心框架模块时，登记到 [模块索引](../modules/模块索引.md) 的“核心框架”。
-- 新增编辑器工具时，登记到 [模块索引](../modules/模块索引.md) 的“编辑器工具”。
-- 新增业务参考时，登记到 `business-reference/` 下对应项目目录，不进入主模块索引。
-- 框架内部规则优先写进对应框架模块文档，例如 UI 写入 [UI 框架](../modules/frameworks/UI窗口系统/README.md)。
-- 模块开始有独立设计、进度、任务时，再拆 `modules/<module>/`。
-- 新增或拆分模块后，同步检查 [架构说明](10-架构说明.md) 和相关模块文档。
-
----
-
-## 文档关系
-
-- `modules/模块索引.md`：项目模块总入口和事实表。
-- `modules/frameworks/*`：核心框架职责和框架使用规则。复杂模块拆分为文件夹，入口为 `README.md`。
-- `modules/<module>/业务参考总入口.md`：复杂模块稳定说明。
-- `modules/<module>/progress.md`：复杂模块阶段进度。
-- `modules/<module>/tasks.md`：复杂模块待办事项。
-- `rules/`：跨模块的通用规则、工作流、扫描范围和归档规则。
-- `business-reference/`：外部项目业务参考，不进入主索引。
-
----
-
-## 相关文档
-
-- [模块索引](../modules/模块索引.md)：按分类整理的模块详细索引。
-- [架构说明](10-架构说明.md)：总体分层、程序集边界和依赖方向。
-
----
+- 框架模块放入 `modules/frameworks/`。
+- 编辑器工具放入 `modules/frameworks/编辑器工具/`。
+- 外部业务案例放入 `business-reference/<project>/`，不作为框架规范。
+- 文档路径反映模块职责，不按一次性任务名称建立目录。
+- 一个模块的职责和入口由 README 完整定义，索引只保存摘要和链接。
 
 ## 文档关联
 
-> 当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。
-
 | 文档 | 关联原因 |
 |---|---|
-| [modules/模块索引.md](../modules/模块索引.md) | 模块索引是模块登记规则的唯一事实来源 |
-| [rules/10-架构说明.md](10-架构说明.md) | 分类口径、依赖方向与架构说明互相影响 |
-| [rules/项目规则入口.md](项目规则入口.md) | 模块登记规则是项目规则入口索引的关键规则 |
-| [modules/frameworks/*.md](../modules/frameworks/) | 框架模块的状态、拆分规则需与登记规则一致 |
+| [模块索引](../modules/模块索引.md) | 模块清单和状态的唯一事实来源 |
+| [架构说明](10-架构说明.md) | 模块分类与代码分层 |
+| [文档同步规则](50-文档同步规则.md) | 模块变化的同步条件 |
+| [模块文档模板](../modules/模块文档模板.md) | 新模块文档结构 |