Git для работы с AI-агентом: ветки, откаты, ревью
Агент может переписать двадцать файлов за минуту. Если эти правки нельзя посмотреть по отдельности и отменить, вы зависите от того, угадал он или нет. Git превращает работу с агентом в процесс, где каждый шаг виден и обратим.
Ничего нового для этого изучать не нужно: те же коммиты, ветки и диффы, что и в работе с людьми. Меняется только цена ошибки. Человек пишет медленно и помнит, что делал. Агент пишет быстро, а в следующем сеансе не помнит ничего — и единственная память о том, что и зачем менялось, остаётся в истории репозитория.
Коммит перед каждой задачей
Прежде чем отдать агенту задачу, закоммитьте то, что есть. Тогда любая неудача агента — это git restore .11git restore . возвращает отслеживаемые файлы к состоянию индекса. Новые файлы агента останутся: удаляет их git clean -fd, а git clean -n сначала покажет список. или откат к коммиту, а не попытка вспомнить, как было. Маленькая задача — маленький дифф, который реально прочитать.
git status # что изменено прямо сейчас
git add -A && git commit -m "Форма заявки: валидация телефона"
Чистое рабочее дерево перед задачей полезно ещё по одной причине: после работы агента в git status и git diff будут только его правки, не смешанные с вашими вчерашними.
Если бросать начатое жалко, а коммитить рано, есть git stash: он убирает незакоммиченные правки в карман и возвращает их по git stash pop. Но для работы с агентом надёжнее обычный коммит с пометкой WIP — его видно в истории, и он не потеряется.
Отдельная ветка на задачу
Ветка — дешёвый способ попробовать. Агент работает в своей ветке, вы смотрите результат, и только после этого правки попадают в main. Не понравилось — ветку можно просто удалить. Несколько агентов параллельно — несколько веток или рабочих копий, и они не мешают друг другу.
# новая ветка для задачи
git switch -c agent/phone-validation
# отдельная папка и ветка для второго агента
git worktree add ../shop-search -b agent/search
Рабочие копии22git worktree открывает несколько рабочих копий одного репозитория. У каждого агента своя папка и ветка, а история Git общая. нужны, когда агентов больше одного. Два агента в одной папке правят одни и те же файлы, запускают тесты на чужом недописанном коде и коммитят вперемешку. В отдельных папках каждый видит только свою задачу, а встречаются правки уже при слиянии — там, где конфликт виден и разбирается осознанно. Когда задача закончена, рабочую копию убирает git worktree remove ../shop-search; ветка при этом остаётся, пока вы не сольёте или не удалите её отдельно.
Имена веток стоит делать говорящими: agent/search, fix/login-timeout. Через неделю по списку веток должно быть понятно, что из этого ещё живо, а что можно удалить.
Ревью диффа, а не пересказа
Агент обычно пишет, что сделал. А git diff покажет, что он поменял ещё и то, о чём не говорил: удалил проверку, переименовал поле, поправил «заодно» соседний файл. Читать стоит именно дифф, а для крупных задач — пулреквест, где правки видны целиком.
git diff --stat # какие файлы затронуты и насколько
git diff main...HEAD # всё, что сделано в ветке
git add -p # принять правки по кускамНачинать удобно с --stat. Задача была про форму заявки, а в списке — конфиг сборки, файл с зависимостями и три теста? Это не обязательно ошибка, но каждое такое место нужно открыть. На что смотреть в первую очередь:
- удалённые и ослабленные тесты — самый быстрый для агента способ сделать тесты зелёными;
- новые зависимости и изменения в lock-файле;
- конфигурация: линтер, CI, права, переменные окружения;
- правки вне задачи — «заодно» отформатированный файл прячет содержательные изменения в шуме.
git add -p позволяет принять дифф не целиком. Git показывает правки по одному куску и на каждый спрашивает, брать его или нет. Хорошие куски уходят в коммит, сомнительные остаются в рабочем дереве, и о них можно спросить агента отдельно.
Три уровня отката
Откатывать приходится по-разному, в зависимости от того, как далеко правка успела уйти.
Ничего не закоммичено. git restore <файл> отменяет правки в одном файле, git restore . — во всех.
Закоммичено, но не отправлено. git reset --soft HEAD~1 убирает последний коммит и оставляет его правки в рабочем дереве — можно поправить и закоммитить заново. git reset --hard HEAD~1 убирает коммит вместе с правками.
Уже отправлено на сервер. Историю, которую видят другие, не переписывают. git revert <коммит>44git revert не стирает коммит, а добавляет новый с обратными правками. Поэтому он безопасен для общих веток: история у всех остаётся той же, просто становится на один коммит длиннее. создаёт новый коммит, отменяющий старый.
И страховка на случай, когда reset --hard сделан зря: git reflog55Reflog хранится только в локальной копии и не вечно: по умолчанию от 30 до 90 дней. Незакоммиченные правки в него не попадают: их reset --hard стирает безвозвратно.. Это журнал всех положений HEAD, и «потерянный» коммит в нём почти всегда находится: достаточно найти нужную строку и вернуться к ней через git reset --hard <хэш> или создать на этом месте ветку.
История, которую потом можно читать
Пусть агент пишет понятные сообщения коммитов: что и зачем изменено. Через месяц по истории можно будет понять, откуда взялась строчка, и откатить ровно одну правку, а не неделю работы.
Для этого коммиты должны быть небольшими и об одном. «Добавил поиск, поправил вёрстку шапки и обновил зависимости» в одном коммите невозможно ни отревьюить, ни отменить по частям. Попросите агента коммитить после каждого законченного шага — и запишите это в правила проекта, чтобы не повторять в каждом сеансе.
Аккуратная история окупается, когда что-то ломается. git log -S "строка" находит коммиты, где эта строка появилась или исчезла. git blame показывает, каким коммитом написана каждая строка файла. А если непонятно, когда именно сломалось поведение, помогает git bisect66git bisect ищет коммит, после которого что-то сломалось, двоичным поиском: вы отмечаете один хороший и один плохой коммит, а Git предлагает проверять середину. На тысячу коммитов хватает около десяти проверок..
Что агенту нельзя
Защитите главную ветку: изменения в main — только через пулреквест. Секреты — в .gitignore, а не в репозитории: агент легко закоммитит .env77Удалить файл с ключом следующим коммитом недостаточно: он остаётся в истории. Ключ, попавший в коммит, считают скомпрометированным и перевыпускают., если его не остановить. Опасные команды вроде git push --force и git reset --hard лучше разрешать только вручную.
Список команд, после которых может не быть пути назад, короткий:
git push --force— перезаписывает историю на сервере;git reset --hardиgit checkout .— стирают незакоммиченные правки;git clean -fd— удаляет неотслеживаемые файлы, включая те, что вы забыли добавить;git branch -D— удаляет ветку, даже если она не слита.
Если переписать свою ветку на сервере всё-таки нужно — например, после перебазирования, — используйте git push --force-with-lease. Он откажется затирать ветку, если на сервере появились коммиты, которых вы ещё не видели.
Одной просьбы «не делай force push» в правилах проекта мало: правило агент читает и может не выполнить. Надёжнее запрет на уровне инструмента. В Claude Code это правила разрешений и хуки, которые срабатывают независимо от того, что решила модель.
Порядок работы целиком
- Закоммитить текущее состояние, убедиться, что
git statusчист. - Создать ветку или рабочую копию под задачу.
- Отдать агенту одну задачу с понятным критерием готовности.
- Посмотреть
git diff --stat, затем дифф целиком. - Принять хорошее, вернуть на доработку сомнительное, закоммитить.
- Открыть пулреквест, дождаться проверок, слить в
main. - Удалить ветку и рабочую копию.
На маленькой задаче весь круг занимает несколько минут.
Как Git хранит историю, как откатываться без потерь, разбирать конфликты и работать в одном репозитории с агентом — на курсе «Git и GitHub». Команды пробуете в песочнице прямо в уроке.
Курсы по теме
У каждого курса есть бесплатная часть: оставьте почту и начните сразу.
Git и GitHub
Нужен в каждой командеС нуля14 уроков бесплатно →Основы Claude Code
Стандарт агентной работыС нуля14 уроков бесплатно →
Как настроить хуки в Claude Code. Чем хуки отличаются от CLAUDE.md и прав доступа, какие события они ловят и как за вечер настроить автоформатирование, запрет правок в .env и уведомления.