# keep-the-why

Плагин сохраняет причины архитектурных решений, отказов и обходных путей рядом с кодом. Пригодится для долгоживущих репозиториев и работы нескольких агентов.

- плагин · `type=plugin` · GitHub Copilot · ★ 231
- Автор: Oliver Zehentleitner
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/oliver-zehentleitner/keep-the-why
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/plugins/keep-the-why

## Что делает

keep-the-why добавляет в репозиторий слой памяти о причинах изменений. Агент фиксирует архитектурные решения, отвергнутые варианты, обходные пути, выводы из инцидентов и операционные ограничения, которые сам код не объясняет. Записи хранятся в Markdown-каталоге `context/`, поэтому они живут рядом с кодом и попадают в историю Git.

Плагин рассчитан на работу через разговор с агентом: рассуждения по ходу задачи превращаются в записи, которые можно использовать в следующих сессиях. В уже существующем репозитории история, задачи и код восстановят лишь часть контекста, а остальное придётся заполнить сопровождающему. Это ограничение особенно заметно при переносе старого проекта в новую команду.

## Установка

### GitHub Copilot (родная платформа)

**Команда из источника**
```bash
copilot plugin install keep-the-why@awesome-copilot
```

## Когда брать
- сохранять причины архитектурных решений
- фиксировать отвергнутые варианты
- записывать обходные пути и выводы из инцидентов
- передавать контекст следующему агенту
- восстанавливать историю решений в старом репозитории

## Примеры запросов агенту
- Сохрани в `context/` причину, по которой этот вариант архитектуры выбран вместо альтернативы.
- Запиши, почему обходной путь в `src/retry.ts` нельзя удалять при рефакторинге.
- Проверь историю решений в `context/` перед изменением этого модуля.

## Похожие
- [ponytail](https://affpapa.org/nevibecode/plugins/ponytail.md) — плагин · ★ 177259
- [impeccable](https://affpapa.org/nevibecode/plugins/impeccable.md) — плагин · ★ 89321
- [last-30-days-skill](https://affpapa.org/nevibecode/plugins/last-30-days-skill.md) — плагин · ★ 65596
- [claude-hud](https://affpapa.org/nevibecode/plugins/claude-hud.md) — плагин · ★ 28914
- [understand-anything](https://affpapa.org/nevibecode/plugins/understand-anything.md) — плагин · ★ 88429
- [mem0](https://affpapa.org/nevibecode/plugins/mem0.md) — плагин · ★ 67869

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md