6栏理由记录,拦住AI重复提上周否掉的方案。
开发者最耗时间的循环之一,是新会话里的AI又提出团队已经讨论、测试并否决过的架构方案。代码记住了结果,却没留下为什么。
开源项目Keep the Why把决策理由写进仓库的context目录,与代码在同一次提交或PR里接受审查和版本管理。它还明确区分持续记录、历史恢复、知识访谈与维护四种模式。
官方仓库:网页链接 。
先别安装,挑一个不含敏感信息的玩具仓库,记录最近一次否决:先写问题和被否方案,再写否决证据、当前决定、重新评估条件,最后补责任人与日期。
可复制交付物:问题|被否方案|否决证据|当前决定|重新评估条件|责任人|日期。
已填写示例:登录缓存|全量Redis|峰值连接成本过高|保留本地短缓存|QPS翻倍后复审|架构负责人|09-06。
完成标准:后来者能说出为什么不做、什么条件下重开讨论;从旧提交推断出的理由必须标成“推测”,不能伪装成当时结论。
项目README说明内容以Markdown随代码版本化,并提示不同代理的自动加载并无统一保证。MIT许可。本轮只读核验,未安装、未写入任何真实仓库;内部事故、架构争议与人员信息应先脱敏。
AI记住答案不难,难的是团队把“不做什么、为什么不做”变成可复核的共同记忆。
AI工具 架构方案
