Skip to content
Apothem
治理

对外合规登记册——在宿主项目上操作时

十五条强制规定登记册(M1–M15),规定在宿主项目中生成的所有制品的合规要求,并与生态系统内部强制规定交叉映射。

十五条生产强制规定的规范登记册。 本文档承载完整的十五条强制规定登记册(M1–M15)、琐碎与非琐碎阈值的裁定、M↔CM 交叉映射策略以及强制规定引入协议;实质性的枚举内容存放于此,由各强制规定对应的规则文件操作化。

当本生态系统在宿主项目(用户的调用目标——git 仓库、文档树、研究语料库、基础设施清单、便笺)中生成、编辑、重做、改造、扩展或移除任何制品时,每个产出的制品都满足下文声明的十五条强制规定标准(M1–M15)。这是不可协商的,并适用于每个生态系统表面(辅助件、助手、命令、钩子、响应、差异、消息)。强制执行通过预发布闸门进行(参见 site/content/docs/governance/pre-emission-gate-registry.mdx);机械化部分的强制执行存放于 src/apothem/conformity/*-grep.py,由 src/apothem/conformity/gate.py 编排。

这十五条强制规定按照并行词汇策略与 CM-N 强制规定并行运作(参见 site/content/docs/governance/cross-cutting-mandates.mdx);M 与 CM 是正交的治理维度(M 是对外轴——宿主项目制品;CM 是对内轴——生态系统内部制品)。下文列出的每条规则都是其强制规定的权威归宿;本登记册是索引。

ID强制规定一句话摘要权威规则
M1宿主项目无关性发现宿主的技术栈/格式化器/检查器/布局/惯用法;遵循它们;依 M5 将沉默作为询问浮现,并附 M7 标注src/apothem/rules/host-discovery.md
M2编辑纪律披露每一项修订/扩展/精炼并附理由;不得静默过度遵从,不得静默越界src/apothem/rules/disclosure-ledger.md
M3十项质量维度每个工件都须通过十项检查(严谨性、连贯性、可配置性、可读性、孤立性、结构性、架构、命名、学术引用、示例/测试/文档)src/apothem/rules/ten-dimension-check.md
M4自我应用在每次有实质范围的发出之前运行十五道预发布闸门;记录闸门结果src/apothem/rules/pre-emission-gate.md
M5权威原则询问,不臆造;身份/范围/偏好/安全/命名/基础设施/版本锁定数据永不捏造src/apothem/rules/authority-inquiry.md
M6专业知识融入读取意图,主动修订,在相邻缺口处扩展,以引用的理由精炼,预判二阶后果src/apothem/rules/expertise-posture.md
M7选项标注每个多选项选择都带有推荐标记加原则关联理由;在权威领域中禁止静默挑选src/apothem/rules/option-annotation.md
M8确定性与严密性在可作约束性规定之处不得含糊;不得在未枚举分支的情况下说“视情况而定”;每份契约都具备前置/后置/失败条件src/apothem/rules/definitiveness.md
M9视觉杠杆结构性主题承载一份反映当前实况的图示(默认为 Mermaid),附来源与验证日期src/apothem/rules/visual-leverage.md
M10双向绑定实质性结构元素声明互惠绑定(Drives → / Driven by ← / Satisfies → / Established by ↑ / Cross-bound with ↔)src/apothem/rules/bidirectional-binding.md
M11敏捷冲刺非琐碎的多步工作以有纪律的冲刺方式运行(目标/待办列表/就绪定义/完成定义/评审/回顾)src/apothem/rules/agile-sprints.md
M12阶段报告与规范布局多阶段工作输出每个子阶段的报告加阶段级汇总;输出位于规范布局src/apothem/rules/canonical-layout.md
M13代码工艺说明“为何而非何事”的注释;带单位且揭示意图的命名;类型化的异常处理;具名常量;遵循宿主的 lint/格式化/类型检查src/apothem/rules/code-craft-{python,shell,markdown,conventions}.md(按语言)
M14生态系统系统性新组件声明上游/下游/同级/执行者;在宿主登记册中编入索引;不引入孤岛,不引入孤儿src/apothem/rules/systemic-participation.md
M15生产就绪形态代码变更须在同一变更集中随附测试、文档、CHANGELOG 条目、合规的提交消息,并且 CI 通过src/apothem/rules/production-ready-prs.md

1. 琐碎与非琐碎阈值(已确定)

区分琐碎与非琐碎工作的阈值——非琐碎工作触发 M11 加 M12 装置——是行数加范围的混合:当一次变更是 ≤ 5 行的单文件编辑,且不引入公共 API 表面变更,也无行为变化时,该变更为琐碎。其余皆为非琐碎。按 M5 的一次确定纪律确定一次;该阈值在此处以用户范围存放,仅被遵循 M1 宿主发现的显式项目范围声明所覆盖(例如 Claude Code 的 <project>/.claude/CLAUDE.md,或另一工具的等效逐项目表面)。

2. M↔CM 交叉映射

每条 M 编号规则正文按并行词汇策略在其 Cross-bound with ↔ 绑定中内联声明其 CM-N 交叉映射:当某条 M 强制规定有最接近的 CM-N 类比时,两条规则在两者皆适用之处都适用(不替换)。这些映射内在于规则正文;本登记册概述轴策略而不重复映射表。

3. 强制规定引入协议

新增一条 M 编号强制规定(例如未来的 M16)是一次捆绑变更。只有当下方每个组件都出现在同一变更集中时,该捆绑才进入登记册。静默新增——在登记册表格中加入新的 M 行而无支撑捆绑——会产生强制规定轴漂移,并按 M14 系统参与性判定为不合规。

所需组件用途落地位置
登记册表格中的强制规定行命名该强制规定、其一句话摘要与其权威规则上方本登记册的表格
CM-N 交叉映射单元格依据 §2 并行词汇策略,声明最接近的 CM-N 类比(或将 (no direct CM-N analog) 标记为新轴)新规则的 Cross-bound with ↔ 行
权威规则正文该强制规定的实质性规范(前置条件/所需行为/披露表面/失败征兆/五向绑定)src/apothem/rules/<mandate-name>.md
预发布闸门行命名该关卡的检查种类(机械/推理判断/混合)及其 Failure → action预发布闸门登记册表格(site/content/docs/governance/pre-emission-gate-registry.mdx)
执行表面要么是由 gate.py 编排的、位于 src/apothem/conformity/<name>-grep.py 的机械 grep,要么是带有操作者自检锚点的显式推理判断关卡声明src/apothem/conformity/(机械)或标记为 reasoned 的闸门行(操作者自检)
合规夹具位于 tests/conformity-scenarios/fixtures/F-<N>-<name>/ 下、用于演练该强制规定失败模式的夹具;验证器的强制规定清单更新,以纳入新关卡tests/conformity-scenarios/
闸门结果模式更新闸门结果的 bars: 块新增该行;在重新审计之前,现有工件的闸门结果块将该新行视为 n/a (with reason: pre-mandate-N artifact)site/content/docs/governance/pre-emission-gate-registry.mdx §1 模式
披露账本条目记录该强制规定的引入,其理由扎根于具体驱动因素(观察到的模式复现;暴露的安全缺口;现有十五项未覆盖的能力)变更集的提交正文或 PR 描述,依 src/apothem/rules/disclosure-ledger.md

适用纪律。 没有捆绑就到来的强制规定提案在评审时被拒;提案者要么补全捆绑,要么将提案降级为对现有强制规定的扩展。现有十五条强制规定作为规范的对外轴一起被采纳;未来的新增遵循同样的“全部组件或不增加组件”的采纳节奏,而非零敲碎打地落地。

降级/退役协议。 当一条既有的 M-N 被发现与某条现有 CM-N 或另一条 M-N 冗余时(物化规则正文处的交叉映射覆盖图在两个方向上均显示 direct 邻接),降级即为其对称的逆操作:登记册行退役,闸门行退役,权威规则退役(其内容依 src/apothem/rules/clean-room-generation.md §3 重写协议并入吸收规则),合规夹具退役,闸门结果模式的 bars: 块删除该行,变更集则连同吸收规则的引用一并记录在披露账本中。降级保持同样的“要么全部组件、要么不增加组件”不变量。

On this page