Files
Agent-System/.doc/ops/lessons/2026-09-23-matrix-status-cas.md
T
weichen 1d3c957ff4 docs(ops): close matrix regression issue after CAS restore
Mark issue resolved and lesson validated once arch-check and MATRIX
done row are confirmed in the task worktree.
2026-09-23 15:05:27 +00:00

1.7 KiB
Raw Blame History

lesson_id, lesson_state, owner, reviewer, last_reviewed, reviewed_revision, source_issues, keywords
lesson_id lesson_state owner reviewer last_reviewed reviewed_revision source_issues keywords
LESSON-20260923-matrix-status-cas validated Cursor Cursor (source review + arch-check) 2026-09-23 b9d09c9712
ISSUE-20260923-matrix-status-regression
FEATURE-MATRIX
docs-apply
record_id
merge-conflict
CAS
planned
done

共享矩阵状态变更必须走 docs apply,合并后核验状态列

触发:改 FEATURE-MATRIX / CURRENT 行状态,或合并含这两份文件的候选时。

机制与来源:ISSUE-20260923-matrix-status-regression。A–G 代码已合入且曾标 done,closeout 合并冲突手解取旧侧把状态盖回 planned,误导后续会话。

开发检查:

  1. 不直接编辑 FEATURE-MATRIX / CURRENT 表行;用 agentctl docs snapshot + docs apply(MATRIX 键为 record_id)。
  2. 升 done 须 docs:approve 与已提交 evidence 路径(门禁 EVIDENCE_REQUIRED)。
  3. 合并含共享文档的候选后,对目标 record_id 再 docs snapshot 或 grep 核验状态列未被回退;冲突手解禁止静默取旧侧。

验证方式:本轮对 module-batches-ag 做 apply 收据 + arch-check --mode block PASS;未新增自动化 CI。manual。

适用边界:仅协调 SSOT(CURRENT / FEATURE-MATRIX);普通 .doc 短文仍可租约内直接改。不覆盖 gap-matrix 发布门禁语义。

防护落实:scripts/agentctl.py 已对 MATRIX done 要求 evidence;本条强调合并后人工/脚本核验。仍缺:merge 后自动断言关键 record_id 状态(待治理任务)。

修订:2026-09-23 新建;同日 apply 恢复 + arch-check 后升 validated。