文档维护约定

每次修改的必读入口

每次新增、修改或审查文档，先读取 endor-docs skill，并从手册入口选择主任务与必要补充任务。阅读所选任务页、必读方法、对应 DOC 规则和目标主题主定义后再动笔；小型改动不要求通读所有资源。
按任务页直接查询所需方法、规则、示例与注意事项；实际阅读对应小节，不能只列出编号或跳过阅读。该流程通过 Markdown 完成。
结构性改写至少核对 DOC-001、002、005、015、021、024；新增页面选择适合职责的模板，不要机械填充无关段落。
修改后按检查清单人工核对主定义、目录、文法、例子与规范状态。交付时记录适用规则及实际完成的检查。
用户未明确要求执行代码时，不运行程序、脚本、测试、构建或安装命令；skill、检查清单和现有工具都不能替代执行授权。用户明确要求的 commit、push 限于必要 Git 流程，不附带执行测试或项目 hook。
结构检查、人工语义核对、真实程序执行与读者测试分别报告；工具通过不代表例子已经运行。
文档规范不替代语言决定，不因润色、采用模板或 AI 续写而确认未定语法。
用户明确的新语言决定优先于旧文档，按 TASK-06 落实准确范围；用户使用 Endor 简称不自动触发正式名称与源码围栏更名。

只使用语言名称 Endorphin，不出现开发软件代称、版本或实现兼容说明。
文档定义源码与可观察效果，不以开发实现进度定义语言规则。
执行准备与检查阶段固定为 Preflight，运行阶段固定为 inflight，保持大小写；平台解释执行代码，不要求独立构建或字节码转译；定义见 guide/05-preflight-and-inflight.md。
两个阶段名称不自动成为源码关键字。新增语法说明必要的 Preflight 检查和 inflight 效果。
不设计云端实体、持久化类或自动建表。数据读取只是逻辑调用用法，不引入通信、缓存、部署与编排方案。
普通调用不要求业务代码额外定义 RPC 服务、监听器、协议客户端或接口描述文件。

key 采用 workspace handle:namespace路径，workspace handle 在平台内唯一，路径至少一级；资源归属 workspace，用户承担操作与作者身份，各层 namespace 语义一致。
归属通过外部 key 与索引提供，正文不声明自身 namespace。
use 只引用完整 key，不附加选择性名称列表。
官方 UI 组件不列为示例用户库的内容；未定的官方引用方式不可写成免导入默认能力。
示例围绕商品定价展开，标明外部归属与片段位置；局部片段不能混写为完整程序。
名称查找、可见性和数据读取成员的假设明确说明，不虚构未确认 API。
已确定约定、语法提案和未定义边界统一记录在 appendices/specification-status.md；文档重构不代表语法提案被确认。
界面由普通函数返回可渲染值表达，不使用 scene 声明或 render 块；共用程序和表达式文法，不补造专用节点语法或单根限制。
资源访问与呈现的主定义见 guide/11-resource-access-and-presentation.md。顶级类型的名称、继承或协议关系与展示契约保持待定，不为示例补造正式类型。
不采用结构类型兼容；用户声明的类型按声明身份区分，不因字段或方法相同自动兼容或实现能力。类型身份与兼容的主定义见 guide/07-types-and-classes.md。

保留其他作者的未提交改动；共享链接使用仓库相对路径，不依赖本机目录或会话历史。
对 gitea.entroia.com 的操作只认证为 codex-bot。仓库 owner 不代表认证身份，不借用 owner 的账户、密钥或凭据。
在本仓库范围配置提交作者为 Codex Bot、codex-bot@gitea.entroia.local；SSH 使用 git 用户、22222 端口和 bot 专用密钥，以 -F /dev/null 与 IdentitiesOnly=yes 隔离其他身份。
密钥和其他认证材料只在各电脑安全配置，不写入仓库。权限不足时完成可进行的本地工作，再申请 bot 权限。
仅在用户授权时提交或推送，不强推覆盖远端。每次提交或推送后的中文报告覆盖所有改动文件及目的，并说明提交标识、推送状态、检查结果和未完成步骤。
完整协作流程见 CONTRIBUTING.md。