内容	唯一主要位置	同步入口
目录职责、直接子文件／子目录、常见修改位置	该目录 README.md	父目录 README
各 crate 的依赖方向和系统边界	architecture/README	根 README、docs 索引摘要
对象头、句柄、引用协议与 GC 算法	objects.md	core/src 文件表
Number、String、Dict、Cell、函数环境和异常数据	builtins.md	core/src 与 tests 文件表
指令编码、栈效果、调用协议与执行限制	bytecode.md	instruction／code／frame／eval 文件职责
VM／帧／对象的创建、错误退出与销毁	lifecycle.md	对象与字节码主题链接
环境变量、默认值、优先级、UTF-8、locale 和配置边界	configuration.md	相关 crate README 链接
运行命令、端点和宿主存储行为	operations/README	cli／server／storage README
镜像、CI、部署、回退和数据目录	deployment.md	scripts／工作流 README
检查入口、覆盖范围、结果边界	validation.md	各 tests README
不可变研究表、聊天导出、临时脚本或构建产物	工作区外输出或忽略目录	不作为当前项目契约、不提交研究 HTML

相同规则不要整段复制到多个 README。局部 README 解释本地内容并指向全局契约；全局主题用链接定位实现，不再维护第二份完整源文件表。

每次修改时同步

新增、删除、重命名文件或目录：更新本目录和父目录 README 的文件表；新增受版本管理目录必须有 README。该规则不覆盖 .git、target、data、work、outputs 或其他忽略产物。
修改 API、默认值、所有权、操作码或错误处理：同时修改上表对应主题、示例与相关检查；区分已实现行为和未来设计。
改主题路径：修复仓库所有内部链接，更新 docs 总索引；失效旧页直接删除，不长久保留一份旧契约。
改宿主配置／部署：同步配置表、运行命令和脚本 README；不把更换应用容器写成恢复 VM 堆或数据库回退。
检查链接、目录覆盖、旧路径和差异空白；仅在指定远端运行行为测试。没有查询 CI 结果就写未核实，不能继承上次通过的结论。

不是每次提交都要给所有文档改日期或复制版本号；只有相关内容发生变化时更新相应文档。提交及代码审查描述说明目的和验证，文档保留长期可查询的当前行为。

当前实现边界

Core 保持零外部依赖、不引入 Python type／元类、源码前端或宿主库。句柄构造保持私有；非法句柄检查放堆内部单元测试，不能为测试开放非法构造器。容器更新须经过 VM 的引用事务；call／execute 对象结果持有根，借用读取仍须由使用方按需 retain。

Rust 实现依赖模块可见性、trait 和 rustfmt，不照搬 CPython C 符号命名规范。公开导出集中在 core/src/lib.rs，内部协作用 pub(crate) 或私有方法区分。当前没有 Endor 源码风格规范或通用配置框架。

后续优先按实际需求扩充函数定义／迭代器等指令、宿主回调、错误传播和资源边界；新增前端或云服务机制需要相应设计，不写成既有功能。

本轮把 outputs 的字节码及基本对象说明核对后融合入 runtime 主题。以后只维护仓库正文；需要分享时导出副本，副本注明仓库权威位置，避免继续平行编辑。CPython 284 项研究 HTML／Markdown 仍是独立研究材料，不上传 Git。

旧平铺路径 docs/architecture.md、development.md、endor-object.md、endor-builtins.md、bytecode-vm.md、validation.md 已由新的多层主题替代；当前入口以文档索引为准。