你是来找决策日志模板的——字段、标题、能直接粘进文档的东西。它就在下面,拿走。但要清楚你拿到的是什么:模板是一套填空格式,而你填完的那一瞬间,它就开始过时了。Notion 表格也好、markdown 文件也好,没有任何东西把一个决策连到依赖它的那些 spec 上;于是决策一变,日志就悄悄变成了虚构。Draftlize 给你同样的八个字段——并把每一个都变成 AI agent 能读也能写的卡片,一个决策一动,下游的一切都会自动把自己标记成 stale。
这就是整份模板。放在文档、wiki 或 markdown 文件里都成——它和架构决策记录(ADR)是同一种形状。直接用。下一节讲的是:当每个字段不再是文字、而成为一张卡片时,会发生什么变化。
这个决定,一句话讲清。「我们按量收费,不按席位收费。」如果你压缩不成一句话,说明你还没真正做出决定。
逼出这个选择的处境。当时什么是成立的、什么被约束住了、是什么压力让它成了一个「决策」而不是一个默认值。
真正认真考虑过的备选,不是用来陪衬的稻草人。决策日志的价值大半在这里——它能拦住你,别去重新争论一条你早已带着理由否决掉的路。
为什么是这个方案赢、其它输。这是你未来真正会打开日志去看的唯一一个字段。诚实写下你接受了什么样的取舍。
那些假设了这个决策成立的 spec、决策和工作。在文档里,这是一份你迟早会忘记更新的清单。它是决定整份日志还真不真的那个字段。
提议中、已采纳、已被取代——或者,stale。决策不是永恒的;日志必须能说出「这条已经不成立了」,又不抹掉它当初为什么成立的那段历史。
当理由开始讲不通时,去问谁。不是为了追责——是为了半年后那个追问。
什么时候定的。记录起来很便宜,却是让你能按事情真实发生的顺序去读这些决策的那样东西。
模板就是这些。往下:为什么「填完」正是它开始腐烂的那一刻——以及我们对此做了什么。
这八个字段是好的——正因如此,ADR 从 2011 年起用的差不多就是这个形状。但一种格式只把决策捕捉一次。它根本不知道自己记下的东西什么时候不再成立,因为一张文字表格没法盯着产品的其余部分一起变。
你老老实实列出了什么依赖这个决策。然后决策变了,更新那些依赖就成了一场手动考古——凭记忆,找出每一个假设了旧决定的 spec。没人会真去做。那个本该让日志保持诚实的字段,是第一个开始撒谎的。
模板最准的时刻,是你刚填完它的那一分钟,此后再也没那么准过。到第九十天,里头有相当一部分是错的,而你分不清是哪一部分——于是整份日志被悄悄地不再信任,这比没有还糟。
在 Draftlize 里,模板不是一张空表——而是一张带着这些字段的结构化卡片:决策、背景、备选、理由、依赖、状态、负责人、日期。结构化、可按 ID 寻址、能从一份 spec 或一个 thread 里被引用,而不是埋在某个 wiki 页里。
因为「依赖」是真实的连接、而不是一串名词,改掉一个决策,就会让每张压在它上面的卡片自动变 stale——就像构建系统让一个改动文件的所有下游失效一样。模板许下的承诺,substrate 替它兑现。
Claude Code 或 Cursor,经 MCP,在起草下一份 spec 前读完每一个相关决策,并把新决策按同样的形状写回去。日志不再是一份写给「永不回来的读者」的文档,而成了每一轮都会被读到的上下文。
模板告诉你该写下什么。它没法告诉你,你写下的东西什么时候已经不再成立。留下这八个字段。让 substrate 替你保持它们最新。
决策日志是团队所做重要选择的流水记录——记下做了什么、为什么这么做、否掉了什么,好让推理活过那场会议,也让人半年后不用再重新争一个早已定下的决定。每条通常包含:决策、背景、考虑过的选项、理由、依赖、状态、负责人和日期。
ADR(架构决策记录)是专门用于工程选择的决策日志——同样的八字段形状,范围更窄。决策日志还涵盖产品、定价、策略层面的决定。如果你已经在写 ADR,决策日志就是把同一套纪律用到架构之上的那些决策上。
决策(一句话讲清这个选择)、背景(为什么是现在)、考虑过的选项、理由(为什么是它赢)、依赖(有什么靠着它)、状态(提议 / 采纳 / 被取代 / 过期)、负责人、日期。理由和被否掉的选项,是你未来真正会打开日志去读的两个字段。
放任何能装文字的地方——wiki、markdown 文件、Notion 表格。它们过期,是因为没有东西把一条记下的决策连到依赖它的 spec,所以决策一变,日志就悄悄变成了小说。Draftlize 把同样的八个字段做成卡片,决策一动,就自动把每个依赖它的东西标记为过期——日志自己更新,而不是烂掉。
把上面这份模板拿走,或者建一个项目、让 agent 用你已有的文档把它填起来——然后替你把每个决策、以及一切依赖它们的东西,保持最新。
用 $5 免费开始一键创建项目:这些章节会预置成结构化、互相链接的卡片。和 agent 一起回答它们——之后任何决策变了,依赖它的章节会自动标记过时,而不是悄悄失真。注册送 $5 额度,无需绑卡。