В четвёртой части я вернулась к первой теме программы, Python и Git. И честно написала: Git у меня каждый день, но по одной дорожке. Правлю, сохраняю, выкладываю. Учебную задачу я вела в отдельной ветке, а слить её с основной собиралась спокойно, в самом конце.

Не вышло. Ветки научили меня раньше, на живом сайте. В пятой части рассказываю, как я запуталась, как мы с Claude это починили и какие правила теперь работают для всех моих ИИ-агентов.

Что случилось

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

А дальше жизнь пошла своим чередом. За два дня я выпустила три статьи, и публиковали их разные сессии Claude, каждая со своей задачей. Никто не проверил, на какой ветке стоит папка сайта. А она стояла на учебной. В итоге:

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

Заметили мы это случайно, по ошибке при отправке на GitHub. А если бы кто-то на следующий день выложил сайт из main, с сайта тихо пропали бы картинки и настройки новых статей.

Почему сайт обновился, а main нет

Здесь был мой главный инсайт. Я думала, что на сайт уходит «ветка». А на сайт уходят файлы из папки на моём ноутбуке. Выкладка берёт то, что сейчас в папке, и ей всё равно, какая ветка выбрана.

Ветка отвечает за другое: в какую историю попадёт изменение и что уедет в резервную копию. Простыми словами: сайт показывает, что сейчас на столе, а ветка решает, в какую тетрадь это запишется. Вот и вышло, что сайт новый, а в чистовике main он старый.

Почему это вообще случилось. У меня не один Claude, а несколько сессий одновременно. Одна учит меня Python, другая пишет статьи, третья делает презентацию. И все они работают в одной папке сайта.

В обычной команде у каждого разработчика своя копия проекта. У меня копия одна на всех. Значит, когда одна сессия переключает папку на учебную ветку, она переключает её и для всех остальных. А остальные об этом не знают.

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

Как мы это починили

Задача была с подвохом: перенести в main то, что уже на сайте, но не тащить туда недоделанную учёбу. Просто слить ветки было нельзя. Сделали так:

  • Сохранили всё в учебной ветке, чтобы ничего не потерять.
  • Переключили папку на main.
  • Забрали из учебной ветки только файлы сайта. В Git для этого есть команда, которая приносит нужные файлы из другой ветки, не переключаясь на неё.
  • Сохранили в main и отправили на GitHub.

Теперь main совпадает с сайтом, а учебная ветка ждёт меня. Заодно проверили, что в неё не попали ключи.

Одно забавное место: с первого раза не вышло. Скрипт писал свой журнал в папку, которую сам же и сохранял в Git. Журнал менялся прямо по ходу работы, и Git отказался переключать ветку с несохранёнными изменениями. Перенесли журнал в папку, которую Git игнорирует, и второй запуск прошёл. Так я заодно поняла, зачем нужен файл исключений .gitignore.

Правила, которые мы записали

Починить мало. Надо сделать так, чтобы через неделю несколько сессий не запутались снова. Правил получилось пять:

  • main — это то, что на сайте. Всё, что выкладывается, сохраняется только туда и сразу уходит на GitHub.
  • Учёба и эксперименты — в своих ветках. Из них ничего не публикуем.
  • Перед публикацией проверяем ветку. Должна быть main.
  • Закончил в ветке — верни папку на main. Папка общая, и по умолчанию она всегда стоит на чистовике.
  • Сливаем в main через запрос на слияние на GitHub, а не молча у себя на ноутбуке.

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

Один файл правил для всех агентов

Самое интересное: куда записать эти правила, чтобы их прочитала каждая новая сессия. У меня два уровня инструкций:

  • AGENTS.md — общие правила для всех ИИ-агентов и всех моих проектов: куда класть файлы, что нельзя удалять, где хранить ключи.
  • CLAUDE.md — правила конкретного проекта: как выкладывать сайт, как публиковать статьи. Теперь там есть и раздел про ветки.

Claude читает эти файлы в начале каждой сессии. Получается память команды: правило записано один раз, и его знает каждый новый «сотрудник». А AGENTS.md понимают и другие агенты, например Codex. Если завтра я пересяду на другой инструмент, мои правила переедут вместе со мной. Процесс живёт не в голове и не в чате, а в файле рядом с кодом.

Защита: не надеемся на внимательность

Правило в тексте можно пропустить. Агент торопится, контекст длинный, и человек тоже забывает. Поэтому главное правило мы вшили прямо в скрипты. Теперь перед публикацией и выкладкой сайта они спрашивают у Git, на какой они ветке. Если не на main, останавливаются и понятно объясняют, что делать. Это десяток строк кода.

В продуктовом дизайне это называется защитой от ошибки. Мы не пишем пользователю «будьте внимательны», а делаем так, чтобы ошибиться было нельзя. Смешно, но здесь пользователи — это я и мои агенты.

Моя карта: 12 тем и галочки

Как и в прошлых частях, отмечаю, где я сейчас. Галочку ставлю, когда тема пройдена на задаче из моего продукта и я могу объяснить, как всё устроено.

ТемаСамооценка на стартеПрогресс
1. Python и Gitчастичносейчас: ветки на практике
2. Работа с даннымичастично
3. Основы MLне делала
4. Основы глубокого обученияне делала
5. Как работают LLMчастично
6. LLM через APIделаю
7. Эмбеддинги и поискглавный пробел
8. RAG-системыглавный пробел✓
9. MCP и агентычастично
10. Мультиагентычастично
11. Оценка качестване делала
12. Публикация проектаделаю

Галочку у первой темы пока не ставлю: ветки стали практикой, но учебную задачу мы ещё не довели до конца.

Что я забираю себе

  • Сайт — это папка, а не ветка. Выкладка берёт то, что сейчас в папке. Ветка отвечает за историю и резервную копию.
  • Несколько агентов = команда. А команде нужны договорённости, записанные там, где их прочитает каждый.
  • Важное правило — в код, а не только в текст. Текст можно пропустить, проверку в скрипте нельзя.
  • Ошибка на живом проекте учит быстрее учебника. Про ветки я читала раньше. Поняла за один вечер, когда увидела, что мой сайт мог тихо откатиться.

В следующей части доведу учебную задачу до конца и солью ветку через запрос на слияние. Прошлые части серии: программа ИИ-инженера, недостающие кирпичики, что такое RAG, Python и Git.

Заметки о том, как я собираю продукты с ИИ, я пишу в своём канале: t.me/jd_tools_life. А если хочется пройти этот путь вместе, приходите на Product Builder Marathon: за 4 недели собираем работающий продукт с ИИ.