В четвёртой части я вернулась к первой теме программы, 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 недели собираем работающий продукт с ИИ.