Keep the Why is not another workflow

Описание и применение

Установите и инициализируйте Keep the Why, чтобы агент автоматически сохранял причины решений в Markdown‑файлах context/. Эти файлы распространяются с репозиторием через 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.

Источник