用途:在 wiki-forge 管理的项目中,domain-model 属于软件交付工作流的一环,目标是在 write-a-prd 之前,对计划进行领域层面的压力测试,澄清术语,并把决策与上下文沉淀到规范的知识表面。
主要能力:通过持续追问,逐个解决设计树上的依赖与决策分支;每个问题给出推荐答案,一次只问一个问题并等待反馈;若问题可通过探索代码库回答,则直接探索代码库。过程中会对照既有术语表挑战冲突用法、把模糊或过载的术语收敛为精确的规范术语、用具体场景检验领域关系与边界,并与代码交叉验证矛盾之处。术语一经确定即就地更新,不批量延后。
产出物:决策日志追加到 projects/<project>/decisions.md;领域语言页(术语表、关系、标记的歧义)维护在 projects/<project>/architecture/domain-language.md;未解决的歧义保持可见,供 write-a-prd 显式消费。仅当决策难以逆转、缺少上下文会令人困惑、且是真实权衡的结果时,才建议记录决策。
完成判定:对 forge 管理的项目,仅当工作流能指向持久证据时才算完成,即 decisions.md 含具体决策条目、决策表面产出持久 decisionRefs、domain-language.md 记录了澄清或重定义后的术语与上下文;若 wiki forge status 仍报告 domain-model.completedAt 或 domain-model.decisionRefs,则视为未完成。
规范查找顺序:先读 projects/<project>/architecture/domain-language.md,再读 projects/<project>/decisions.md,仅在项目明确将上下文产物保留在仓库内时才回退到仓库本地文件(如 CONTEXT.md、docs/adr/,多上下文时由 CONTEXT-MAP.md 指向)。文件按需惰性创建。
限制:资料未提供具体安装命令、收费方式、支持平台与效果数据;仓库本地 markdown 仅为回退方案。