feat: persist system constraints in root CONTEXT.md

README.md

@@ -4,7 +4,7 @@
 
 | Skill | 用途 | 产出 |
 | --- | --- | --- |
-| `align-plan` | 调查代码、每轮提问 1–3 个问题、核对假设并收敛范围 | 当前决策与用户确认后的可执行计划 |
+| `align-plan` | 调查代码、每轮提问 1–3 个问题、核对假设并收敛范围 | 系统约束、当前决策与用户确认后的可执行计划 |
 | `execute-plan` | 按已确认计划实施、验证、核对范围和 review | 外部实施记录与本地 Git commit |
 
 ## 安装
@@ -50,6 +50,7 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简
 
 ```text
 资产根目录/
+  CONTEXT.md                     跨计划的业务与设计约束及原因
   日期-计划主题/
     current.md                   当前目标、确认决策、约束与未决问题
     plan-v1.md                   已确认、自包含的计划
@@ -58,6 +59,12 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简
 
 新的批准版本另存。当前决策随讨论更新，不累计聊天全文；执行记录不能覆盖已批准计划。目录失效或无法写入时会报告，不自行改存代码库。个人绝对路径不写入可分发的 skill。
 
+两个 skill 在确定资产根目录后都先读取 `CONTEXT.md`，再针对本次目标核实相关代码；新会话或上下文恢复时同样读取，无需扫描历史计划。根目录默认对应一个系统；若文档属于其他系统，先澄清。用户只指定计划目录时，保留已知系统根目录，未知则询问，不推断父目录。
+
+`CONTEXT.md` 按业务约束、设计约束记录长期决策、适用范围和简短原因。用户确认后立即沉淀，分为“当前有效”和“已确认待生效”；需要实施的约束经实施、验证和 review 完成后才生效，失败或部分完成时保留待生效状态。存在冲突时先确认如何修订，不自行覆盖。
+
+该文件不记录任务清单、实现代码、日志或完整历史。`current.md` 保留本次讨论与未决问题；计划保留本次相关约束的快照，执行记录保存进度和证据。CONTEXT 不存在时从首次确认的长期约束开始建立，不回扫历史计划。执行 agent 的局部实现选择不自动变成系统约束。
+
 每份生成的 Markdown 资产（包括本地 MEMORY）顶部保留以下 YAML 元数据：
 
 ```markdown
@@ -70,6 +77,8 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简
 
 系统填写项目或系统名称，目标概括对应计划的目标，无法确定时留空。时间对应资产所依据的决策，使用用户当地日期。未确认草稿先记创建日期，正文标明待确认；确认后更新为确认日期。已批准计划保留原日期，新版本使用新确认日期；实施记录沿用计划决策日期，执行时间单独记录。纯进度或排版更新不改决策日期。
 
+CONTEXT 的目标填写“保存系统长期有效的业务与设计约束”，时间为最近一次确认系统决策的日期；仅变更生效状态不修改该日期。
+
 ## 验证
 
 结构检查：
@@ -82,6 +91,8 @@ npx skills add . --list
 
 行为检查应使用真实 agent 在隔离项目中演练：目录首次询问与复用、错误假设纠正、长对话恢复、目标分阶段、批准前不实现、新会话交接、必要配套文件与范围扩展的区别、过期计划、测试覆盖与重复、已有用户修改及提交隔离。
 
+系统上下文还需检查：首次无 CONTEXT、下次直接读取、确认后立即记录、待生效与当前规则并存、冲突澄清、执行失败不生效、验证后生效、局部实现细节不写入系统约束。
+
 结构验证只能检查格式和可发现性；静态场景复核只能发现指令缺口。两者都不证明模型实际遵循工作流，实际行为需要另行记录演练证据。不要把文字规则当作宿主级权限隔离。
 
 ## 参考来源
@@ -92,4 +103,6 @@ npx skills add . --list
 - [Superpowers](https://github.com/obra/superpowers)：参考 brainstorming 的确认边界、writing-plans 的文件与验证说明、executing-plans 的计划复核。
 - [Matt Pocock Skills](https://github.com/mattpocock/skills)：参考 grill-me / grilling 的先调查事实、再讨论决策。这里限制每轮 1–3 问，以目标和验收收敛，不要求穷尽所有分支。
 
+另外参考 [domain-modeling](https://github.com/mattpocock/skills/blob/main/skills/engineering/domain-modeling/SKILL.md) 在讨论中持续沉淀的机制。上游 CONTEXT 限于术语表、设计决策另存 ADR；本项目按需要将长期业务与设计约束直接保存在外部 CONTEXT，不引入 ADR 框架。
+
 上游工作流会变化；本仓库的实际规则以两个 `SKILL.md` 为准。