# explain-changes-mental-model

Команда explain-changes-mental-model раскладывает дифф на логические группы и подсказывает, в каком порядке их читать, чтобы коммит или ветка сложились в понятную картину.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 2707 у репозитория
- Автор: softaworks
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/softaworks/agent-toolkit/tree/HEAD/commands/explain-changes-mental-model.md
- Обновлён: 2026-03-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/explain-changes-mental-model

## Что делает

На входе хеш коммита, имя ветки, диапазон вроде `main..HEAD` или слово `custom`. Команда сама вызывает нужную git-команду, разбивает файлы на группы по смыслу (слой, фича, тип правки) и выясняет, какая группа от какой зависит. В конце выдаёт порядок чтения.

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

Без аргумента она видит только незакоммиченные правки через `git diff HEAD`, так что в чистом рабочем дереве разбирать будет нечего. Ветку она сравнивает с `main` или `master`; если главная ветка называется иначе, диапазон задайте сами. Дифф длиннее 5000 строк сначала смотрят через `--stat`, и первый проход выходит обзорным.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/commands/explain-changes-mental-model.md` — Вызов — /explain-changes-mental-model. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/explain-changes-mental-model.md` — Вызов — /prompts:explain-changes-mental-model. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/explain-changes-mental-model.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/explain-changes-mental-model.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/softaworks/agent-toolkit/tree/HEAD/commands/explain-changes-mental-model.md

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

## Примеры запросов агенту
- \`/explain-changes-mental-model abc1234` — разложи коммит на логические группы и скажи, в каком порядке его читать.
- \`/explain-changes-mental-model feature/my-branch` — что изменилось относительно основной ветки и с чего начать ревью?
- \`/explain-changes-mental-model custom` — сейчас пришлю дифф, разбери его по шагам.

## Похожие
- [code-review-recent-changes](https://affpapa.org/nevibecode/skills/code-review-recent-changes.md) — скилл · ★ 173 у репозитория
- [explain-diff](https://affpapa.org/nevibecode/skills/nick-nisi-explain-diff.md) — скилл · ★ 114 у репозитория
- [review-local-changes](https://affpapa.org/nevibecode/skills/review-local-changes.md) — скилл · 1300 установок
- [review-and-simplify-changes](https://affpapa.org/nevibecode/skills/review-and-simplify-changes.md) — скилл · 872 установки
- [tasks-explain-diff](https://affpapa.org/nevibecode/skills/tasks-explain-diff.md) — скилл · ★ 40 у репозитория
- [explain-pr](https://affpapa.org/nevibecode/skills/explain-pr.md) — скилл · ★ 1636 у репозитория

Из того же набора: [softaworks/agent-toolkit](https://affpapa.org/nevibecode/by/softaworks/agent-toolkit.md) — 79 карточек

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

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