用途:这是 RDD(研究驱动开发)工作流的决策阶段。使用前提是用户已完成研究(essay)与领域建模(glossary),本阶段产出架构决策记录(ADR)与可证伪的行为场景,为后续构建阶段提供依据。
主要能力与流程:
- 读取既有产物。优先读取领域模型的不变量(./docs/domain-model.md 的 Invariants 章节),它是最高优先级依据;再读 essay、research-log 与已有 ADR。若旧 ADR 或 essay 与当前不变量矛盾,立即标记,以不变量为准。
- 编写 ADR。每个决策一份,模板含状态(Proposed/Accepted/Superseded)、Context、Decision、Consequences(正面/负面/中性),写入 ./docs/decisions/adr-NNN-<slug>.md。原则:一决策一 ADR、遇到不确定即停止并可退回 /rdd-research、上下文来自 essay 不引入新框架、保持精简、使用领域词汇、经用户批准后再继续。
- 论证审计。对新旧 ADR 与 essay 运行 /argument-audit,检查逻辑健全性、内部一致性、不变量合规、隐藏假设、术语一致性与范围准确性,并按优先级修复。
- 一致性审计。扫描代码库中违反已接受 ADR 的部分,产出 conformance 债务表(ADR、违规、类型、位置、处理方式)。
- 反向传播。当 ADR 新增或变更不变量时,扫描所有旧 ADR 与 essay 中矛盾表述,添加 Superseded 说明,更新领域模型 Amendment Log,并向用户汇报。
- 编写行为场景。用领域词汇写成 Given/When/Then,写入 ./docs/scenarios.md,要求每条 Then 可观察、可验证;每个新组件至少一条使用真实类型(非桩)的集成边界场景。
- 提交用户批准,说明接近取舍的决策、边界与正常路径场景覆盖、因不确定而暂停之处,以及改变 ADR 或旧文档的审计发现。
适用场景:需要把研究结论固化为可追溯的架构决策、并用可测试场景约束后续实现的团队流程。
限制:本资料为技能说明文本,未提供安装方式、平台支持、版本与定价信息;使用依赖用户已有 docs 目录下的 essay、领域模型与既有 ADR 等产物。