@namewta/speculo 1.0.24 → 2.0.1

package/template/workflows/specdev/manifest.json

@@ -1,10 +1,11 @@
 {
-  "schema_version": 1,
+  "schema_version": 2,
   "id": "specdev",
   "version": "1.0.0",
   "persistent_knowledge": [
     "<Path>{roots.state}/specdev/adr/</Path>",
-    "<Path>{roots.state}/specdev/context/</Path>"
+    "<Path>{roots.state}/specdev/context/</Path>",
+    "<Path>{roots.state}/specdev/design/</Path>"
   ],
   "stages": [
     {
@@ -93,5 +94,53 @@
       "risk": "read-only",
       "context_budget": 10000
     }
-  ]
+  ],
+  "entry": "SKILL.md",
+  "works": [
+    "specdev-a-archive-and-consolidate/SKILL.md",
+    "specdev-c-code-review/SKILL.md",
+    "specdev-d-diagnose-bugs/SKILL.md",
+    "specdev-g-grill-with-docs/SKILL.md",
+    "specdev-i-implement/SKILL.md",
+    "specdev-i-init-setup/SKILL.md",
+    "specdev-l-learn-change/SKILL.md",
+    "specdev-p-goal-plan/SKILL.md",
+    "specdev-p-prototype/SKILL.md",
+    "specdev-r-retro/SKILL.md",
+    "specdev-r-review-architecture/SKILL.md",
+    "specdev-s-spec/SKILL.md",
+    "specdev-t-tickets/SKILL.md",
+    "specdev-t-triage/SKILL.md",
+    "specdev-w-wayfinder/SKILL.md"
+  ],
+  "work_stages": {
+    "specdev-c-code-review/SKILL.md": [
+      "review"
+    ],
+    "specdev-i-implement/SKILL.md": [
+      "implementation",
+      "repair",
+      "verification",
+      "integration"
+    ],
+    "specdev-p-goal-plan/SKILL.md": [
+      "plan",
+      "run",
+      "resume",
+      "replan",
+      "verify"
+    ],
+    "specdev-a-archive-and-consolidate/SKILL.md": [],
+    "specdev-d-diagnose-bugs/SKILL.md": [],
+    "specdev-g-grill-with-docs/SKILL.md": [],
+    "specdev-i-init-setup/SKILL.md": [],
+    "specdev-l-learn-change/SKILL.md": [],
+    "specdev-p-prototype/SKILL.md": [],
+    "specdev-r-retro/SKILL.md": [],
+    "specdev-r-review-architecture/SKILL.md": [],
+    "specdev-s-spec/SKILL.md": [],
+    "specdev-t-tickets/SKILL.md": [],
+    "specdev-t-triage/SKILL.md": [],
+    "specdev-w-wayfinder/SKILL.md": []
+  }
 }

package/template/workflows/specdev/runtime-contract.json

@@ -1,11 +1,12 @@
 {
   "schema_version": 1,
   "workflow": "specdev",
+  "state_seed": "optional",
   "config": {
     "path": ".speculo/specdev/config.json",
-    "template": "workflows/specdev/I-init-setup/config-template.json",
+    "template": "workflows/specdev/specdev-i-init-setup/assets/config-template.json",
     "baseline": ".speculo/baselines/workflows/specdev/config.json",
-    "schema_version": 6,
+    "schema_version": 7,
     "optional": true,
     "additional_properties": {
       "": false,
@@ -18,11 +19,10 @@
     }
   },
   "structured_state": [
-    ".speculo/specdev/status.json",
-    ".speculo/specdev/changes/*/.status.json",
-    ".speculo/specdev/archive/*/*/.status.json",
+    ".speculo/specdev/changes/*/README.md",
+    ".speculo/specdev/changes/archive/*/README.md",
     ".speculo/specdev/changes/*/goal-plan.md",
-    ".speculo/specdev/archive/*/*/goal-plan.md"
+    ".speculo/specdev/changes/archive/*/goal-plan.md"
   ],
   "opaque_default": "preserve-byte-for-byte"
 }

package/template/workflows/specdev/specdev-a-archive-and-consolidate/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: specdev-a-archive-and-consolidate
+description: "核对并封存已完成或取消的 change，或独立审计维护 ADR、context 与当前 docs；拥有项目设计基线批准与提升网关，仅在用户明确要求时从代码访谈形成知识 change。"
+metadata:
+  speculo-kind: work-skill
+  speculo-id: specdev/archive-and-consolidate
+  speculo-domain: specdev
+  speculo-contract-version: "2"
+---
+
+# 归档与沉淀
+
+激活后读取 <Path>{roots.workflows}/specdev/common/rules/domain-runtime.md</Path>，按 <Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path> 定位有关知识。A 拥有收尾执行与知识网关；整体完成/取消仍由原完成 owner 判定，A 不代替用户取消。
+
+## 选择范围
+
+- **archive-single / archive-batch**：用户指定 completed/cancelled 对象；batch 必须明确请求并固定清单。无候选返回 no-candidates，不创建 change。
+- **knowledge-audit / knowledge-maintenance**：按用户指定主题检查/维护既有知识，无需新 change；只读审计默认会话结果。
+- **consolidate-from-code**：明确要求从代码访谈形成新知识，按 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/consolidation-interview.md</Path> 建立真实验收载体，验证后结束并走归档。
+- **mechanical-only**：已有仍有效的四类资产核对结果，或用户明确只授权移动时使用；不能默认为未读材料都无需维护。已知直接相关错误仍须处理或阻塞移动，未授权知识写入保留建议。
+
+项目 DESIGN 首次 bootstrap 与后续 promotion 只经 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/design-knowledge-gateway.md</Path>。P 完整批准包的窄调用保持 P owner、不启动归档；无 change 的维护不新增第三种设计发布模式。
+
+## 流程
+
+独立 knowledge-audit/knowledge-maintenance 直接按主题和真实来源执行第 3～5 步，不读取不存在的 change、完成门或远程交付账本，也不执行第 6 步。knowledge-audit 只返回候选和依据；维护仅写具体授权范围。下列第 1～2、6 步是归档分支。
+
+1. 定位根、具体对象和原 owner；读取 README Outcome 与必要依据。归档读取 <Path>{roots.workflows}/specdev/common/rules/change-completion.md</Path>，核验 completed 或 cancelled 分支；父子关系存在才读取 <Path>{roots.workflows}/specdev/common/rules/parent-implementation-orchestration.md</Path>。未完成父实现的成员不能封存；移动前以 `--stage archive-ready` 核验结束与封存门，移动后运行 archived。
+2. 核对已承诺的 triage `external_action`/`publish_action` 与 PR 交付；pending/failed/未知结果返回原 T 入口，未请求不造空账本。取消必须具备真实决定、writer 停止/交接、未交付及已落地影响、依赖和外部动作处置。
+3. 按 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/operation-contract.md</Path> 形成一份收尾计划：基础四类 change、ADR、context、当前 docs 各有有变更/无变更及依据；涉及 UI 再核对 DESIGN。只读 dry-run 不写文件。知识筛选读取 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/knowledge-graduation.md</Path> 和 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/consolidation-rules.md</Path>，清理候选才读 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/cleanup-rules.md</Path>。
+4. 核对并复用具体批准，固定写集、来源、before-image、摘要、预期结果与恢复检查点；只对新增副作用/范围/漂移补确认。实际 docs 维护直接使用 <Path>{roots.references}/writing-for-agents/references/current-facts-docs.md</Path>；不调用 docs-sync 全局扫描/Git/state。
+5. 先维护现役 docs/ADR/context，必要时经 DESIGN 网关发布，再核验当前资产/引用并执行已批准清理。每项回读，必需维护未完成就保留 change 不移动。completed 不证明每条设计规则 implemented，cancelled 不满足 implemented promotion 门。
+6. 最后按 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/archive-rules.md</Path> 整体无覆盖移动至新 archive，从实际目标验证完整性、来源与设计绑定；完成原回执后才宣布封存。失败保留已落地事实和恢复点，不重复移动/发布，不宣称整体原子回滚。
+
+## 完成与恢复
+
+返回 `no-candidates | dry-run | verified | partial | blocked`，附固定范围、四类资产及适用 DESIGN 结论、实际验证与原回执 locator。Command 调用由 Command 保存唯一总报告；直接有 change 的 confirmed 调用使用 change 内 archive-receipt；无 change 仅在恢复确需时使用 maintenance 回执，具体位置由 operation-contract 定义。
+
+只有本次获批范围全部动作与检查完成才 verified；没有知识晋升是合法结果。未毕业材料随 change 保留。封存后只读，纠错用外部补充记录或后继对象；不可变 revision、批准、研究和许可不顺手整理。永久写入与移动的权限来自真实批准，文档标记不能授权。

package/template/workflows/specdev/specdev-a-archive-and-consolidate/assets/archive-plan-template.md

@@ -0,0 +1,32 @@
+# 本次收尾
+
+范围：<固定对象/主题、archive-single/archive-batch/knowledge-maintenance>
+Owner 与依据：<实际会话/原计划 locator>
+结论门：<completed/cancelled 的原工件及验证，或独立维护依据>
+授权：<真实请求、具体目标/动作/范围、时间及原批准摘要>
+
+## 资产计划
+
+| 资产 | 源/目标 | 动作或无变更依据 | 内容 owner / 执行 owner | 批准与 before-image | 验证/恢复 |
+|---|---|---|---|---|---|
+| change | <稳定名称和实际位置> | <移动/保留> | <owner> | <依据> | <完成/取消、依赖与外部门> |
+| ADR | <相关条目> | <新建/纠错/部分替代/完整替代/无变更> | <owner> | <依据> | <理由/负向保证/恢复义务承接> |
+| context | <相关条目> | <维护或无变更> | <owner> | <依据> | <旧数据与兼容范围> |
+| docs | <唯一负责文档> | <当前事实修正或无变更> | <owner> | <依据> | <实际命令/链接/未验证> |
+| DESIGN（相关时） | <current/revision/candidate> | <网关动作/跳过> | <A/来源 owner> | <不可变批准及摘要> | <来源、原型、发布恢复> |
+
+## 执行检查点
+
+按 A0–A8 记录实际结果：固定范围 → 具体批准及原件 → 现役 docs/ADR/context → 适用 DESIGN → 引用和批准清理 → 最后无覆盖移动 → 目标消费者验证 → 原回执完成。每步填写真实命令/退出码、已落地路径、未完成项；不预填通过。
+
+源：<Path>{roots.state}/specdev/changes/{change}/</Path>
+目标：<Path>{roots.state}/specdev/changes/archive/{change}/</Path>
+移动能力：<无覆盖、同文件系统、单写入者/隔离证据>
+
+## 恢复与余项
+
+<原 owner、原批准/输入摘要、before-image、实际唯一位置、下一核验步骤与不可自动回滚的结果。完成封存后只写外部补充，不改历史。>
+
+## 实际归档时的结果段
+
+confirmed 且进入移动分支后，按 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/archive-receipt-contract.md</Path> 在此原回执添加每个对象的唯一 anchor、批准引用和摘要、原/目标路径、真实 Result 与完整性清单。A7 的 moved 不代表封存，A8 的 verified 还须通过 archived --sealed。独立知识维护或 dry-run 不生成空移动结果段。

package/template/workflows/specdev/specdev-a-archive-and-consolidate/assets/cleanup-candidate-template.md

@@ -0,0 +1,69 @@
+# Cleanup Candidates
+
+> 生成时间：<YYYY-MM-DD HH:MM>
+> Workflow：<workflow-name>
+> 扫描 store 数：<N>
+> 候选总数：<N>
+
+## 分类摘要
+
+| 分类 | 数量 |
+|------|------|
+| delete | <N> |
+| merge | <N> |
+| rewrite | <N> |
+| keep | <N> |
+| needs-confirmation | <N> |
+
+---
+
+## Delete 候选
+
+| # | 文件/条目 | 理由 | 风险 | 最后引用日期 |
+|---|----------|------|------|------------|
+| 1 | `<Path>{roots.state}/specdev/adr/0001-old-auth.md</Path>` | 冗余副本；来源、引用及保留义务已核对 | low | 2026-06-01 |
+| 2 | `<Path>{roots.state}/specdev/context/legacy-term.md</Path>` | 代码和 archive 中无引用证据 | low | — |
+
+---
+
+## Merge 候选
+
+| # | 源 | 目标 | 理由 |
+|---|-----|------|------|
+| 1 | `<Path>{roots.state}/specdev/adr/0002-timeout.md</Path>` | `<Path>{roots.state}/specdev/adr/0005-timeout-v2.md</Path>` | 主题相同（超时处理），0005 更完整，合并并注明来源 |
+| 2 | `context/` 中重复的规则描述 | `adr/` 对应决策 | 保留 adr/ 为权威版本，context/ 中改为指针 |
+
+---
+
+## Rewrite 候选
+
+| # | 文件/条目 | 当前问题 | 建议改写 |
+|---|----------|---------|---------|
+| 1 | `<Path>{roots.state}/specdev/context/terms.md#term:Session</Path>` | 含相对时间"两个月前上线" | 改为绝对日期"2026-05-15 上线" |
+| 2 | `<Path>{roots.state}/specdev/adr/0002-caching.md</Path>` | 格式不符合 ADR 模板 | 补全"后果"部分 |
+
+---
+
+## Needs-Confirmation 候选
+
+| # | 文件/条目 | 冲突/问题 | 选项 |
+|---|----------|----------|------|
+| 1 | `<Path>{roots.state}/specdev/context/terms.md#max-retry</Path>` | 规则"最多重试 3 次"与 change 中"建议 5 次"矛盾 | A) 保留 3 次 B) 改为 5 次 C) 按场景区分 |
+| 2 | `<Path>{roots.state}/specdev/context/terms.md#term:Token</Path>` | 定义"JWT access token"与 change 中"包括 refresh token"不一致 | A) 扩大定义 B) 拆分为两个术语 |
+
+---
+
+## Keep（保留，无动作）
+
+| # | 文件/条目 | 保留原因 |
+|---|----------|---------|
+| 1 | `<Path>{roots.state}/specdev/adr/0003-jwt-auth.md</Path>` | 仍为现役决策或保留独有理由 |
+| 2 | `<Path>{roots.state}/specdev/context/terms.md</Path>` | 仍被变更和代码引用 |
+
+---
+
+## 反模式标记
+
+| # | 位置 | 反模式 | 建议 |
+|---|------|--------|------|
+| 1 | `<Path>{roots.state}/specdev/context/terms.md</Path>` 顶部 | "2026-03-01 上线 v2，详见..." 历史叙事 | 纯历史迁 CHANGELOG；现役约束就地融合 |

package/template/workflows/specdev/specdev-a-archive-and-consolidate/assets/consolidation-plan-template.md

@@ -0,0 +1,78 @@
+# Consolidation Plan
+
+> 生成时间：<YYYY-MM-DD HH:MM>
+> Workflow：<workflow-name>
+> 扫描 change 数：<N>
+> 知识产物数：<N>
+> 目标 stores：<领域 Skill/manifest 声明的知识 store 列表>
+
+## 提取摘要
+
+| 目标 Store | 新建 | 合并 | 冲突(需确认) | 跳过(Ephemeral) |
+|------------|------|------|-------------|----------------|
+| adr/ | <N> | <N> | <N> | <N> |
+| context/ | <N> | <N> | <N> | <N> |
+| <其他已声明 store> | <N> | <N> | <N> | <N> |
+
+---
+
+## adr/
+
+### [NEW] <YYYY-MM-DD>-<topic>[-NN].md
+- **来源 change**：<change-name>
+- **决策标题**：<title>
+- **毕业判定**：<stable-mechanism / repeated-lesson / must-know>
+- **内容摘要**：<1-2 句总结>
+- **Supersedes**：<如有，列出被取代的 ADR 稳定名称及完整/部分范围>
+
+### [SUPERSEDE] <YYYY-MM-DD>-<topic>[-NN].md
+- **被取代原因**：<新 ADR 编号和简要理由>
+
+---
+
+## context/
+
+### [ADD] 术语 "<term>"
+- **来源 change**：<change-name>
+- **定义**：<definition>
+- **_Avoid_（避免使用）**：<synonyms>
+- **毕业判定**：<stable-mechanism / must-know>
+- **目标文件**：<context/ 下的目标文件路径>
+
+### [CONFLICT] 术语 "<term>"
+- **现有定义**：<existing definition>
+- **新定义**：<new definition from change>
+- **建议**：<resolution suggestion>
+
+---
+
+## <其他已声明 store>
+
+### [ADD] <条目标题>
+- **来源 change**：<change-name>
+- **内容摘要**：<summary>
+- **毕业判定**：<criterion>
+
+### [CONFLICT] <冲突描述>
+- **现有内容**：<existing>
+- **新内容**：<new>
+- **建议**：<resolution suggestion>
+
+---
+
+## SpecDev DESIGN（存在设计提升时）
+
+- 批准来源与时间：<原用户确认 locator / ISO 时间>
+- 计划摘要：<sha256>
+- 当前 revision / 字节摘要：<revision / sha256 或 absent>
+- 候选 revision / 字节摘要：<revision / sha256>
+- 规则级决定：<rule ID、create/merge/supersede/skip、approved-intent/implemented、来源 locator/digest>
+- 发布检查点：<validated / revision-written / current-published / index-written>
+- 归档 locator：<移动后的稳定来源>
+- 实际结果与恢复：<已落地、未完成、原 owner 与下一核验动作>
+
+## Ephemeral（不提取，留在归档 change 中）
+
+| Change | 知识项 | 跳过原因 |
+|--------|--------|---------|
+| <change> | <item> | <未通过毕业标准/触发反毕业标准> |

package/template/workflows/specdev/specdev-a-archive-and-consolidate/references/archive-receipt-contract.md

@@ -0,0 +1,40 @@
+# 移动结果回读合同
+
+只在 confirmed 归档实际需要移动时读取；独立审计、无候选、未获批计划不创建此证据。总回执仍由原调用方唯一持有，不新增业务状态或第二份报告。
+
+直接 A 默认在原 <Path>{roots.state}/specdev/changes/{change}/archive-receipt.md</Path> 使用唯一 `<a id="archive-{change}"></a>` 段。Command 的总报告拥有对应对象段时，在 change README 添加唯一导航：
+
+```markdown
+## Archive Receipt
+
+Receipt: project:<项目内报告相对路径>#archive-<change>
+```
+
+`Receipt` 的 locator 可为 `change:<对象内相对路径>#<anchor>` 或 `project:<项目内相对路径>#<anchor>`；默认是 `change:archive-receipt.md#archive-{change}`。对象内 locator 随对象移动，project locator 始终从明确 projectRoot 解析；不得从方法根、当前工作目录或时间猜测。只导航，不复制回执。
+
+## 对象结果段
+
+唯一 anchor 下记录这些真实字段（字段名固定，值不得保留占位）：
+
+```markdown
+<a id="archive-<change>"></a>
+## 对象移动结果
+
+Change: <稳定 change 名称>
+Owner: <原完成/取消 owner>
+Operation: <原操作唯一标识或会话 locator>
+Approval: <change:或project:原具体批准定位，可带anchor>
+Approval-SHA256: <批准所在整文件原始字节摘要>
+Source: changes/<change>
+Target: changes/archive/<change>
+Result: moved
+Integrity: <change:或project:实际移动清单JSON文件>
+Integrity-SHA256: <清单整文件原始字节摘要>
+Time: <实际 ISO-8601 时间>
+```
+
+Approval 指向真实请求/批准的不可变记录，先核对目标、动作、范围和 owner，字段和摘要本身不创造授权。Source/Target 是 SpecDev 数据根内相对路径。原批准文件不能使用还会追加日志的总回执；回执引用它。
+
+Integrity JSON 为 `{ "entries": [...] }`，每项有对象内 `path`、`type`（`file | directory | symlink`）、整数权限位 `mode`；file 另有原始字节 `sha256`，symlink 另有原始 `target`。完整覆盖 change 其他路径，仅排除清单自身和本次原可追加回执，不能借排除遗漏业务文件。移动前保存实际清单；目标回读验证文件、目录、模式和链接不变，不跟随链接扩大移动范围。
+
+A7 实际移动后把 Result 记为 moved，运行 `--stage archived` 及其他适用消费者，允许原 owner 按原批准补本次验证和回执。此阶段未封存。全部检查通过后 A8 在原段记 `Result: verified`，运行 `--stage archived --sealed` 后才宣布封存；失败保留 moved 与真实恢复点，不写 verified。封存后回执和历史正文一起只读，后续纠错使用外部补充记录。

package/template/workflows/specdev/specdev-a-archive-and-consolidate/references/archive-rules.md

@@ -0,0 +1,20 @@
+# SpecDev 归档移动
+
+只适用于 A 固定的新协议候选，生命周期由 <Path>{roots.workflows}/specdev/common/rules/workflow-state-and-lifecycle.md</Path> 定义。旧月份归档原位只读，不纳入普通移动。
+
+## 预检
+
+- 名称合法且 active、新 archive、旧 archive 中只有一个身份；不从 mtime 猜日期或自动改名。
+- 源是 <Path>{roots.state}/specdev/changes/{change}/</Path>，README Outcome 为 completed/cancelled，原 owner 的对应证据、父子和已承诺外部门已通过；不额外要求删除 branch/worktree。
+- 目标 <Path>{roots.state}/specdev/changes/archive/{change}/</Path> 不存在；源、父目录与目标逐层真实路径、模式/链接均可保真，数据根和写集已获批。
+- 四类资产及适用 DESIGN 已完成必要现役维护，移动后所有来源/批准/原型可解析；batch 的固定候选全部预检通过。
+
+## 移动与封存
+
+1. 最后重验具体批准、源清单/摘要和原回执；必要时才建 archive 父目录。
+2. 使用宿主提供的无覆盖同文件系统移动，或可证明单写入者/隔离边界内的移动并重验。“先检查不存在再普通 rename”不证明并发无覆盖；无法保证时阻塞。跨文件系统不切换成复制删除。
+3. 整体移动原 change，README Outcome 保持原 completed/cancelled，不增加归档状态、索引或 archive_path。批准/设计/研究/许可字节不改写。
+4. 按 <Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/archive-receipt-contract.md</Path> 从目标回读原清单、字节、模式和链接；源消失、唯一目标存在，原结果记 moved，运行 archived 和适用引用/设计消费者验证。原回执仅可补本次真实检查点，此时未封存。
+5. 完成原回执，结果记 verified 并通过 archived --sealed 后冻结。后续纠错写外部补充记录；未完成恢复仅原 owner/批准操作，不能借恢复编辑历史正文。
+
+普通目录移动不使知识与整批变成原子事务。任何失败保留已落地事实，按 operation-contract 的检查点恢复，不覆盖目标、不重复发布、不虚构整体回滚。

package/template/workflows/specdev/specdev-a-archive-and-consolidate/references/cleanup-rules.md

@@ -0,0 +1,79 @@
+# Cleanup Rules
+
+知识合并计划形成后，审计目标 change 涉及的已声明知识条目，生成清理候选清单。默认只分析，不自行修改文件。
+
+## 扫描范围
+
+1. 从已经解析的 workflow 激活合同取得持久化约定，结合 INDEX 永久知识指针确认 store 与写入 owner；不能假定 INDEX 包含运行合同或仅凭目录名称取得写入权。
+2. 尚未创建的 lazy store 记为 `missing`，不为清理而创建。
+3. 按本次候选 ID/名称搜索代码、文档、active changes 和 archive 中的引用，仅回读命中证据；用户明确要求全域清理时才扩大候选清单。
+4. 删除候选须核对归档引用、来源与保留义务；无法证明可删则保留或 propose-only。
+
+## 候选生成
+
+多个来源冲突时，先按 <Path>{roots.workflows}/specdev/common/rules/artifact-contract.md</Path> 的权威顺序区分当前实现、已批准目标、ADR 取舍、context 兼容范围和历史。代码只证明当前实现；偏离仍有效的目标或 ADR 时记录偏差并交原 owner，不能据此退役义务。部分替代须保留剩余内容及受支持消费者；仅在全部有效内容已失效或已由明确后继承接时才提出退出现役。无法裁决的候选归 `needs-confirmation`，保留双方依据和原件。
+
+### 可删除（delete）
+
+- 已被替代且经引用与历史保留义务核对可移除的冗余副本；原 ADR 默认保留 supersedes 链，年龄不作为删除依据。
+- 已无实际用途的占位文件；核对模板/恢复消费者后才列候选，不按年龄裁决。
+- 误生成或准确重复且所有独有内容已有负责位置的条目；退役/无引用只是审查线索，仍需删除证据与具体授权。
+- 已完成待办仍列为开放项（核实后删除，不保留流水账）。
+- 多个位置复制的同一规则（保留权威真身，其余删除或替换为指针）。
+
+### 可合并（merge）
+
+- `adr/` 中多条内容相似的 ADR（合并为一条，注明多个来源）。
+- `context/` 中同一概念在多处有不同表述但实质相同（指定权威版本，其余加指针）。
+- 被新 ADR 或规则完全吸收的旧 lesson（合并到对应 ADR 引用）。
+
+### 可改写（rewrite）
+
+- 仍现役且确需修正格式的条目；冻结历史不整理格式。
+- 含有相对时间表述（"recently"、"两个月前"）的条目 → 改为绝对日期。
+- 历史是否有独立价值须核对来源、兼容与保留义务；无引用、年龄或体量不单独构成删除依据。
+
+### 需确认（needs-confirmation）
+
+- 规则修改或删除（若 领域 Skill/manifest 声明了规则相关 store）。
+- 术语定义冲突（`context/` 中同一术语有不同定义）。
+- ADR/context 内容的实质性改写。
+- 非标准知识 store 的任何修改建议。
+- 矛盾规则无法自动裁决。
+
+### 保留（keep）
+
+- 仍被代码、文档、archive 或 active change 引用的内容。
+- 仍有决策理由、来源或历史保留价值的 ADR，包括被 supersede 的原记录。
+- 单次出现但满足毕业标准的知识（可能是新领域，引用尚未积累）。
+- SpecDev `design/revisions/` 的已发布不可变快照，无论年龄；活动或历史 change 的基线摘要依赖它。
+
+## 保护规则
+
+`store` 是领域声明且本次选中的知识目录相对路径。
+
+- 删除前解析真实路径，确认仍位于目标 workflow state root 和已声明 store 内。
+- 不跨 workflow 合并知识。
+- SpecDev DESIGN 的修改只经 A 设计网关形成新 revision；不删除/改写历史快照。INDEX 是派生投影，缺失或过时交原网关重建，不把它当成规范内容冲突。
+- 不修改 `docs-sync` state（`<Path>{roots.state}/specdev/docs-sync.json</Path>` 由 docs-sync command 专有）。
+- 不为了空骨架创建占位文件；既有占位也先核对消费者和删除授权，不顺手移除。
+
+## 反模式清理
+
+扫描并标记以下反模式（继承自 neat-freak sync-matrix）：
+
+| 反模式 | 处理 |
+|--------|------|
+| 主规则顶部"某日 X 上线"历史叙事 | 纯历史迁 git/changelog；现役约束就地融合 |
+| 主规则抄完整架构/公式 | 留边界和权威文档指针，详细机制回 docs |
+| 多个版本都自称"现役" | 按问题类型及有效范围核对权威、替代关系与消费者；未裁决前保留双方，不以当前代码统一退役 |
+| 已完成待办仍列开放项 | 核实后删除或改为当前约束 |
+| 单次事故长篇常驻 | 提炼可复用教训；机制进 docs，过程进 incident/git |
+| 会话残留（一次性计划、调试脚本、`_old`/`_backup` 副本） | 有效内容并进正式文档；文件列删除候选 |
+
+## 完成标准
+
+- 本次获批范围全部有结论；普通收尾不隐含扫描所有 store。
+- 每个候选属于恰好一个分类（`delete | merge | rewrite | keep | needs-confirmation`）。
+- 每个候选有来源路径、证据和风险说明。
+- 未确认时文件系统未发生变化。

package/template/workflows/specdev/specdev-a-archive-and-consolidate/references/consolidation-interview.md

@@ -0,0 +1,67 @@
+# 代码库沉淀访谈协议
+
+本协议由 `<Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/SKILL.md</Path>` 的 consolidate-from-code 模式使用，遵循 `<Path>{roots.workflows}/specdev/common/rules/artifact-contract.md</Path>` 与 `<Path>{roots.workflows}/specdev/common/rules/planning-principles.md</Path>`。
+
+目标不是设计新功能，而是**以当前代码库为基本事实**，把散落在代码里的领域语义与架构决策访谈出来、固化为永久知识。区别于 `<Path>{roots.workflows}/specdev/specdev-g-grill-with-docs/SKILL.md</Path>`（实现前打磨方案），本协议描述的是**系统当前已经如此**的真相。
+
+## 1. 基本事实优先
+
+- 一切结论以当前代码、配置、接口、schema、测试和经验证文档为准。
+- 提问前先只读探索相关实现，能从代码回答的事实不得转交用户；只有语义命名、边界取舍、不变量意图、历史缘由这类代码无法自证的事项才升级为访谈问题。
+- 涉及不熟悉的外部技术、第三方 API、标准或版本行为时，调用 `<Path>{roots.workflows}/specdev/common/skills/research/SKILL.md</Path>`，把来源与置信度写入当前 change 的 LOG。
+- 若无相关 change 参考，直接以代码为事实开始访谈，不因缺少历史 change 而阻塞。
+
+## 2. 决策树
+
+按“哪些永久知识当前缺失或过时”驱动，不机械提问：
+
+1. 领域边界与限界上下文：系统由哪些领域构成，各自职责与边界；
+2. 规范术语与语义：代码中的类型/模块名对应什么业务概念，别名与禁用词；
+3. Context Map：多个 bounded context 之间需要明确的关系；
+4. 已固化的架构决策：哪些有持续决策价值的决定可由真实历史依据确认；难逆转、令人意外和真实权衡是线索，不从代码编造历史动机；
+5. 历史缘由：为什么当前这样，哪些是有意决策、哪些只是可从代码即时发现的实现事实。
+
+## 3. 每轮只关闭一个关键结论
+
+每轮格式：
+
+1. **代码事实：** 简述从代码/测试读到的证据，带 `CODE:<Path>project/relative/path</Path>` 指针；
+2. **唯一问题：** 不使用复合问题；
+3. **可行解读：** 只列实质不同的语义/决策解读；
+4. **权衡：** 不同解读对术语一致性、架构约束、下游影响的差异；
+5. **推荐：** 给出基于代码最可能的默认解读及理由；
+6. **用户结论：** confirmed / deferred / rejected；
+7. **落盘：** 立即更新当前 change 的 LOG，并按需更新 CONTEXT 或 ADR。
+
+## 4. 记录与格式
+
+change 内三份文档复用 grill 的既有格式，避免重复发明：
+
+- 设计日志：`<Path>{roots.workflows}/specdev/specdev-g-grill-with-docs/references/log-format.md</Path>`；
+- 领域上下文：`<Path>{roots.workflows}/specdev/common/rules/context-format.md</Path>`；
+- 架构决策：`<Path>{roots.workflows}/specdev/common/rules/adr-format.md</Path>`；
+- 领域建模规则：`<Path>{roots.workflows}/specdev/common/rules/domain-modeling.md</Path>`。
+
+同步顺序固定：先 LOG，再 CONTEXT，最后 ADR。CONTEXT 只描述当前真相，历史轨迹留在 LOG；未确认的解读不得写成已接受 ADR；与现有永久 ADR 冲突时建立 supersedes 链，不重写历史。高影响条目带来源标识（`USER-DECISION`、`CODE:`、`RESEARCH:`、`ADR-###`）。
+
+## 5. 停止条件
+
+- 目标主题的规范术语、Context Map 与符合准入条件的架构决策已覆盖，足以提升为永久知识；或
+- 用户明确延后，且该延后不伪装成已确认真相；或
+- 缺少必要外部信息或权限，change 标 blocked；或
+- 继续提问只会产生低影响或纯实现细节，交给对应实现阶段决定。
+
+停止后返回 A 的 Archive 模式，进入知识提升评估。未获代码或实际行为验证的结论一律不提升，只留在 change 内。
+
+
+## Consolidate-from-code 模式
+
+1. 创建实际知识任务的 <Path>{roots.state}/specdev/changes/{change}/README.md</Path>，写 Outcome active、范围与验收；LOG、CONTEXT、ADR 只在有真实内容时形成，恢复依据留原载体。
+2. 按上述访谈过程，每轮先探索代码/配置/测试并陈述证据，再一次只问一个真正影响长期理解的问题。
+3. 按 LOG → CONTEXT → ADR 顺序写入：CONTEXT 只保存项目规范术语；ADR 只在有持续决策价值时创建，保留真实取舍；难逆转、令人意外和权衡不要求同时满足。
+4. 用户结论必须由当前代码或实际行为验证；未验证内容留在 LOG，不提升。
+5. 按 change completion 规则由本 Work 关闭该非实现型 change，再进入 Archive 模式的 dry-run/确认流程。
+
+## 未来价值与取代关系
+
+逐条核对当前实现、跨 change 用途、真实备选/代价、负向保证和恢复义务；不编造设计理由，不把未落地计划晋升为事实。同主题合并保留独有理由，局部替代保留剩余有效部分。未晋升内容随原 change 保留，永久写入仍走既有 A 网关。

package/template/workflows/specdev/specdev-a-archive-and-consolidate/references/consolidation-rules.md

@@ -0,0 +1,86 @@
+# Consolidation Rules
+
+从选定 change 或独立维护的真实来源中提取、纠错和替代已声明知识；整体完成/取消不是所有条目自动毕业的证明。
+
+## 提取来源
+
+对选定 change 先枚举实际存在的有关产物，按候选问题读取以下来源，不要求空工件。独立维护按主题读取真实来源及有关现役条目，无须创建 change：
+
+1. Evidence 与 Goal Plan — 交付边界、验证证据和残余风险
+2. <Path>{roots.state}/specdev/changes/{change}/ADR.md</Path> — 架构决策记录
+3. <Path>{roots.state}/specdev/changes/{change}/LOG.md</Path> — 设计决策日志（可能含未正式记录的 ADR）
+4. <Path>{roots.state}/specdev/changes/{change}/CONTEXT.md</Path> — 项目规范术语
+5. Change DESIGN — 本 change 唯一视觉与交互合同；以规则 ID 去重，原型与 Evidence 只提供佐证
+6. diagnosis、reviews、prototypes、questionnaires 和任何 workflow 自定义知识产物
+
+## Store 映射与合并策略
+
+新对象命名使用 `YYYY-MM-DD-topic[-NN]`，已有历史名称保持不变；change 使用本次固定候选。
+
+### adr/（架构决策记录目录）
+
+- **提取条件**：有持续决策价值，保留真实理由、备选、后果、负向保证与恢复义务；不可逆/令人意外/真实权衡是线索，不要求同时满足。
+- **名称分配**：实际创建时按日期/主题选择未占用名称，必要时加 `-NN`，不创建编号注册中心。
+- **文件命名**：`<Path>{roots.state}/specdev/adr/{date}-{topic}[-NN].md</Path>`。
+- **内容格式**：标题、状态（Accepted）、日期、决策上下文、决策内容、后果。
+- **Supersede 处理**：若新 ADR 取代旧 ADR，在旧 ADR 开头添加 Superseded by 与新 ADR 的完整指针 `<Path>{roots.state}/specdev/adr/{date}-{topic}[-NN].md</Path>`；不删除旧 ADR。
+- **从 LOG 提升**：<Path>{roots.state}/specdev/changes/{change}/LOG.md</Path> 中满足 ADR 标准且尚未写入 <Path>{roots.state}/specdev/changes/{change}/ADR.md</Path> 的决策 → 创建正式 ADR，注明"从 <Path>{roots.state}/specdev/changes/{change}/LOG.md</Path> 提升"；已有 change ADR 时只评估该唯一候选，不重复生成。
+
+### context/（领域词汇表目录）
+
+- **提取条件**：项目特有的领域术语，不是通用编程概念。
+- **合并方式**：将新术语合并到 `context/` 目录下的现有术语文件中。若目录为空，创建首个术语文件。
+- **条目格式**：遵循 `**术语名**：定义` + `_Avoid_: 同义词` 格式。
+- **冲突检测**：若术语已在 context/ 中存在定义，比较两者：
+  - 一致 → 跳过（记录"已存在"）
+  - 不同 → 标记 `needs-confirmation`，展示两个版本
+- **保留现有**：已有的 `_Avoid_` 标注和术语分组不覆盖。
+- **术语更名**：若新术语取代旧术语，在旧术语的 `_Avoid_` 中保留旧名称，创建新术语条目。
+
+### design/（仅已声明的 SpecDev 项目设计知识）
+
+按 `<Path>{roots.workflows}/specdev/specdev-a-archive-and-consolidate/references/design-knowledge-gateway.md</Path>` 进行规则级毕业、冲突确认与发布。稳定 tokens、组件约束、跨页面交互模式可以毕业；单次页面、未落地候选、临时实验不提升。每条 implemented 规则必须有可定位实现证据，completed 状态本身不够。
+
+DESIGN.md 是唯一 current，revisions 不可变，INDEX 可重建。首次不存在时只由该网关按已批准计划 lazy 创建；本 Work 的通用合并步骤不 append、覆盖、清理 revision，也不将新规范写回已归档 change。
+
+### 其他知识 store（若领域声明）
+
+若领域 Skill/manifest 持久化约定声明了 `adr/`、`context/` 和上述专有网关以外的知识 store：
+
+- **提取条件**：按知识类型匹配最合适的 store。
+- **合并方式**：按已声明的 store 格式与网关处理；未声明写法只提出候选，不猜测 append 权限。
+- **冲突处理**：与已有内容矛盾 → 标记 `needs-confirmation`。
+- **未声明则跳过**：不向领域持久化约定未声明的路径写入。
+
+## 保护规则
+
+- **不盲覆盖**：按具体批准原地纠错、merge 或后继替代，保留 before-image；不是每次只许 append 使错误长期存在。
+- **目录 store（adr/、context/）**：首次写入时若目录不存在则自动创建。
+- **不创建未声明 store**：只写入领域 Skill/manifest 持久化约定声明的 store。
+- **来源溯源**：所有合并内容保留真实来源和日期；有 change 时使用其稳定名称，独立维护使用原材料、决定或会话证据，不虚构 change 来源。
+- **禁止跨 workflow**：合并范围限定于当前 workflow 声明的 stores。
+
+## Store 创建策略
+
+仅在领域已声明并允许创建时：
+
+| store | 行为 |
+|-------|------|
+| `adr/` | 首次写入时自动创建目录 |
+| `context/` | 首次写入时自动创建目录 |
+| SpecDev `design/` | 只由 A 设计网关按具体批准 lazy 创建 |
+| 其他已声明 store | 若不存在则跳过并警告；不自动创建 |
+
+## 完成标准
+
+- 每个选定 change 的有关知识产物，或独立维护固定主题的来源，均有分类结论。
+- 每个提取候选项已评定毕业状态和目标 store。
+- 冲突项已标记 `needs-confirmation` 并提供双方版本。
+- 合并计划中每项都有真实来源、目标 store、动作和判定理由；已有条目的纠错、替代或删除还须满足下节及 cleanup 的保真要求。
+
+
+## 完整替代、部分替代和历史
+
+小纠错原地更新现役条目；真实决策反转创建后继 ADR 并说明替代范围。完整替代须逐项证明全部有效内容已承接或失效，旧记录保留独有理由、被拒方案、负向保证、验证与恢复义务。部分替代只退出已承接部分，剩余约束继续现役并保留双向引用，不能仅加 superseded 布尔值或整组归档。
+
+context 实质含义变化记录后继与适用范围；旧数据/兼容消费者尚在时保留所需解释。docs 当前参考原地更新，只有退役协议、事故或旧数据说明有独立价值才建历史快照。现役退出可在具体授权后移到各自 archive，冻结历史不做格式整理、翻译或重命名。没有历史依据不能由当前代码编造“当初为了什么放弃什么”。