用途:在 decisions/ 目录下写入架构决策记录(ADR),记录一个已经做出的决策、促成它的因素以及团队需要承担的后果。它只负责记录,不替用户做决策;若仍在权衡方案,应转交 frame-a-proposal;若质疑决策本身是否合理,应转交 review-a-design。
主要能力:先确认决策确已做出(硬性门槛),再检查已有记录以避免无声矛盾,按 NNNN-title.md 命名并分配下一个序号;模板 id 为 decision,正文固定为 ## Context、## Decision、## Consequences 三节;状态使用 proposed / accepted / deprecated / superseded,记录 rejected 选项、父提案与 supersedes 链。
用法要点:通过 search、exec("ls -A decisions/")、exec("grep -rln <keyword> decisions/") 扫描先例;用 write({ document: { path: "decisions/0012-adopt-event-sourcing-for-orders.md", template: "decision" } }) 创建;用 edit 补 supersedes 与状态翻转;用 links({ kind: "backlinks", ... }) 和 links({ kind: "dead", ... }) 校验链接。Accepted 后冻结,改动需以新记录 supersede,并双向接线(旧记录改 status 并加前向链接,不改其正文)。
限制:未提供收费、价格、平台或效果信息;不记录未做成的决策,不代用户判定 accepted,不把实现细节写入 ADR。