devbooks-void

name	devbooks-void
description	devbooks-void：Void 协议执行器：处理高熵/不确定/多方案争议问题，只产出 research_report + ADR + Freeze/Thaw 工件，不产出生产代码。用户说"进入 void/卡住了/不确定/需要调研/冻结解冻"等时使用。 Use when this capability is needed.
metadata	{"author":"darkbluelr"}

DevBooks：Void（高熵问题协议）

渐进披露

基础层（必读）

目标：把“输入不足/不确定/多方案争议”转换为可审计的知识与决策工件，并通过 Freeze/Thaw 控制后续执行。 输入：用户请求、变更包元数据（proposal front matter）、已存在的证据与 Gate Report（若有）。 输出（MUST）：

• void/research_report.md：结论、约束、证据来源、影响面、风险与下一步建议
• void/ADR.md：Context / Options / Decision / Consequences
• void/void.yaml：Freeze/Thaw 状态、阻塞问题清单、已解决问题与引用

边界（MUST）：

• Void 阶段不得产出生产代码变更；不得修改 tests/ 或 src/。
• Void 的产物必须可被脚本校验（见 void-protocol-check.sh）。

证据：Void 工件存在且非空；Freeze/Thaw 状态与变更包 state/next_action 一致。

进阶层（可选）

适用：需要把 research_report 的结论回写为 Truth（Decision/Constraints）或生成后续 Knife/Bootstrap 的输入索引时。

核心要点

• 先做配置发现（.devbooks/config.yaml）与规则文档读取，再进入 Void 输出。
• 结论必须可操作：包含明确的 next_action（Bootstrap/Knife/DevBooks）与阻塞解除条件。
• Freeze 时必须阻断后续执行；Thaw 必须链接 ADR 与证据，并记录吸收路径。

参考资料

• dev-playbooks/specs/void/spec.md

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.