Keep the Why — скилл
Keep the Why хранит в репозитории причины решений и отвергнутые варианты в Markdown, чтобы агент не предлагал их снова
- 237 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Навык пишет Markdown-файлы в папку `context/` репозитория, но кода не исполняет и в сеть не ходит.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/keep-the-whyОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Навык пишет Markdown-файлы в папку `context/` репозитория, но кода не исполняет и в сеть не ходит.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Keep the Why — навык и соглашение о файлах, которые хранят в репозитории причины, стоящие за кодом: архитектурные решения, отвергнутые альтернативы, временные решения, выводы из инцидентов и ограничения эксплуатации. Это обычный Markdown в папке `context/`, который фиксируется вместе с кодом, поэтому Git дает хранение, историю и распространение, а пулл-реквест показывает диффом и рассуждения. Скилл собирает рассуждения как побочный продукт разговора с агентом. При первом запуске он выполняет короткую настройку: где хранить, начинать ли с проактивной или явной записи, сколько подтверждений запрашивать. Автор приводит эксперимент: двадцать свежих сессий получили просьбу упростить обертку повторов. Без записанной причины семь из десяти снова предложили отвергнутое упрощение, а с одной записью в `context/` все десять ее нашли и не предложили. Рядом лежат линтер `keep-the-why-lint` на PyPI и GitHub Action, панель `keep-the-why-dashboard` и плагины для Claude Code, Codex и Cursor.
Для кого. Мейнтейнерам и командам, которые ведут долгоживущие кодовые базы с агентами и устали заново обсуждать уже принятые и отвергнутые решения.
Подходит, если
- Агент снова предлагает вариант, который вы уже отвергли, и причину никто не записал.
- В старом проекте остался странный код, и надо понять, это забор Честертона или мусор.
- Новому сотруднику или новому агенту нужны причины решений, а автор кода ушел.
- В пулл-реквесте хочется видеть изменения рассуждений рядом с изменениями кода.
Не подходит, если
- Нужна база данных или веб-сервис знаний: Keep the Why хранит все в Markdown без базы и без демона.
- Проект одноразовый и не будет жить долго: затраты на ведение причин не окупятся.
- Нужно восстановить все причины из истории задним числом: из кода, заявок и истории возвращается лишь часть, остальное допишет сопровождающий.
Пример запроса к агенту
Установи Keep the Why и настрой его в этом проекте с настройками по умолчанию, затем запиши причину отказа от упрощения обертки повторов.Ограничения
Навык сохраняет рассуждения по ходу работы с агентом, поэтому на старом репозитории он вернет лишь часть причин из кода, заявок и истории, остальное должен дописать сопровождающий, и это требует усилий. Установка идет командой `npx skills add` с указанием папки `skills/keep-the-why`, нужен Node.js; доступны также `gh skill install` и `asm install`. При первом запуске навык задает вопросы по настройке, поэтому ответ «настройки по умолчанию» считается полным. Агенты разных поставщиков следуют записи по-разному, матрица проверенных пар агент и модель опубликована на сайте проекта.
Как отключить. Удалите папку навыка `keep-the-why` из каталога навыков агента. Файлы `context/` останутся в репозитории как обычный Markdown, их можно удалить вручную.
Частые вопросы
Как установить Keep the Why?
Командой `npx skills add https://github.com/oliver-zehentleitner/keep-the-why/tree/latest/skills/keep-the-why`: скрипт спросит, для какого из более чем 70 агентов ставить.
Где хранятся причины решений?
В обычных Markdown-файлах папки `context/` внутри репозитория, рядом с кодом и под контролем Git.
Нужны ли база данных, демон или аккаунт?
Нет. Автор описывает проект как слой памяти без базы, демона и учетной записи.
Как проверять записи в CI?
Через линтер `keep-the-why-lint` с PyPI или одноименный GitHub Action.
Какие агенты проверены?
Claude Code, opencode, Pi, Hermes и другие. Таблица пар агент и модель лежит на keepthewhy.com/agent-matrix.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл настраивает для Codex память в файлах Markdown через AGENTS.md: профиль, правила, уроки, ошибки и заявки на возможности.
Локальная память для ИИ-агентов в обычных Markdown-файлах: запоминает только то, что вы одобрили, и отдает ее через MCP
Общая память команды и ИИ-агентов в Git: решения и передачи задач хранятся в Markdown и доступны из Claude Code и Codex.
Скиллы ведут память проекта в папке docs/ai: короткие файлы с лимитом размера, одна страница передачи дел и проверка установки
Intent CLI хранит в проекте цель, проверенную точку и решения, чтобы новая сессия агента продолжила работу
Agentic Substrate
Agentic Substrate (claude-user-memory)
Короткий обратимый набор правил для агента: исследуй неясное, планируй соразмерно, проверяй результат и храни выверенные знания
Коротко о README
В README изложена идея слоя «почему» для памяти проекта в репозитории, измеренный эксперимент с двадцатью сессиями, установка и ссылки на линтер, панель и сайт. Лицензия MIT.