英文原文: https://argusic.com/subject/keep-the-why
keep-the-why
仓库原生项目记忆的 why 层：代码库背后的推理，以 Markdown 形式存放在仓库中，由 Git 进行版本控制，供编码 agent 和人类使用，这样被拒绝的内容就不会被重复提出。无需数据库、无需守护进程、无需账户。
可运行来源：GitHub项目主页JavaScriptMITcommit 8268a33c00ba
JavaScript，MIT 许可证. 项目的自我描述：agent skills、ai agents、architecture decision records、coding agents、context engineering、developer tools、documentation 和 git.
keep-the-why 可以运行。一个 Argusic agent 在一台没有 GPU 的干净机器上用 2 分钟完成了安装，没有遇到任何错误，整个会话都被记录了下来。
keep-the-why-lint 0.20.0.0 and keep-the-why-dashboard 0.7.3 are installed and functional. The linter validates this project's context/ (0 errors, 0 warnings, schema 0.20.0). The dashboard serves its UI at localhost:8765 (HTTP 200), exports static pages, and both packages' test suites pass completely (116+61+65 = 242 tests).
agent 在干净的机器上最终得到的结果，用它自己的话说。 测量方式
每一次都由 Argusic 在全新机器上实测。每个数字都链接到对应的证据。 Argusic 评分 100，满分 100（该项目各次运行得分的平均值）。
概览
项目数据来自 GitHub，链接见本页顶部，更新于 。测试数据由 Argusic 提供 (CC BY 4.0)；每个数字都链接到一个运行页面，附完整的 log、录屏及其 sha256 哈希。
测量了什么
来自决定该结论的那次运行。 每一行都是记录下来的数值，而非估算。
- 安装时间
- 2 分钟
- 从冷启动机器到完成
- 4 分钟
- 遇到并修复的错误
- 遇到 0 个，在无人协助的情况下修复了 0 个
- 结果是如何证明的
- ktw-lint . returned 0 errors, 0 warnings; ktw-dashboard --json produced valid state with 130 entries; ktw-dashboard server responded HTTP 200; pytest lint/tests/ returned 116 passed; pytest dashboard/tests/ returned 61 passed; pytest tools/evals/tests/ returned 65 passed. Export generated index.html, state.json, badge-entries.svg.
- 使用的模型 token
- 232,871
- 测试的确切 commit
- 8268a33c00ba
- 容器镜像
- sha256:cdd920bce783
没有测量什么
另一半内容，让你清楚看到这些证据能说明到什么程度。缺失的数据就标为缺失，从不填补。
- GPU 显存峰值
- 本次运行在 CPU 机器上进行，没有可采样的 GPU
- 长时间运行的表现
- 每次尝试都使用文档中最小的设置和固定的时间预算，因此这里测量的是它能否运行，而不是它在负载下的表现
录屏的结尾
决定该结论的终端会话的最后几行，与录制时完全一致。
=== Dashboard version === ktw-dashboard 0.7.3 === Lint version === ktw-lint 0.20.0.0 === Build time calc === Started around 2026-10-29 11:00:17 Good. The total time spent is about 2 minutes. Let me calculate more precisely and compile the fina… Here is the final summary: tokens used 232,871 Good. The total time spent is about 2 minutes. Let me calculate more precisely and compile the fina… Here is the final summary:
回放完整会话，从干净的机器到此刻的每一条命令。
测试方式
一个 agent，一个容器，没有人工协助。它按照项目自身文档所写的方式安装项目，运行它，并修复出错的地方。下面的一切都按实际发生的过程记录：终端会话、log 和确切的 commit。 完整方法论.
优势与局限
均为实测事实，而非观点。内容是如何撰写的.
顺利的部分
- 在干净的机器上达到了运行状态，会话有完整记录。
- 用 2 分钟完成安装，快于 Argusic 测量过的 106 个同类项目的中位数。
- 过程中没有任何故障：从克隆到运行，零错误。
- 无需 GPU 即可运行，因此启动它并不需要 GPU。
- 采用 MIT 许可证，以其托管平台报告的信息为准。
不顺利或尚不清楚的部分
- 目前只测量过一次。单次尝试只能说明它可以运行，不能说明它能稳定运行。
在 Argusic 安装并计时过的 107 个 agent-skills 项目中，keep-the-why 达到运行状态的速度排名第 35，107 个项目中有 78 个达到了运行状态。
适合用于
- 在笔记本电脑或小型服务器上试用：它无需 GPU 即达到了运行状态。
- 快速评估：克隆后 2 分钟它就已经运行起来。
- 按照它自己的 README 操作：文档中的步骤无需任何修复即可走通。
同一领域中也测试过的项目
这里的每个项目都由 Argusic 在干净的机器上安装并运行过。未经测试的项目不会出现在这里。
运行历史
主题 (来自 GitHub)
agent-skillsai-agentsarchitecture-decision-recordscoding-agentscontext-engineeringdeveloper-toolsdocumentationgitknowledge-managementllm-agentsproject-memoryrepo-local-memoryrepo-native
嵌入徽章
用于项目 README 的 Markdown。徽章链接回本页；使用条款见 条款页面.
[](https://argusic.com/subject/keep-the-why)常见问题
- keep-the-why 能运行吗？
- 是的。keep-the-why 可以运行. Argusic 在一台干净的机器上安装并启动了它，用时 2 分钟，过程中遇到 0 个错误，并记录了整个会话。
- Argusic 是如何测试 keep-the-why 的？
- 在一台全新的一次性机器上进行，每条命令都被记录，仓库固定在 commit 8268a33c00ba。共记录了 1 次尝试，完整方法见方法论页面。
- 测试 keep-the-why 花了多少钱？
- 得出该结论的那次运行花费 0.04 USD：这是真实的算力和模型成本，而不是按每百万 token 计的标价。该数字记录在那次运行的页面上。
- keep-the-why 安装需要多长时间？
- 在决定该结论的那次运行中，从干净的机器到运行状态用了 2 分钟。这是一次实测的尝试，不是平均值。
- keep-the-why 需要 GPU 吗？
- 启动它不需要。Argusic 在一台没有 GPU 的机器上让它达到了运行状态。
- 安装 keep-the-why 时会出现什么问题？
- 在已记录的运行中没有出现任何问题：从克隆到运行，零错误。
- keep-the-why 与其他替代方案相比如何？
- 在 Argusic 安装并计时过的 107 个 agent-skills 项目中，keep-the-why 达到运行状态的速度排名第 35，107 个项目中有 78 个达到了运行状态。
- keep-the-why 的证据在哪里？
- 这次已记录的运行都在本页上，每次都链接到完整的 log 和终端录屏，并连同 sha256 指纹一起保存，因此无法被悄悄篡改。