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

БАЗА GUIDE 03 / 19 · МАРШРУТ НОВИЧКА

Как проходить этот гайд, если ты вообще не программист

Читать сейчас?Да. Git - это страховка твоего проекта и история изменений.
Внедрять сейчас?Да, до серьёзных изменений.
Зачем это знать?Если ИИ сломает проект, Git позволяет увидеть, что поменялось, и вернуться к рабочей версии.

Что сделать по шагам

  1. Проверь, что проект находится в Git.
  2. Убедись, что .env и секреты не попадут в репозиторий.
  3. Сделай маленькое изменение через отдельную ветку, посмотри diff и сохрани рабочий commit.
Урок закрыт, когда: Есть репозиторий, README, безопасный .gitignore, понятный commit и проверенный путь отката.
Простой пример: ИИ меняет текст кнопки в README/интерфейсе. Ты смотришь diff, проверяешь результат и только потом сохраняешь изменение.

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

Хардкодинг PRO • Гайд №03

Git и GitHub для вайбкодинга

Как безопасно работать с проектами вместе с ИИ, сохранять рабочие версии, видеть каждое изменение и не бояться экспериментов.

Git простым языкомGitHubБезопасностьРабота с ИИОткат
Павел Думбрао
Сохраняй. Проверяй. Экспериментируй.

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

1. Зачем тебе Git

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

Без Git
  • папки final, final2, real_final;
  • непонятно, что изменилось;
  • страшно давать ИИ доступ;
  • откат превращается в ручную археологию;
  • рабочая версия легко теряется.
С Git
  • есть история изменений;
  • видна точная разница между версиями;
  • эксперименты делаются отдельно;
  • каждый рабочий этап фиксируется;
  • можно вернуться назад.
Главная мысль: Git не делает плохой код хорошим. Он делает изменения контролируемыми и обратимыми.

2. Git и GitHub без путаницы

Git

Git - система контроля версий. Она хранит историю проекта и знает, что изменилось между состояниями.

GitHub

GitHub - облачный сервис для Git-репозиториев, совместной работы, проверки кода и автоматизации.

Проще: Git - механизм истории. GitHub - удобное облачное место вокруг этой истории.

Словарь, который реально нужен

Репозиторий, repositoryПапка проекта, в которой Git ведёт историю.
Commit, коммитЗафиксированная точка состояния проекта с понятным описанием.
Branch, веткаОтдельная линия работы, где можно экспериментировать, не ломая основную версию.
DiffТочная разница: что добавилось, удалилось и изменилось.
PushОтправить локальные commits в GitHub.
PullПолучить свежие изменения из удалённого репозитория.
MergeОбъединить изменения одной ветки с другой.
Pull Request, PRЗапрос на объединение ветки и удобное место для проверки перед merge.
Git хранит историю изменений
Git хранит историю изменений

3. Базовый рабочий цикл

Тебе не нужно становиться Git-инженером. Для начала достаточно понимать один цикл и уметь попросить ИИ выполнить его правильно.

1
Изменил файлы.
Ты или ИИ внесли изменения.
2
Проверил diff.
Посмотрел, что именно поменялось.
3
Проверил результат.
Запустил тесты, сайт, бота или другой сценарий.
4
Сделал commit.
Зафиксировал рабочий этап.
5
Сделал push.
Отправил историю в GitHub.
git status
git diff
git add .
git commit -m "Добавил авторизацию"
git push
подход через ИИ подход: команды может выполнять агент. Твоя задача - понимать, какое действие происходит, зачем оно нужно и какое состояние проекта после него.
Git и GitHub: локальная история и удалённый репозиторий
Git и GitHub: локальная история и удалённый репозиторий

4. Твой первый проект

1
Установи Git. На Mac и Windows это можно поручить Codex, если у него есть доступ.
2
Создай аккаунт GitHub. Это будет облачное хранилище проектов.
3
Создай приватный репозиторий. Для учебного и клиентского проекта начинай с private.
4
Свяжи локальную папку с GitHub. Агент может настроить remote сам.
5
Измени один файл. Например README.md.
6
Сделай commit и push. Это первая реальная точка сохранения.
7
Проверь GitHub. Новый файл и commit должны быть видны.
Первый микро-результат: ты поменял файл локально, сохранил изменение в Git и увидел его на GitHub. На этом этапе этого достаточно.
Первый репозиторий: файлы, commit и push
Первый репозиторий: файлы, commit и push

5. Как работать с ИИ безопасно

Безопасность не означает «не давать ИИ доступ». Нормальная архитектура означает управляемый доступ: агент получает достаточно прав для работы, но последствия его действий ограничены.

Перед изменениями

  • рабочая версия сохранена;
  • git status понятен;
  • нет потерянного незакоммиченного кода;
  • для эксперимента создана отдельная ветка;
  • секреты исключены из Git.

После изменений

  • посмотрел diff;
  • запустил тест или реальный сценарий;
  • понял, какие файлы изменены;
  • сделал commit только после проверки;
  • опасные действия подтверждены человеком.
Человек в контуре, Human in the Loop: публикация, удаление данных, merge важных изменений, миграции базы, платежи и другие действия с последствиями должны иметь явное подтверждение.
Безопасный цикл: branch → проверка → commit → push
Безопасный цикл: branch → проверка → commit → push

6. Секреты, ключи и доступы

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

Никогда не коммить: API-ключи, Telegram bot token, пароли, SSH private key, session string, cookies, .env с реальными секретами и дампы с персональными данными.

.env и .gitignore

.env обычно хранит секреты локально. .gitignore говорит Git, какие файлы не нужно отслеживать.

# .gitignore
.env
.env.*
*.key
*.pem
node_modules/
.venv/
__pycache__/
*.log

Можно хранить

.env.example без реальных секретов. Он показывает, какие переменные нужны проекту.

Если секрет утёк

Считай его скомпрометированным: отзови ключ, создай новый, потом разбирайся с историей Git.

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

7. Реальный пример: ты и ИИ создаёте Telegram-бота

1
Ты формулируешь задачу и критерии результата.
2
Создаёшь приватный GitHub-репозиторий.
3
ИИ создаёт структуру проекта и первый рабочий каркас.
4
Сохраняется первый рабочий commit.
5
Для следующей функции создаётся отдельная ветка.
6
ИИ пишет код, ты проверяешь diff и сценарий.
7
Тестируете бота в Telegram.
8
Только после успешной проверки делаете merge и push.
Смысл: Git позволяет двигаться быстро именно потому, что ты не боишься каждого изменения.
Секреты не должны попадать в Git
Секреты не должны попадать в Git

8. Типичные ошибки новичка

Работать без GitСначала кажется быстрее. После первой серьёзной ошибки становится сильно дольше.
Работать только в mainЛюбой эксперимент сразу затрагивает стабильную версию.
Делать огромные commitsПотом невозможно понять, какое изменение сломало систему.
Писать commit «fix»Через неделю никто не понимает, что именно исправлялось.
Коммитить секретыКлюч может остаться в истории даже после удаления из текущего файла.
Не смотреть diff ИИАгент может изменить соседние файлы, зависимости или конфигурацию.
Не тестировать до mergeОсновная ветка превращается в место экспериментов.
Бояться GitЧеловек лишает себя простого способа безопасно экспериментировать.
Откат: возвращаем рабочую версию
Откат: возвращаем рабочую версию

9. Как откатываться, если ИИ что-то сломал

Не начинай хаотично чинить поверх сломанного состояния. Сначала зафиксируй факты.

1
Остановись. Не добавляй ещё десять изменений.
2
Посмотри status и diff. Пойми текущее состояние.
3
Посмотри историю commits. Найди последнюю известную рабочую точку.
4
Сохрани ценное. Полезные незакоммиченные изменения не должны исчезнуть.
5
Выбери способ возврата. Отмена commit, новая ветка от рабочей версии или другой безопасный вариант.
6
Проверь после отката. Возврат к commit ещё не доказывает, что сервис восстановился.
Не пиши «верни всё как было». Сначала попроси ИИ показать, что он считает последней рабочей версией и какие изменения будут потеряны.
Git и GitHub освоены
Git и GitHub освоены

10. Готовые промпты

Используй их как стартовый стандарт и адаптируй под конкретный проект.

Промпт 1. Подготовить проект к Git

Промпт 2. Правила безопасной работы для ИИ-кодера

Промпт 3. Проверка перед объединением изменений (merge)

Промпт 4. Безопасное восстановление

11. Чек-лист самопроверки

Отметь пункты честно. Это не экзамен. Это диагностика того, насколько твой проект защищён от хаоса.

Отмечено: 0 из 24.
Начни с базовых пунктов и двигайся постепенно.
Стоп-факторы: не расширяй автономность ИИ, если секреты лежат в коде, рабочая версия не сохранена, непонятно что в main, агент может удалять production-данные без подтверждения или ты не знаешь, как вернуться к рабочей версии.

12. Практика после гайда

Пройди полный Git-цикл на своём реальном проекте

  1. Выбери один текущий проект.
  2. Проверь или инициализируй Git.
  3. Создай приватный GitHub-репозиторий, если его ещё нет.
  4. Проверь .gitignore и секреты.
  5. Сделай рабочий commit.
  6. Создай отдельную учебную ветку.
  7. Попроси AI изменить одну небольшую функцию или README.
  8. Посмотри diff и объясни себе, что изменилось.
  9. Запусти проверку результата.
  10. Сделай commit и push ветки.
  11. Попроси AI описать безопасный способ отменить изменение.
  12. Заполни чек-лист выше.

Что принести на разбор: ссылку на repo, название ветки, последний commit, результат проверки и один абзац «что я теперь понимаю про Git».

Главный вывод

Git не нужен, чтобы выглядеть программистом. Он нужен, чтобы быстро двигаться и не бояться сломать результат.

Рабочая формула: рабочая версия → отдельное изменение → diff → тест → commit → push → следующий шаг.

Когда эта привычка становится автоматической, ИИ получает больше свободы, а ты не теряешь контроль.

Официальные источники и дата проверки · 10.10.2026

Данные проверены: 10.10.2026. Кнопки и интерфейс GitHub могут меняться. Перед важными действиями сверяй актуальные инструкции с официальной документацией. Не публикуй API-ключи и не применяй разрушительные команды без проверки diff и резервной копии.

GitHub: Hello World

GitHub: Pull Request

GitHub: Git Basics

Git: switch

Сначала практика: GitHub для вайбкодера ↗

Хардкодинг PRO • Гайд №07 • Git и GitHub для вайбкодинга
Перед переходом дальше: Переходи дальше, когда сделал минимальную практику этого урока и можешь показать результат. Кнопка «Дальше» означает следующий учебный урок, а не обязанность внедрить каждую технологию.
Перейти к самопроверке