66
77以下顺序是硬约束。前一项未稳定前,不进入后一项实现。
88
9- > ** 对齐原则** :Sopify 总方向是 Protocol-first / Validator-centered / Runtime-optional。主航道的每一步都是"先 formalize protocol/validator 层契约,再让 runtime 作为参考实现消费"。不以 runtime 内部治理为驱动。
9+ > ** 对齐原则** :Sopify 总方向是 Protocol-first / Validator-centered / Runtime-optional。主航道的每一步都是"先 formalize protocol/validator 层契约,再让 runtime 作为参考实现消费"。不以 runtime 内部治理为驱动。蓝图变更优先做能强化证据与授权层的事,优先做能让外部宿主看懂、接入、被验证的事;AI + 单人维护应串行收敛,不同时开多条线。
1010
1111> ** 先行切片例外** :以下两类改动不受上述顺序约束:① 已在后续里程碑描述中显式标注"可先行"的 presentation-only 切片;② 已证明不影响 protocol / validator / runtime machine contract 的纯展示层改动。除此之外,任何涉及契约面的工作必须等前置里程碑稳定。
1212
@@ -66,6 +66,16 @@ ADR-017 的直系后续。不要求落地完整 ExecutionAuthorizationReceipt
6666- 产出:可实现的 authorization contract spec(不一定是完整实现,但足够让后续 P2 的动作层基于此收敛)
6767- ** 字段命名对齐** :protocol.md 使用 ` revision_digest ` (通用 subject identity),ADR-017 使用 ` plan_revision_digest ` (plan 特化)。P1.5 需明确两者关系:` plan_revision_digest ` 是 ` revision_digest ` 在 plan subject 场景的特化命名,实现时不得混用
6868
69+ ** 可先行切片(presentation-only / protocol 下界验证,不改 machine contract):**
70+
71+ - ** Convention 入口兑现(窄切片)** :README 增加 non-runtime quickstart 路径(基于 protocol.md §4 样例 A);将 protocol.md §5 合规检查清单转化为面向外部宿主开发者的接入指南段落。不新增 CLI 面(不做 ` sopify init --minimal ` ),用文档/模板/示例目录兑现。验收:外部宿主开发者只读 README + protocol.md 即可完成最小合规(≤3 步)
72+ - ** Protocol Compliance Suite Phase 1** :在 ` evals/ ` 或 ` tests/protocol/ ` 建立最小合规断言套件,严格对齐 protocol.md §5(能读 blueprint、能写方案包、能归档 + receipt)。实现方式:文件结构存在性 + 必需字段断言(脚本级)。不覆盖 knowledge_sync / blueprint writeback(Convention 下界中是"推荐"不是必选)。不做 headless behavioral test(那是长期方向)。验收:一组可自动化运行的断言,输入 ` .sopify-skills/ ` 目录,输出 pass/fail
73+ - ** 低风险辅助层预清理** :清理不改变 machine truth 的非核心增强模块(例如单点引用、独立测试覆盖的体验增强层)。不碰决策资产、预检契约、恢复语义、上下文骨架、gate/state/handoff 主链。具体文件清单和执行顺序由当期方案包定义。验收:删除后全量测试通过 + 无 import 断裂
74+
75+ ** P1.5→P2 桥接切片(涉及 protocol 层契约升格,需 P1.5 授权脊柱稳定后执行):**
76+
77+ - ** Verifier minimum normative slice** :将 protocol.md §6 Verifier 子段从 informative/draft 升格为 normative。最小 normative 字段:` verdict ` (passed/failed/warning/info) + ` evidence ` + ` source ` (RFC 2119 表述);` scope ` 保留 recommended。明确 Verifier 输出消费路径:verdict 作为 Validator 授权判定的风险因子,evidence 挂载在 handoff/receipt 中。不定义 evidence attachment 完整 schema,不扩 canonical 预算。外部启发:HelloAGENTS 交付证据链(contract.json / review.json),准入 T1 Adoption
78+
6979### P2: Local Action Contracts on Bound Subjects
7080
7181在主体已绑定(P1)、授权脊柱已规划(P1.5)的前提下,收敛局部动作 contract。
@@ -74,6 +84,7 @@ ADR-017 的直系后续。不要求落地完整 ExecutionAuthorizationReceipt
7484- 动作层只消费已绑定主体,不再承接主体歧义
7585- 每个动作的 ActionProposal 必须携带 subject identity,validator 基于此做 admission
7686- 不回头吸收主体歧义问题——如果主体不清,回到 P1 的 subject resolution 链路
87+ - ** side_effect delta 语义(file-level 第一版)** :ActionProposal ` side_effect ` 当前是自由文本,无法被 Validator 结构化消费。引入 file-level delta 标注:` [{path, change_type: added|modified|removed}] ` 。不要求 module/function 级 scope(对单人维护太细),不引入 OpenSpec 的 specs/changes 工作区模型——只吸收"变更语义化描述"的标准。外部启发:OpenSpec ADDED/MODIFIED/REMOVED delta 语义,准入 T1 Adoption
7788
7889### P3a: Contract-Aligned Surface Cleanup
7990
@@ -84,6 +95,8 @@ ADR-017 的直系后续。不要求落地完整 ExecutionAuthorizationReceipt
8495- 清理 failure recovery / deterministic guard / decision tables 中基于旧 contract 的分支
8596- 清理 state 文件中超出 canonical budget 的遗留面
8697- 不新增 checkpoint type、不扩 ActionProposal schema、不重做 gate 架构
98+ - ** knowledge_sync audit trail** :archive receipt 增加 ` knowledge_sync_result ` 可选字段(实际同步了哪些 blueprint 文件、sync 级别、变更摘要)。先做 receipt 记录("记账"),不做 validator 阻断("判责"等后续里程碑)
99+ - ** Runtime 正式减重** (目标 ~ 27K→<20K):以 canonical surface 收敛为驱动,删旧分支、剪恢复厚度、裁兼容防御、按 canonical 输入薄化上下文层、裁窄观察面。蓝图定义删减原则与边界;模块级删除清单、执行顺序和验证方式由当期方案包定义。不新增模块、不重构 engine 架构
87100
88101### P3b: Presentation & Projection Cleanup
89102
@@ -94,6 +107,7 @@ ADR-017 的直系后续。不要求落地完整 ExecutionAuthorizationReceipt
94107- 清理 handoff/output/replay 旧兼容投影
95108- 清理 tests 中只验证旧概念的断言
96109- 清理 prompt 中直接引用已 sunset 的旧 contract 的段落
110+ - ** Runtime 减重外围清理** :清 tests / prompt / projection / installer / docs 中对 P3a 已删 surface 的引用残留,防止 runtime 瘦了但外围契约残留继续拖累维护
97111
98112### P4: Host Consumption Governance
99113
@@ -125,8 +139,10 @@ ADR-017 的直系后续。不要求落地完整 ExecutionAuthorizationReceipt
125139- [ ] Multi-host review contract 正式化(protocol.md §7 从 informative/draft 升级为 normative)— 部分由 P1 subject identity 升格推进
126140- [ ] 方案级收敛语义操作化(risk ladder + 验证深度规则 + 多审查者冲突解决)
127141- [ ] 轻量化产品指标与 acceptance gate(首次上手步骤数、必需文件数、默认 workflow 必需 contract 数)
128- - [ ] Convention 入口兑现差距:Convention 下界已在 protocol.md formalize 并通过 smoke,但仓库默认产品入口(README / install / quickstart)仍偏 runtime-first;在将 Convention 作为外部主入口前,需补足 validator-first onboarding、non-runtime quickstart 与配套 smoke
142+ - [ - ] Convention 入口兑现差距 → 已转入 P1.5 可先行切片,非落地完成
129143- [ ] 产品层 ↔ 实现层 contract matrix 正式化(ownership / admission / lifecycle responsibilities)
144+ - [ ] Protocol Compliance Phase 2:在 Phase 1 文件断言之上,参考 Superpowers headless behavioral test 做端到端行为验证;扩展 Convention smoke 到完整最小生命周期(含 knowledge_sync / blueprint writeback)。外部启发:Superpowers headless Claude 测试,准入 T1 Adoption
145+ - [ ] 第三方宿主自助接入 Convention 证明:不指定下一个官方深适配目标,先把 Convention quickstart + compliance check 做出来,再由外部宿主自行验证接入
130146
131147## 明确延后项
132148
@@ -137,3 +153,6 @@ ADR-017 的直系后续。不要求落地完整 ExecutionAuthorizationReceipt
137153- [ -] ~ replay 更多入口
138154- [ -] runtime 独立 preferences_artifact
139155- [ -] 偏好自动归纳/提炼
156+ - [ -] ` sopify init --minimal ` 等新增 CLI 面(Convention 入口优先通过文档/模板兑现)
157+ - [ -] 知识自动提炼(Hermes Agent persistent memory + curator 方向,T0 Reference;与 runtime 全接管、偏好自动归纳有直接张力)
158+ - [ -] 声明式工作流引擎(Spec-Kit YAML workflow engine 方向,T0 Reference;与 Runtime-optional 有张力)
0 commit comments