Keep the Why is not another workflow

说明与用途

安装并初始化 Keep the Why，让代理自动将决策原因记录在 context/ 下的 Markdown 文件中。通过 Git 这些文件随仓库传播，使未来的代理和开发者无需额外努力即可理解上下文。

问题

Developers and coding agents lose the reasoning behind decisions when code changes, leading to repeated mistakes and loss of context.

结果

By installing and initializing Keep the Why, developers can continue coding without extra documentation steps, while the agent automatically records reasoning in plain Markdown. This knowledge travels with the repository, improving future agent and developer understanding and reducing repeated mistakes.

工作流

• Install the Keep the Why skill via the recommended command or other supported methods.
• Initialize the project by running the agent command to opt‑in and accept defaults.
• The agent presents a setup wizard; answer with "defaults" for both project and personal preferences.
• After setup, continue coding normally; the agent automatically captures relevant reasoning into Markdown files under context/.
• Git tracks these files, so cloning, branching, or switching machines carries the knowledge forward.
• Future agents or developers can read the context/ files to understand past decisions and constraints.
• Reviewers can see reasoning in PRs alongside code changes.

证据

Install the skill… For more than 70 supported agents, the recommended installation is documented on the installation page.

来源

Initialize Keep the Why in this project… The wizard is presented as a list with defaults already filled in where the setup defines them.

来源

The result is deliberately boring: plain Markdown in the project.

来源

Git already solves the distribution problem… The memory is part of the project. context/ is Markdown. .keep-the-why records that the project has opted in and how it is configured.

来源