---
name: soloforge-deliberation
description: 通过事实、选项和取舍帮助用户收敛高影响决策，不替用户做价值判断。
when: 高影响决策 / 方案取舍 / 研讨 / 用户确认
---

# 产物研讨

## 适用性

用于目标、范围、端划分、架构、数据、兼容、发布或接受风险等高影响决策。纯机械编辑、可逆实现细节和已有明确规则不需要额外研讨。

## 事实输入

- 用户目标、约束、现状证据和不可接受结果。
- 当前产物、代码、配置、运行数据和未知项。
- `examples.md`；正例只展示论证方式，不预设选择。

## 关键决策

- 先区分客观约束、可变惯例和未经验证的假设。
- 只保留真正可行且有实质差异的选项。
- 推荐必须说明为什么适合当前目标、代价、失败条件和重审触发器。

## 产出方法

1. 用一句话还原用户要解决的问题和成功标准。
2. 列出已知事实、未知项、硬约束和可挑战假设。
3. 比较少量可行选项的收益、成本、风险、可逆性和退出方式。
4. 对价值判断请求用户确认；对低风险可逆细节按最简合理默认推进。
5. 将结论写入对应产物或 ADR，不把讨论记录当权威验证证据。

## 禁止项

- 不得用“最佳实践、业界主流、以后可能需要”代替论证。
- 不得制造虚假二选一或列出明显不可行选项凑数。
- 不得替用户接受风险、削减范围或选择不可逆迁移。
- 不得把未确认建议写成用户决定。

## 交付自检

- 结论能追溯到目标和证据，反例条件清楚。
- 选项复杂度与问题规模匹配，没有无必要抽象。
- 未知项有获取事实的下一步，而不是被猜测填满。
- 决策记录说明谁确认、何时确认和何时需要重审。

## 权威验证

研讨本身不写 SoloForge 状态。编辑对应产物后先处理 quick 反馈，再对该产物执行 `sf_verify action="full"`。高影响决策（资金安全、权限模型、不可逆数据迁移、状态流转）的研讨结论须走 `sf_review`（per_artifact 审承载产物），由独立审查复核决策依据是否成立——研讨是"决策纪律"核心卖点，其语义质量不能只靠留痕 gate（requirement_deliberation_gate 只证留痕非真研讨），须由对抗审查兜底。

## 研讨留痕（验证所需）

业务决策证据写入对应产物或 ADR。同时，SoloForge 的研讨门（`requirement_deliberation_gate` / `artifact_deliberation_gate`）要求研讨记录留痕文件，证研讨实质发生（非业务证据，是 gate 留痕）。留痕路径：`docs/研讨记录/{域}/{产物}-研讨记录.md`，例如：
- `docs/研讨记录/设计/需求分析-研讨记录.md`
- `docs/研讨记录/设计/数据库设计文档-研讨记录.md`
- `docs/研讨记录/设计/API接口规格-研讨记录.md`

内容须含实质结论（含决策词如 结论/决策/选项/取舍/方案/理由/权衡，去标记后 ≥50 字符），非空话占位——否则门禁 fail-closed 阻断交付。留痕不替代产物结论（业务证据仍在产物/ADR）。brownfield 项目产物路径被 project_map override 时，留痕路径随产物派生。