Начни отсюда: два готовых промпта
Выбери свою ситуацию. Скопируй промпт в Codex / Claude Code и отвечай только на 5 вопросов. GitHub-рутину агент делает сам.
Создать GitHub-проект с нуля
Для новой идеи, бота, сайта, агента, автоматизации или любого другого проекта.
Шаблон: PavelDumbrao/hardcoding-github-vibecoder-starter
Перевести существующий проект в GitHub
Для папки на Mac, проекта на VPS, архива или старого репозитория, в котором уже что-то работает.
Главная мысль
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 для проекта, который помнит не только файлы, но и каждое изменение.
Хранилище проекта
Код, файлы, инструкции, тесты и документация лежат в одном месте.
История
Видно, что менялось и когда. Можно сравнить версии и вернуться назад.
Рабочая среда для ИИ
Агент читает фактический проект, а не пытается вспомнить его по старому чату.
2. Зачем GitHub именно вайбкодеру
- не потерять проект, даже если сменился компьютер или чат;
- дать Codex / Claude Code точный актуальный контекст;
- видеть, что именно поменял ИИ;
- не ломать рабочую версию новыми экспериментами;
- откатиться, если изменение оказалось плохим;
- автоматически запускать тесты;
- передать проект другому агенту или человеку;
- иметь понятное портфолио реальных проектов;
- строить деплой и обновления вокруг одного источника правды.
3. Семь слов GitHub, которые нужно понять один раз
Проект целиком: файлы + история + настройки.
Контрольная точка. ИИ закончил понятный кусок работы и зафиксировал состояние.
Безопасная отдельная линия для эксперимента. Рабочий
main не ломается.Предложение добавить изменения из ветки в рабочую версию. Здесь видно, что именно меняется и какие проверки прошли.
Главная рабочая ветка. Здесь должна находиться подтверждённая стабильная версия проекта.
Автоматические проверки: тесты, сборка, безопасность, иногда деплой.
Зафиксированный выпуск продукта: например v1.0, v1.1 или v2.0.
GitHub CLI (`gh`): развязываем ИИ руки
GitHub в браузере нужен тебе. GitHub CLI нужен твоему ИИ-агенту.
gh, он может сам выполнять почти всю GitHub-рутину: создавать репозитории, Pull Request, Issues, Releases, смотреть Actions, checks и безопасно настраивать Secrets.На твоём Mac
ИИ проверяет, установлен ли gh. Если нет, сам устанавливает официальный GitHub CLI подходящим способом. На Mac нормальный путь обычно через Homebrew, если он уже используется.
Тебе остаётся только один раз подтвердить вход в свой GitHub через безопасный браузерный flow.
На сервере
ИИ определяет 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. Команды, которые показывают сам токен, в обычной работе не нужны.gh. Это полезное усиление, но не обязательное условие Hardcoding PRO.GitHub Actions: твой автоматический технарь внутри GitHub
Ты отправил изменения в GitHub, а дальше GitHub сам может проверить проект, собрать его и даже развернуть на сервере.
Что такое Actions простыми словами
Это автоматические сценарии внутри GitHub. Они запускаются сами, когда происходит нужное событие: например, создан Pull Request, отправлен новый commit, изменения попали в main или ты нажал кнопку ручного запуска.
Где это находится
В репозитории есть вкладка Actions. Там видно каждый автоматический запуск: что выполнялось, какие шаги прошли и где возникла ошибка.
Что Actions может делать за тебя
- запускать тесты при каждом Pull Request;
- проверять стиль и качество кода;
- собирать приложение;
- проверять, что проект вообще запускается;
- создавать готовые файлы и артефакты;
- проводить проверки безопасности;
- автоматически выкатывать проверенную версию на VPS или облако;
- запускаться по расписанию;
- запускаться вручную кнопкой;
- останавливать плохое изменение до попадания в рабочую версию.
.github/workflows/ говорит GitHub: «когда произошло X, сделай Y и проверь Z». Писать этот файл руками тебе не нужно, его создаёт ИИ.Событие
Например: создан Pull Request или изменения отправлены в main.
Job
Отдельная автоматическая работа, например «проверить проект» или «развернуть на сервере».
Steps
Конкретные шаги внутри работы: скачать код, поставить зависимости, запустить тесты, собрать продукт.
4. Три способа начать проект
Новый репозиторий
Когда есть только идея. ИИ создаёт структуру, README, PROJECT, TASKS и первый commit.
Template Repository
Берём проверенный шаблон и создаём новый независимый проект с готовой структурой. Именно так работают наши Hardcoding PRO starters.
Подключить существующий проект
ИИ сначала изучает фактические файлы и секреты, потом аккуратно делает GitHub источником правды.
5. Безопасный workflow, который ИИ должен делать сам
main не трогаем напрямую для заметных изменений.
Почему это безопасно
Если эксперимент плохой, main остаётся рабочим. Изменения можно посмотреть до объединения.
Почему это удобно с ИИ
Агент сам ведёт технический процесс, а ты получаешь ссылку на PR и понятный результат.
Pull Request Template: ИИ всегда объясняет изменения одинаково
Pull Request не должен выглядеть как «что-то поменял, вроде работает». Шаблон заставляет ИИ каждый раз показать результат по одной понятной структуре.
.github/pull_request_template.md. Когда создаётся новый Pull Request, GitHub подставляет содержимое шаблона в описание PR.Что должно быть в каждом PR
- что изменено;
- зачем это нужно;
- как проверено;
- какие есть риски;
- не попали ли секреты;
- обновлена ли документация;
- прошли ли GitHub Actions;
- готово ли изменение к merge.
Почему это особенно важно с ИИ
ИИ может делать много изменений очень быстро. PR Template заставляет его остановиться и сформулировать факты: что он реально сделал, что проверил и почему изменение безопасно объединять.
Если проект потом возьмёт другой ИИ или человек, история Pull Request становится понятной документацией проекта.
Шаблон Hardcoding PRO
Практика: шесть результатов подряд
Практика 1. Создай свой GitHub-проект
Используй первый стартовый промпт. Ответь на 5 вопросов. ИИ должен создать твою копию шаблона, заполнить PROJECT.md и провести первую задачу до main.
Что сказать ИИ
- Собственный GitHub-репозиторий создан из шаблона.
- PROJECT.md заполнен под реальный проект.
- TASKS.md содержит текущую и следующую задачу.
- Первая задача прошла через отдельную ветку и Pull Request.
- GitHub Actions зелёные.
- Результат находится в main.
- ИИ дал ссылку на репозиторий и итоговый commit.
Практика 2. Добавь одну функцию через Pull Request
Возьми промпт «Добавить функцию безопасно» ниже. Выбери маленькое улучшение и заставь ИИ провести его через отдельную ветку.
Что сказать ИИ
- Создана отдельная feature-ветка.
- Функция реализована и проверена.
- Создан Pull Request с понятным описанием.
- GitHub Actions зелёные.
- Pull Request объединён в main.
- ИИ дал ссылку на PR и итоговый commit.
Практика 3. Научись возвращаться назад
На тестовом или безопасном изменении используй промпт отката. Главная цель не сломать проект, а понять, что GitHub хранит путь назад.
Что сказать ИИ
- ИИ нашёл рабочую контрольную точку.
- Откат сделан без удаления истории и без force push в main.
- Создан Pull Request на возврат рабочего состояния.
- Проверки прошли.
- Main снова содержит ожидаемую рабочую версию.
- ИИ дал ссылку на PR и commit отката.
Практика 4. Открой новый чат и ничего не объясняй
Создай новый чат с ИИ. Дай только ссылку на GitHub и промпт восстановления контекста.
Что сказать ИИ
- Новый ИИ-чат сам понял, что это за проект.
- Он назвал текущую рабочую версию и commit в main.
- Он перечислил открытые задачи из TASKS.md.
- Он увидел Pull Requests и GitHub Actions.
- Он предложил логичный следующий шаг.
- Ты не пересказывал ему прошлый чат.
Практика 5. Настрой GitHub Actions
Теперь GitHub будет сам проверять изменения до попадания в рабочую версию.
Что сказать ИИ
- В репозитории появился workflow внутри .github/workflows/.
- Он запускается автоматически на Pull Request.
- GitHub Actions выполнил реальные проверки проекта.
- Первый красный запуск, если он был, ИИ сам диагностировал и исправил.
- Есть ссылка на зелёный Actions run.
- Изменения объединены в main только после успешных проверок.
Практика 6. Подключи секрет безопасно
На этой практике ты увидишь разницу между секретом в чате, локальным .env и специальным хранилищем GitHub Secrets.
Что сказать ИИ
- Определено, действительно ли секрет нужен workflow.
- Реальное значение не появилось в чате или Git.
- Секрет хранится в GitHub Secrets на правильном уровне.
- Workflow использует secret без вывода его значения.
- GitHub Actions зелёный.
- ИИ подтвердил, что secret отсутствует в diff и Git-истории.
- Создан собственный GitHub-репозиторий и первая задача дошла до main.
- Одна функция прошла через отдельную ветку и Pull Request.
- Ты безопасно вернулся к рабочей версии без уничтожения истории.
- Новый ИИ-чат восстановил проект только по ссылке GitHub.
- GitHub Actions реально проверяет Pull Request и показывает зелёный run.
- Секрет подключён через GitHub Secrets и не попал в чат, diff или историю Git.
7. Готовые промпты для работы через GitHub
Копируй нужный блок. Техническую работу делает агент.
Добавить функцию безопасно
Исправить баг
Проверить Pull Request
Безопасно откатиться
Продолжить в новом чате
Проверить секреты
Сделать Release
Превратить идеи в Issues
Сделать свой шаблон
GitHub Secrets: специальный сейф для ключей
Да, секреты в GitHub хранятся в специальном защищённом месте, а не в коде и не в .env внутри репозитория.
Секрет репозитория
Доступен workflow этого конкретного репозитория. Самый понятный вариант для обычного проекта.
Секрет окружения
Например, отдельные секреты для production и staging. Доступ к ним можно дополнительно защищать правилами окружения и подтверждением деплоя.
Секрет организации
Один секрет можно безопасно дать нескольким выбранным репозиториям организации.
Локальный .env и GitHub Secrets — это разные вещи
Локальный .env
Нужен приложению на твоём компьютере или сервере. Реальные значения лежат локально и исключаются через .gitignore.
GitHub Secrets
Нужны автоматизациям GitHub Actions. Workflow получает секрет через специальный механизм GitHub, а не читает его из файла в репозитории.
Что туда обычно кладут
- BOT_TOKEN Telegram-бота;
- API_KEY ИИ-провайдера;
- ключи платёжных систем;
- пароли и токены деплоя;
- ключ доступа к облаку или VPS, если выбран именно такой способ деплоя;
- DATABASE_URL с паролем, если workflow действительно должен его использовать.
GitHub как машина времени
Если новая функция сломала проект, история позволяет увидеть изменения и безопасно вернуться к рабочей точке, не удаляя всю историю.
9. Что не надо делать
- хранить один проект одновременно в пяти разных папках и считать каждую рабочей версией;
- просить ИИ менять большой проект прямо в main без проверки;
- делать commit с секретами;
- использовать force push в рабочий main просто потому, что «так быстрее»;
- создавать новый репозиторий каждый раз, когда агент потерял контекст;
- мерджить красные GitHub Actions;
- делать огромный Pull Request из десяти несвязанных задач;
- считать локальный файл источником правды, если проект уже ведётся через GitHub.
10. Когда GitHub для вайбкодера настроен правильно
- у проекта один понятный GitHub-репозиторий;
- README объясняет, что это за проект;
- PROJECT.md хранит цель и ключевые ограничения;
- TASKS.md показывает, что делаем сейчас и дальше;
- AGENTS.md объясняет ИИ правила работы;
- секреты не находятся в репозитории;
- заметные изменения идут через отдельную ветку;
- есть Pull Request и автоматические проверки;
- main является рабочей версией;
- можно безопасно найти прошлую рабочую точку;
- новый ИИ-чат восстанавливает контекст по одной ссылке GitHub;
- готовую версию при необходимости можно оформить Release.
- На каждой машине, где ИИ работает с GitHub, установлен и проверен GitHub CLI gh;
- ИИ умеет через gh создавать PR, смотреть Actions и работать с репозиториями без ручных кликов пользователя;
- В main лежит .github/pull_request_template.md, а ИИ использует его для заметных изменений.
Что дальше
Теперь GitHub становится общей основой для всех следующих практик Hardcoding PRO.
Telegram-боты
Каждый бот создаётся из шаблона и дальше живёт в собственном GitHub-репозитории.
Mini Apps и сайты
Тот же процесс: repo → ветка → ИИ → tests → PR → main → deploy.
ИИ-агенты
GitHub хранит код, инструкции, tools и историю изменений агента.
Автоматизации
Сценарии, микросервисы и конфигурации не теряются и развиваются как нормальные проекты.