Files
git-learn/openspec/changes/archive/2026-09-18-migrate-devflow-archives/proposal.md
T
zhuyongxin 24a71e78f1 Harden dev-flow: pre-authorization marker, alternatives log, check script
- Record rejected answers in decision.md at the moment they are rejected

- Allow explicit pre-authorized Build via a pre-authorized marker line

- Land scripts/check-dev-flow.sh and derive devflow/index.md from archives

- Add dev-flow process artifacts (decisions, prd) for open changes
2026-09-18 18:23:18 +08:00

1.8 KiB

Why

dev-flow 重设计(2026-09-18)取消了 devflow 作为独立档案层的定位:决策档案唯一落点为 openspec/changes/<slug>/decision.md,随归档冻结;devflow/ 收缩为 glossary + rejected + 派生 index。历史遗留 9 个项目、37 个文件需要按新布局处置,否则新旧两种真理源布局长期并存。

SuperBizAgent-java 实测(46 项目/180 文件)已给出处置口径:压缩 Q&A 与 ADR 段落并入对应归档的 decision.md,骨架文件删除。本仓库先以单样本(2026-05-18-knowledge-index-panel)验证规则,再定批量执行。

What Changes

  • 为 openspec/changes/knowledge-index-panel/ 新建 decision.md:内容迁移自 devflow/projects/2026-05-18-knowledge-index-panel/adr/0001-directory-name-as-truth-source.md(五节俱全),标注迁移来源
  • knowledge-index-panel-prd.md 含独有内容(User Stories、测试决策),收存为 openspec/changes/knowledge-index-panel/prd.md
  • 更新 devflow/glossary/CONTEXT.md 中对 ADR-0001 旧路径的引用,指向新位置
  • 本 change(migrate-devflow-archives)自身按 dev-flow 协议执行,其 decision.md 记录迁移规则本身
  • 其余 8 个项目:本次不动(见 Non-Goals)

Non-Goals

  • 不批量迁移其余 8 个项目——单样本验证规则后另行执行
  • 不删除 devflow/projects/ 下任何现有文件——删除等批量规则稳定后统一处理
  • 不处理 3 个活跃 change 中另外两个(add-year-filter 已有 decision.md;sm-flow-execution-hardening 待其自身 Close)

Impact

  • openspec/changes/knowledge-index-panel/ 新增 2 文件(decision.md、prd.md)
  • devflow/glossary/CONTEXT.md 改 1 处链接
  • scripts/check-dev-flow.sh knowledge-index-panel 应由 ✗ 转 ✓
  • 迁移规则沉淀在 openspec/changes/migrate-devflow-archives/decision.md,作为后续批量迁移的依据