HARDCODING PRO GITHUB + AI

GitHub для вайбкодера.
Что это и с чем это едят?

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

Главный результат: ты даёшь ИИ идею обычными словами, а агент сам создаёт ветки, commits, Pull Requests, запускает проверки и сохраняет рабочий результат в GitHub.
6 практических результатов12 визуальных схемPR + ActionsRollback + Secrets

Начни отсюда: два готовых промпта

Выбери свою ситуацию. Скопируй промпт в Codex / Claude Code и отвечай только на 5 вопросов. GitHub-рутину агент делает сам.

НОВЫЙ ПРОЕКТ

Создать GitHub-проект с нуля

Для новой идеи, бота, сайта, агента, автоматизации или любого другого проекта.

Шаблон: PavelDumbrao/hardcoding-github-vibecoder-starter

Вставь агенту целиком.
ПРОЕКТ УЖЕ ЕСТЬ

Перевести существующий проект в GitHub

Для папки на Mac, проекта на VPS, архива или старого репозитория, в котором уже что-то работает.

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

Главная мысль

GitHub для вайбкодера = память проекта + история + страховка + рабочее место для ИИ.

Ты ставишь задачу→ИИ читает GitHub→делает изменения→проверяет→GitHub сохраняет результат

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

Весь практикум

0. Два стартовых промпта 1. Что такое GitHub простыми словами 2. Зачем GitHub вайбкодеру 3. Семь слов, которые нужно понять один разGitHub CLI (gh): даём ИИ руки на Mac и VPS4. GitHub Actions: автоматические проверки и деплой 4. Новый проект, шаблон или существующий проект 5. Безопасный workflow с ИИ Pull Request Template: единый стандарт изменений7. Практика: шесть реальных результатов 7. Готовые рабочие промпты 9. GitHub Secrets: где хранятся ключи и токены 9. Что не надо делать 10. Когда GitHub настроен правильно

1. Что такое GitHub простыми словами

Представь Google Drive для проекта, который помнит не только файлы, но и каждое изменение.

Хранилище проекта

Код, файлы, инструкции, тесты и документация лежат в одном месте.

История

Видно, что менялось и когда. Можно сравнить версии и вернуться назад.

Рабочая среда для ИИ

Агент читает фактический проект, а не пытается вспомнить его по старому чату.

Репозиторий - это просто отдельный дом для одного проекта.
GitHub для вайбкодера простыми словами
GitHub как центр управления проектами и ИИ: код, история, структура, проверки и результат.

2. Зачем GitHub именно вайбкодеру

GitHub для вайбкодера: зачем он нужен
Проект хранится в GitHub, ИИ видит актуальный контекст, история сохраняется, а результат можно развивать дальше.

3. Семь слов GitHub, которые нужно понять один раз

Repository / репозиторий
Проект целиком: файлы + история + настройки.
Commit
Контрольная точка. ИИ закончил понятный кусок работы и зафиксировал состояние.
Branch / ветка
Безопасная отдельная линия для эксперимента. Рабочий main не ломается.
Pull Request
Предложение добавить изменения из ветки в рабочую версию. Здесь видно, что именно меняется и какие проверки прошли.
Main
Главная рабочая ветка. Здесь должна находиться подтверждённая стабильная версия проекта.
GitHub Actions
Автоматические проверки: тесты, сборка, безопасность, иногда деплой.
Release
Зафиксированный выпуск продукта: например v1.0, v1.1 или v2.0.
Не надо учить команды наизусть. Нужно понимать, что делает ИИ и почему рабочая версия защищена.
Семь слов GitHub для вайбкодера
Repository, commit, branch, Pull Request, main, GitHub Actions и release — базовая логика проекта без ручного Git.

GitHub CLI (`gh`): развязываем ИИ руки

GitHub в браузере нужен тебе. GitHub CLI нужен твоему ИИ-агенту.

Главная идея: если Codex / Claude Code имеет терминал и авторизованный gh, он может сам выполнять почти всю GitHub-рутину: создавать репозитории, Pull Request, Issues, Releases, смотреть Actions, checks и безопасно настраивать Secrets.
MAC

На твоём Mac

ИИ проверяет, установлен ли gh. Если нет, сам устанавливает официальный GitHub CLI подходящим способом. На Mac нормальный путь обычно через Homebrew, если он уже используется.

Тебе остаётся только один раз подтвердить вход в свой GitHub через безопасный браузерный flow.

VPS

На сервере

ИИ определяет Linux-дистрибутив и сам устанавливает официальный GitHub CLI. Потом авторизует GitHub через безопасный browser/device flow и проверяет доступ.

Если агент работает и на Mac, и на VPS, авторизация проверяется отдельно на каждой машине.

Что ИИ получает через `gh`

Репозитории

Создать, клонировать, посмотреть настройки и открыть проект.

Pull Request

Создать PR, посмотреть diff, дождаться checks, сделать review и merge.

Actions

Смотреть workflow, запуски, логи и результат автоматических проверок.

Issues / Projects

Создавать задачи, обновлять backlog и связывать код с задачами.

Secrets

Создавать и проверять наличие Secrets без хранения значения в репозитории.

Releases

Создавать стабильные версии, tags и release notes.

Важно: не надо давать ИИ токен текстом в чат. Нормальный путь - gh auth login с безопасным подтверждением аккаунта. После этого ИИ проверяет состояние через gh auth status. Команды, которые показывают сам токен, в обычной работе не нужны.
Бонус: современные версии GitHub CLI также могут поддерживать официальный agent skill для работы coding agents с gh. Это полезное усиление, но не обязательное условие Hardcoding PRO.
Подходит для Mac и VPS.

GitHub Actions: твой автоматический технарь внутри GitHub

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

Pull Request
GitHub Actions
Тесты
Зелёный результат
Merge в main

Что такое Actions простыми словами

Это автоматические сценарии внутри GitHub. Они запускаются сами, когда происходит нужное событие: например, создан Pull Request, отправлен новый commit, изменения попали в main или ты нажал кнопку ручного запуска.

Где это находится

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

Что Actions может делать за тебя

Очень упрощённо: файл внутри .github/workflows/ говорит GitHub: «когда произошло X, сделай Y и проверь Z». Писать этот файл руками тебе не нужно, его создаёт ИИ.
1

Событие

Например: создан Pull Request или изменения отправлены в main.

2

Job

Отдельная автоматическая работа, например «проверить проект» или «развернуть на сервере».

3

Steps

Конкретные шаги внутри работы: скачать код, поставить зависимости, запустить тесты, собрать продукт.

Для вайбкодера главное: ты не пишешь Actions вручную. Ты говоришь ИИ: «настрой автоматическую проверку проекта перед merge», а он сам определяет стек, создаёт workflow, запускает его и показывает зелёный результат.
ИИ сам определит, какие проверки нужны проекту.

4. Три способа начать проект

С НУЛЯ

Новый репозиторий

Когда есть только идея. ИИ создаёт структуру, README, PROJECT, TASKS и первый commit.

БЫСТРО

Template Repository

Берём проверенный шаблон и создаём новый независимый проект с готовой структурой. Именно так работают наши Hardcoding PRO starters.

УЖЕ ЕСТЬ

Подключить существующий проект

ИИ сначала изучает фактические файлы и секреты, потом аккуратно делает GitHub источником правды.

Template ≠ Fork. Для нового продукта из нашей заготовки обычно нужен template. Fork чаще нужен, когда ты хочешь изменить чужой проект и потенциально отправить изменения обратно автору.
Новый проект через GitHub за пять шагов
Идея → ИИ создаёт репозиторий → структура → первый commit → готовая база для вайбкодинга.

5. Безопасный workflow, который ИИ должен делать сам

main не трогаем напрямую для заметных изменений.

origin/main→feature branch→ИИ меняет код→тесты→Pull Request→GitHub Actions→merge в main

Почему это безопасно

Если эксперимент плохой, main остаётся рабочим. Изменения можно посмотреть до объединения.

Почему это удобно с ИИ

Агент сам ведёт технический процесс, а ты получаешь ссылку на PR и понятный результат.

Безопасный GitHub workflow с ИИ
Рабочая версия main → ветка → изменения ИИ → тесты → Pull Request → Actions → merge.

Pull Request Template: ИИ всегда объясняет изменения одинаково

Pull Request не должен выглядеть как «что-то поменял, вроде работает». Шаблон заставляет ИИ каждый раз показать результат по одной понятной структуре.

Где хранится: .github/pull_request_template.md. Когда создаётся новый Pull Request, GitHub подставляет содержимое шаблона в описание PR.

Что должно быть в каждом PR

  • что изменено;
  • зачем это нужно;
  • как проверено;
  • какие есть риски;
  • не попали ли секреты;
  • обновлена ли документация;
  • прошли ли GitHub Actions;
  • готово ли изменение к merge.

Почему это особенно важно с ИИ

ИИ может делать много изменений очень быстро. PR Template заставляет его остановиться и сформулировать факты: что он реально сделал, что проверил и почему изменение безопасно объединять.

Если проект потом возьмёт другой ИИ или человек, история Pull Request становится понятной документацией проекта.

Шаблон Hardcoding PRO

ИИ сам добавит шаблон в проект.
GitHub CLI и Pull Request Template для ИИ-агента
GitHub CLI даёт ИИ руки внутри GitHub, а Pull Request Template делает каждое изменение понятным и проверяемым.

Практика: шесть результатов подряд

Практика 1. Создай свой GitHub-проект

Используй первый стартовый промпт. Ответь на 5 вопросов. ИИ должен создать твою копию шаблона, заполнить PROJECT.md и провести первую задачу до main.

Что сказать ИИ

Вставь в Codex / Claude Code целиком.
Что должно получиться:
  • Собственный GitHub-репозиторий создан из шаблона.
  • PROJECT.md заполнен под реальный проект.
  • TASKS.md содержит текущую и следующую задачу.
  • Первая задача прошла через отдельную ветку и Pull Request.
  • GitHub Actions зелёные.
  • Результат находится в main.
  • ИИ дал ссылку на репозиторий и итоговый commit.

Практика 2. Добавь одну функцию через Pull Request

Возьми промпт «Добавить функцию безопасно» ниже. Выбери маленькое улучшение и заставь ИИ провести его через отдельную ветку.

Что сказать ИИ

Вставь в Codex / Claude Code целиком.
Что должно получиться:
  • Создана отдельная feature-ветка.
  • Функция реализована и проверена.
  • Создан Pull Request с понятным описанием.
  • GitHub Actions зелёные.
  • Pull Request объединён в main.
  • ИИ дал ссылку на PR и итоговый commit.

Практика 3. Научись возвращаться назад

На тестовом или безопасном изменении используй промпт отката. Главная цель не сломать проект, а понять, что GitHub хранит путь назад.

Что сказать ИИ

Вставь в Codex / Claude Code целиком.
Что должно получиться:
  • ИИ нашёл рабочую контрольную точку.
  • Откат сделан без удаления истории и без force push в main.
  • Создан Pull Request на возврат рабочего состояния.
  • Проверки прошли.
  • Main снова содержит ожидаемую рабочую версию.
  • ИИ дал ссылку на PR и commit отката.

Практика 4. Открой новый чат и ничего не объясняй

Создай новый чат с ИИ. Дай только ссылку на GitHub и промпт восстановления контекста.

Что сказать ИИ

Вставь в Codex / Claude Code целиком.
Что должно получиться:
  • Новый ИИ-чат сам понял, что это за проект.
  • Он назвал текущую рабочую версию и commit в main.
  • Он перечислил открытые задачи из TASKS.md.
  • Он увидел Pull Requests и GitHub Actions.
  • Он предложил логичный следующий шаг.
  • Ты не пересказывал ему прошлый чат.
Путь вайбкодера с GitHub
От понимания GitHub и шаблонов до AI-workflow, деплоя и реального проекта.

Практика 5. Настрой GitHub Actions

Теперь GitHub будет сам проверять изменения до попадания в рабочую версию.

Что сказать ИИ

Вставь в Codex / Claude Code целиком.
Что должно получиться:
  • В репозитории появился workflow внутри .github/workflows/.
  • Он запускается автоматически на Pull Request.
  • GitHub Actions выполнил реальные проверки проекта.
  • Первый красный запуск, если он был, ИИ сам диагностировал и исправил.
  • Есть ссылка на зелёный Actions run.
  • Изменения объединены в main только после успешных проверок.

Практика 6. Подключи секрет безопасно

На этой практике ты увидишь разницу между секретом в чате, локальным .env и специальным хранилищем GitHub Secrets.

Что сказать ИИ

Вставь в Codex / Claude Code целиком.
Что должно получиться:
  • Определено, действительно ли секрет нужен workflow.
  • Реальное значение не появилось в чате или Git.
  • Секрет хранится в GitHub Secrets на правильном уровне.
  • Workflow использует secret без вывода его значения.
  • GitHub Actions зелёный.
  • ИИ подтвердил, что secret отсутствует в diff и Git-истории.
Шесть результатов — отметь, что реально сделал0/6
  • Создан собственный GitHub-репозиторий и первая задача дошла до main.
  • Одна функция прошла через отдельную ветку и Pull Request.
  • Ты безопасно вернулся к рабочей версии без уничтожения истории.
  • Новый ИИ-чат восстановил проект только по ссылке GitHub.
  • GitHub Actions реально проверяет Pull Request и показывает зелёный run.
  • Секрет подключён через GitHub Secrets и не попал в чат, diff или историю Git.

7. Готовые промпты для работы через GitHub

Копируй нужный блок. Техническую работу делает агент.

Добавить функцию безопасно

Feature → PR → main.

Исправить баг

Не переписывать всё с нуля.

Проверить Pull Request

Перед merge.

Безопасно откатиться

Без force push в main.

Продолжить в новом чате

GitHub восстанавливает контекст.

Проверить секреты

Перед публикацией и деплоем.

Сделать Release

Зафиксировать стабильную версию.

Превратить идеи в Issues

Backlog без хаоса.

Сделать свой шаблон

Для повторных проектов.

GitHub Secrets: специальный сейф для ключей

Да, секреты в GitHub хранятся в специальном защищённом месте, а не в коде и не в .env внутри репозитория.

Для обычного репозитория путь: Repository → Settings → Secrets and variables → Actions → New repository secret.
REPOSITORY

Секрет репозитория

Доступен workflow этого конкретного репозитория. Самый понятный вариант для обычного проекта.

ENVIRONMENT

Секрет окружения

Например, отдельные секреты для production и staging. Доступ к ним можно дополнительно защищать правилами окружения и подтверждением деплоя.

ORGANIZATION

Секрет организации

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

Локальный .env и GitHub Secrets — это разные вещи

Локальный .env

Нужен приложению на твоём компьютере или сервере. Реальные значения лежат локально и исключаются через .gitignore.

GitHub Secrets

Нужны автоматизациям GitHub Actions. Workflow получает секрет через специальный механизм GitHub, а не читает его из файла в репозитории.

Не путай: GitHub Variables подходят для обычных настроек, которые не являются секретными. API-ключи, токены и пароли должны храниться как Secrets, а не Variables.

Что туда обычно кладут

Главное правило: workflow получает только те секреты, которые ему реально нужны. Если секрет не нужен автоматической проверке или деплою, не надо добавлять его в GitHub «на всякий случай».
ИИ настроит структуру, значение секрета вводишь безопасно.
Секреты в GitHub
Код хранится в GitHub, реальные ключи — нет. Для автоматизаций используются защищённые GitHub Secrets.

GitHub как машина времени

Если новая функция сломала проект, история позволяет увидеть изменения и безопасно вернуться к рабочей точке, не удаляя всю историю.

GitHub как машина времени проекта
Каждая контрольная точка сохраняется. Неудачное изменение не означает потерю проекта.

9. Что не надо делать

10. Когда GitHub для вайбкодера настроен правильно

Definition of Done GitHub-системы0/15
Финиш: ты больше не боишься потерять проект. GitHub хранит факты, а ИИ берёт на себя техническую рутину.
GitHub настроен правильно, когда проект переживает новый чат, ошибку и неудачное изменение — а ИИ всё равно может восстановить контекст и безопасно продолжить работу.
Метод Hardcoding PRO для нового GitHub-проекта
Ты описываешь идею, ИИ создаёт GitHub-основу, фиксирует историю и доводит проект до рабочего результата.

Что дальше

Теперь GitHub становится общей основой для всех следующих практик Hardcoding PRO.

Telegram-боты

Каждый бот создаётся из шаблона и дальше живёт в собственном GitHub-репозитории.

Mini Apps и сайты

Тот же процесс: repo → ветка → ИИ → tests → PR → main → deploy.

ИИ-агенты

GitHub хранит код, инструкции, tools и историю изменений агента.

Автоматизации

Сценарии, микросервисы и конфигурации не теряются и развиваются как нормальные проекты.

Hardcoding PRO и GitHub
GitHub + ИИ превращают идеи в проекты, которые можно продолжать, проверять и развивать.
Стартовый промптПрактика
HARD CODING PRO · ПРАКТИКА ПОСЛЕ ГАЙДА 03

Закрепил результат? Продолжай по карте

Эта практика закрепляет гайд 03 «Git и GitHub для вайбкодинга». Следующий шаг — гайд 04 «Как понять, что ИИ действительно закончил задачу».

← Гайд 03 Дальше: гайд 04 → 🗺 Вся карта