Работодатель открывает ваш репозиторий на 20 секунд, максимум на 30. Если за это время он не понял, что вы сделали и зачем, ссылка закрывается. Именно README решает, продолжит ли человек смотреть код или уйдет к следующему кандидату. Если вы уже успе…
10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.
Об авторе →Claude Code: новый CLI-агент от Anthropic
Anthropic выпустила Claude Code — терминальный AI-агент для разработчиков. Инструмент работает прямо в командной строке и умеет писать, редактировать и запускать код.
Zcode AI: Полный гид по визуальному интерфейсу для Claude Code и AI-агентов
Узнайте, как использовать Zcode для управления Claude Code, Gemini и Codex в едином GUI. Настройка провайдеров, MCP-серверов и визуальный вайбкодинг.
YouTube-канал с монетизацией из любой точки мира: Пошаговый гайд 2026
Инструкция по созданию YouTube-канала: обход блокировок SMS, настройка расширенных функций через виртуальные номера и правила безопасности для монетизации.
Windsurf Code Maps: Как глубоко понимать архитектуру проекта перед написанием кода
Полный гайд по Windsurf Code Maps, модели Sway 1.5 и Sway Grep. Узнайте, как визуализировать архитектуру кода и ускорить разработку в 13 раз.
Vk Fast Cash Strategy
Аудитория ВКонтакте — это те же люди, что и в Instagram, но 'социальный контракт' площадки другой. Если Instagram — это 'дорогой ресторан' с демонстрацией успеха, то VK — это 'душевная шашлычная'. Здесь не работает глянцевый 'успешный успех
Работодатель открывает ваш репозиторий на 20 секунд, максимум на 30. Если за это время он не понял, что вы сделали и зачем, ссылка закрывается. Именно README решает, продолжит ли человек смотреть код или уйдет к следующему кандидату. Если вы уже успели сделать проект с нейросетью бесплатно через Claude, Cursor или любой другой AI-инструмент, то заброшенный без оформления репозиторий обесценивает всю проделанную работу.
Дальше разберем, как упаковать pet project так, чтобы он реально работал на резюме: структура, README, скриншоты, бейджи и готовый промпт для нейросети.
Хороший README поднимает количество просмотров репозитория в 3-5 раз и превращает pet project в рабочий инструмент резюме. Ниже: готовая структура репозитория, промпт для Claude, который пишет README за 30 секунд, разбор бейджей и чек-лист перед отправкой ссылки работодателю.
Код без README читают только те, кто уже обязан это делать: ревьюер или сам автор. Работодатель смотрит профиль бегло и оценивает не архитектуру, а то, насколько понятно вы объяснили задачу.
Рекрутеры и тимлиды в 2026 году признаются прямо: они ищут сигнал, а не шум. Раздутый список из 47 технологий или анимированный счетчик визитов работает против кандидата, а не на него. Профиль без внятного описания читается как черновик, даже если внутри лежит рабочий продукт.
Тут есть нюанс, который часто упускают. GitHub стал фактическим резюме разработчика, но не потому что там код. Потому что там видно, как человек мыслит и объясняет. У ученика Юркевича MVP окупился за две недели без единого рубля на рекламу, и первый вопрос, который задавали новые пользователи, звучал одинаково: а что это вообще такое. README отвечает на этот вопрос за вас, пока вы спите.
Если вы делаете pet project ради портфолио, а не ради собственного удовольствия, оформление это не опция. Это 30% работы наравне с самим кодом.
README читают сверху вниз и бросают на первом непонятном абзаце. Значит, порядок блоков важнее их количества: сначала суть, потом доказательства, в конце технические детали.
Пять блоков закрывают 90% случаев: одна строка о том, что делает проект, GIF или скриншот с демо, список технологий без перегруза, инструкция запуска в три шага, ссылка на живую версию или видео. Всё остальное (лицензия, contributing, roadmap) переносите ниже или в отдельный файл в папке /docs.
Разберем по порядку, что реально работает.
Не пишите «pet project for learning React». Пишите, что продукт делает для человека: «бот, который напоминает про встречи голосовой командой» звучит понятнее, чем перечисление стека. Название и суть идут в первых двух строках файла, до любых бейджей.
Текст можно скроллить не читая, картинку скроллить нельзя, взгляд цепляется. Скриншот интерфейса или короткий GIF с работой продукта конвертирует больше внимания, чем абзац описания. Для хостинга изображений подойдет Imgur или сам GitHub (перетащить картинку прямо в редактор issue и скопировать ссылку).
Один сегмент, одна задача, один стек, который вы реально знаете. Списки из всего, что когда-либо трогали руками, читаются как неуверенность, а не экспертиза.
Claude или другая нейросеть пишет черновик README по описанию проекта почти мгновенно. Дальше остается подставить реальные скриншоты, ссылки и проверить факты, а не выдумывать текст с нуля.
Создание проектов с помощью нейросети давно перестало быть чем-то экзотическим, но многие останавливаются на коде и забывают, что упаковку можно доверить тому же инструменту. Ниже готовый промпт, который можно скопировать целиком в Claude, ChatGPT или любой другой чат.
Промпт для README:
Напиши README.md для GitHub-проекта на русском языке.
Проект: [опишите в 2-3 предложениях, что делает продукт]
Стек: [технологии через запятую]
Аудитория: [кто будет смотреть репозиторий: рекрутер, разработчик, пользователь]
Структура:
1. Название + одна строка сути (не более 15 слов)
2. Блок "Что делает" (3-4 пункта, конкретно, без воды)
3. Блок "Технологии" (только реально использованные)
4. Блок "Как запустить" (пронумерованные шаги, реальные команды)
5. Блок "Демо" (плейсхолдер для ссылки на скриншот/видео)
6. Блок "Автор" (одна строка + ссылка на профиль)
Не используй канцеляризмы, не пиши "данный проект", не используй фразы
"в современном мире" и подобные клише. Пиши как разработчик,
объясняющий коллеге, а не как маркетинговый текст.Правьте черновик руками: замените плейсхолдеры реальными командами запуска и не оставляйте фразы, которые нейросеть придумала сама, если они не соответствуют действительности. README с выдуманными цифрами вредит больше, чем его отсутствие.
Структура репозитория читается так же, как README: сверху вниз, за секунды. Плоская каша из файлов в корне создает впечатление проекта без архитектуры, даже если код внутри аккуратный.
Минимальный порядок, который ждет любой ревьюер: файл README.md в корне, папка /src с кодом, папка /docs для расширенной документации, файл .gitignore, файл LICENSE, если проект публичный. Дополнительные скриншоты и медиа удобно держать в отдельной папке /assets, чтобы они не засоряли корень репозитория.
| Файл или папка | Зачем нужен |
|---|---|
| README.md | Главная точка входа, обязателен |
| /src | Исходный код проекта |
| /docs | Расширенная документация, если README не вмещает всё |
| /assets | Скриншоты, GIF, иконки |
| .gitignore | Скрывает node_modules, .env и служебные файлы |
| LICENSE | Показывает, что вы понимаете юридическую сторону кода |
Если проект собирался через вайбкодинг и часть файлов сгенерирована автоматически, не поленитесь почистить репозиторий перед публикацией ссылки. Служебные файлы конфигурации IDE, черновики промптов и временные скрипты в корне репозитория выглядят неаккуратно.
Бейджи работают, только если ведут на живые данные: статус сборки, версию, лицензию. Декоративные шильдики без ссылок на что-либо читаются как заполнение пустоты, а не как сигнал качества.
Правило простое: максимум три бейджа в первой строке, и каждый должен указывать на что-то реальное. Через Shields.io можно сгенерировать бейдж лицензии, версии или статуса деплоя за минуту, вставив нужные параметры в конструктор на сайте сервиса.
Ошибка, которую совершают чаще всего: стек из четырех виджетов github-readme-stats занимает весь экран и превращает README в дашборд вместо истории о продукте. Один аккуратный блок статистики внизу файла работает лучше, чем плотная сетка из карточек в начале.
Максим: «Веб-версию GoBanana собрали за 3 часа после выхода новой модели, а суммарно на продукт ушло 6-8 часов. Он принес 12 миллионов рублей. Если бы репозиторий выглядел как черновик без единого скриншота, никто бы даже не поверил, что это работающий продукт».
Profile README (репозиторий с именем вашего username) это витрина всего аккаунта. README проекта объясняет один конкретный pet project. Путать их не стоит: витрина не заменяет техническое описание конкретного репозитория.
GitHub Profile README создается через специальный репозиторий, название которого точно совпадает с вашим username. Файл README.md в нем автоматически отображается вверху вашей страницы профиля, выше списка закрепленных репозиториев. Такой профиль это ваш «второй резюме», а README внутри конкретного проекта, куда ведет ссылка из профиля, это уже техническая витрина одного продукта.
Для профиля достаточно короткого блока: кто вы, чем занимаетесь сейчас (2-3 текущих направления), 3-5 закрепленных репозиториев с однострочным описанием и способ связи. Для отдельного проекта нужна инструкция запуска и демо. Смешивать эти два формата и пытаться впихнуть полную историю проекта в профиль или личную биографию в README библиотеки не стоит.
Большинство репозиториев теряют внимание работодателя по одной из пяти причин, и все они лечатся за один вечер правок, а не переписыванием кода.
| Ошибка | Что видит рекрутер | Как исправить |
|---|---|---|
| Нет README вообще | Непонятно, что это и зачем | Написать хотя бы 5 базовых блоков |
| Название вроде test-project-2 | Проект выглядит заброшенным | Переименовать репозиторий под суть продукта |
| Список из 40 технологий | Недоверие к экспертизе | Оставить 3-5 реально сильных |
| Нет скриншота или демо | Лень открывать и запускать код | Добавить GIF или ссылку на живую версию |
| README не обновлялся с 2024 года | Команда запуска устарела, доверие падает | Проверять актуальность раз в несколько месяцев |
Проверьте по пунктам перед тем, как вставлять ссылку на репозиторий в резюме или сопроводительное письмо:
Нужно ли делать отдельный README для GitHub-профиля и для каждого проекта?
Да, это разные форматы. Profile README это общая витрина аккаунта, README проекта объясняет конкретный репозиторий. Один не заменяет другой.
Можно ли написать README полностью нейросетью без правок?
Черновик можно, финальную версию нет. Нейросеть не знает реальных команд запуска и может придумать цифры или функции, которых нет в проекте. Проверяйте каждый факт вручную.
Сколько времени должно уходить на оформление одного pet project?
От 30 минут до полутора часов, если использовать промпт для нейросети и готовую структуру. Большую часть времени съедает не написание текста, а подготовка скриншотов.
Обязательно ли добавлять бейджи в README?
Нет. Бейджи полезны, только если ведут на реальные данные: статус сборки, версию, лицензию. Пустые декоративные бейджи можно смело пропустить.
Что делать, если pet project собран за пару часов через вайбкодинг и стыдно показывать код?
Скорость сборки не проблема, если продукт решает конкретную задачу. GoBanana собрали за 3 часа, и это не помешало проекту принести 12 миллионов рублей. Проблема не в скорости, а в отсутствии внятного объяснения, что именно вы сделали.
Нужна ли лицензия для pet project?
Если вы не планируете, чтобы код кто-то использовал коммерчески, подойдет MIT-лицензия по умолчанию. Наличие файла LICENSE само по себе сигнал, что вы понимаете базовые практики разработки.
Как быстро сделать проект с нейросетью бесплатно и потом оформить его для портфолио?
Собрать MVP можно за вечер в Claude Code или Cursor на бесплатном тарифе, а оформление README и структуры репозитория из этой статьи займет еще час. Итоговый pet project будет выглядеть как законченный продукт, а не черновик.
README — файл с описанием проекта, который GitHub автоматически показывает при открытии репозитория.
Pet project — учебный или демонстрационный проект, который делают вне работы, часто для портфолио.
Markdown — язык разметки текста с расширением .md, который GitHub превращает в форматированную страницу.
Badge (бейдж) — небольшой значок-картинка в README, который показывает статус: версию, лицензию, статус сборки.
Profile README — специальный репозиторий с именем вашего username, содержимое которого GitHub показывает наверху страницы профиля.
Вайбкодинг — создание цифровых продуктов через промпты в AI-инструментах без написания кода вручную.
Хотите разобраться, какой AI-инструмент выбрать для сборки и оформления pet project? Смотрите обзор Claude Code или весь каталог AI-инструментов на VibeCoderz. А если нужна разовая консультация по упаковке проекта под конкретную вакансию, пишите Максиму: telegram.me/maxnagovitsyn.
Источники: GitHub Docs, управление Profile README, GitHub Docs, About README files, Shields.io.
Обновлено: июль 2026