HARD CODING PRO · Вводный обзор и карта обучения

БАЗА Обзор курса / 20 · МАРШРУТ НОВИЧКА

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

Читать сейчас?Да. Это карта всего Level 1. Её не надо зубрить, её надо использовать как навигатор.

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

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

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

Выбери один реальный проект, который хочешь довести до работающего результата.
Запиши одним предложением, кому он помогает и какой результат даёт.
Переходи в Guide 04 и дальше иди по порядку. Все уроки читай, но внедряй только то, что реально нужно твоему проекту.

Урок закрыт, когда: У тебя выбран один реальный проект, ты понимаешь разницу между БАЗА / ПО НУЖДЕ / РОСТ / ПРОДВИНУТЫЙ и знаешь, что следующий шаг - Guide 04.

Простой пример: Например: «Telegram-бот принимает голосовое и возвращает краткий отчёт». Пока не надо решать, нужен ли ему RAG, Redis или автономный агент.

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

ТВОЯ ДОРОГА ПО LEVEL 1

Не надо строить всё сразу. Иди пятью этапами

Этап 1 · Фундамент · Guides 01-06
Проходишь и применяешь обязательно: результат, research, декомпозиция, архитектура, Git.

Этап 2 · Слои проекта · Guides 07-12
Все читаешь для общего понимания. Практику делаешь только там, где слой реально существует: база, API, auth, frontend, RAG, агент.

Этап 3 · Довести до реальной работы · Guides 13-16
Проходишь обязательно: логи, тесты, безопасность, публикация.

Этап 4 · Рост · Guides 17-19
Читаешь сейчас, чтобы понимать будущее. Внедряешь CI/CD, reliability и автономность только когда появились пользователи, нагрузка, регулярные релизы или реальные agent actions.

Этап 5 · Деньги и выпуск · Guide 19
Связываешь проект с реальным пользователем, экономикой и финальным LEVEL1_FINAL_REPORT.md.

Правило новичка: если урок «ПО НУЖДЕ» пока не относится к твоему проекту, ты всё равно читаешь его для кругозора, но не строишь ненужную систему ради галочки.

Главный диагноз

Тебе не нужно знать больше. Тебе нужно знать, где ты находишься

Уровень 1 уже покрывает Git, API, базы данных, RAG, безопасность, публикацию, тестирование, агентов, надёжность и деньги. Проблема возникает, когда эти знания воспринимаются как двадцать отдельных тем. Этот гайд превращает их в один маршрут.

Три вопроса владельца проекта:
1. Где я сейчас?
2. Что является следующим правильным шагом?
3. Какое доказательство докажет, что этап завершён?

Правило: не читай все 20 гайдов подряд только потому, что они существуют. БАЗА проходит каждый. ПО НУЖДЕ открывается, когда этот слой реально есть в твоём проекте. РОСТ и ПРОДВИНУТЫЙ УРОВЕНЬ появляются после рабочего MVP, когда сложность оправдана пользователями, риском или деньгами.

Результат и критерии готовности проекта — Сначала фиксируем результат и критерии готовности, потом разрешаем ИИ строить.

Маршрут

Новая карта: обзор + 19 гайдов в правильном порядке

БАЗА - пройти всемПО НУЖДЕ - по типу проектаРОСТ / ПРОДВИНУТЫЙ УРОВЕНЬ - когда появилась причина

00

НАЧНИ ЗДЕСЬ · ОБЗОР

Вайбкодинг от А до Я: от идеи до работающего ИИ-продукта

Карта Уровень 1. Открой в начале обучения, возвращайся после каждого этапа и пройди ещё раз перед финальной приёмкой.

01

ПО НУЖДЕ

ИИ-агенты для новичков

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

02

БАЗА

Не изобретай велосипед: сначала исследование

Исследование. До выбора стека и до написания значимого объёма кода.

03

БАЗА

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

Главное место хранения по коду. До серьёзных изменений в реальном проекте и до работы нескольких AI/людей.

04

БАЗА

Как понять, что ИИ действительно закончил задачу

Результат и приёмка. Перед первой серьёзной задачей и каждый раз перед закрытием работы ИИ-кодера.

05

БАЗА

Декомпозиция ИИ-проекта

Планирование. Когда идея уже понятна, но работа ещё выглядит одной большой глыбой.

06

БАЗА

Архитектура ИИ-проекта и карта данных

Архитектура. До активной разработки и при любом существенном изменении системы.

07

БАЗА / ПО НУЖДЕ

API и интеграции для новичков

Интеграции. Когда проект должен общаться с Telegram, ИИ, CRM, оплатой, Google или другим сервисом.

08

ПО НУЖДЕ

Интерфейс и удобство для пользователя

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

09

ПО НУЖДЕ

Базы данных для новичков

Данные. Если проект хранит пользователей, заявки, состояния, результаты или другие структурированные данные.

10

ПО НУЖДЕ

Пользователи, авторизация и права доступа

Пользователи и доступ. Если у продукта есть аккаунты, роли, личные данные или разные уровни доступа.

11

ПО НУЖДЕ

Память, контекст и RAG

Память и знания. Если AI должен помнить контекст между сессиями или отвечать по большой базе документов.

12

БАЗА

Логи, мониторинг и поиск ошибок

Диагностика. Как только проект начал делать что-то реальное и особенно когда что-то сломалось.

13

БАЗА

Тестирование проекта

Проверка. После каждого существенного изменения и перед выпуском новой версии.

14

БАЗА

Безопасность ИИ-проекта

Безопасность. До публикации рабочей версии и перед расширением прав ИИ-агента.

15

БАЗА

Публикация проекта и VPS

Рабочий запуск. Когда проект должен работать без твоего ноутбука и быть доступен реальному пользователю.

16

РОСТ

автопроверки и автоматический выпуск (CI/CD) и автоматические релизы

Регулярные обновления. Когда проект уже развивается и ручная публикация становится риском или рутиной.

17

РОСТ

Надёжный ИИ-сервис

Надёжность. Если есть долгие или платные фоновые операции, повторные попытки после сбоев, высокая нагрузка или риск дублей.

18

ПРОДВИНУТЫЙ УРОВЕНЬ

Автономные ИИ-агенты

Контролируемая автономность. Когда агент получил инструменты и сам выполняет многошаговую работу с реальными последствиями.

19

БАЗА

От ИИ-проекта к деньгам

Пользователи и деньги. Когда есть рабочий результат и нужно доказать спрос, экономику и способ продаж.

Сначала исследование готовых решений и рисков — Сильный вайбкодинг начинается с исследования готовых решений и проверки рисков.

Как устроена система

Минимальная компьютерная модель вайбкодера

ПОЛЬЗОВАТЕЛЬ → ИНТЕРФЕЙС → API / ДОГОВОРЁННОСТЬ О ДАННЫХ → СЕРВЕРНАЯ ЛОГИКА → БАЗА / ИИ / СЕРВИСЫ → ПРОЦЕСС → СЛУЖБА → ПОРТ → СЕРВЕР → ДОМЕН → ПОЛЬЗОВАТЕЛЬ

Внутри проекта постоянно встречаются более мелкие сущности:

ФАЙЛ → ПАПКА → ПУТЬ → РАБОЧАЯ ПАПКА → ПРОЦЕСС → СРЕДА ЗАПУСКА → ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ → СЛУЖБА

Тебе не нужно администрировать всё вручную. Но ты должен понимать эти слова настолько, чтобы спросить AI: «какой процесс сейчас запущен?», «из какой рабочей папки он запускается?», «на каком порту он принимает запросы?», «откуда он получает переменные окружения?».

Архитектура и карта системы ИИ-проекта — Архитектура показывает, как пользователь, интерфейс, ИИ, сервер и данные связаны в одну систему.

Главное место хранения

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

Что	Главный источник истины	Не путать
Код	Git / GitHub	Не папка на VPS как единственная версия
Требования	требования / критерии готовности / задача	Не случайный старый чат
Секреты	хранилище секретов / переменные окружения в рабочей среде	Не Git и не README
Данные	База данных	Не память модели
Файлы	Хранилище файлов	Не временный контейнер
Среда запуска	VPS / облачная среда	Не GitHub
Ошибки	Логи / Sentry / телеметрия	Не догадка AI
Решения	Документация / контрольная точка / журнал решений	Не «мы вроде обсуждали»
История работы ИИ над проектом	Git + контрольные точки / история изменений	Не один длинный контекст

Закон: один тип истины - одно главное место. Копии допустимы. Неясность, какая копия главная, недопустима.

Git и история проекта — Git хранит историю проекта и даёт безопасный путь назад.

От идеи до рабочего продукта

Один канонический рабочий маршрут

Этап	Человек	AI	Артефакт	Гайд
0. Карта Пойми маршрут и выбери один реальный проект.	Цель, ограничения, приоритет.	Собрать карту и критерии готовности.	`LEVEL1_PROJECT_MAP.md`	01
1. Результат Определи ценность и что означает готово.	Принять критерии и границы MVP.	Сформулировать критерии приёмки и критерии готовности.	`PROJECT_BRIEF.md`	02
2. Исследование Проверь готовые решения и главный риск.	Выбрать, что имеет смысл строить.	Найти источники, сравнить варианты и сделать маленькую проверку идеи (проверочный прототип (PoC), proof of concept, проверка принципиальной возможности).	`RESEARCH.md + DECISIONS.md`	03
3. Декомпозиция Разбей работу на маленькие проверяемые этапы.	Держать цель и приоритет.	Вести модули и один следующий шаг.	`MODULE_CARD.md`	04
4. Архитектура Зафиксируй компоненты, данные и главное место хранения.	Проверять смысл и простоту.	Строить карты и договорённости о данных.	`ARCHITECTURE.md + DATA_MAP.md`	05
5. История версий через Git Сделай код управляемым и обратимым.	Принимать список изменений и знать последнюю проверенную рабочую версию.	Работать через Git и небольшие сохранённые версии (коммиты).	`Git-репозиторий + README`	06
6. Собираем нужные части Подключай только нужные слои: база данных, API, доступы, интерфейс, RAG, агент.	Не давать объём задачи расползаться.	Собрать один сквозной рабочий сценарий.	`Рабочий MVP`	07-12
7. Поиск ошибки Не чинить наугад. Найти первопричину.	Не разрешать хаотичные правки.	Воспроизведение, логи, гипотезы, точечное исправление.	`DEBUG_REPORT.md`	13
8. Проверяем результат Доказать результат.	Принимать только доказанный результат.	Быстрая проверка, сквозной сценарий, повторная проверка старых функций, сценарий ошибки.	`TEST_PLAN.md`	14
9. Проверяем безопасность Ограничить секреты, права и радиус возможного ущерба.	Определить неприемлемый риск.	Сначала аудит без изменений, затем исправления.	`SECURITY_AUDIT.md`	15
10. Рабочая версия Запустить сервис 24/7.	Подтвердить выпускаемую версию.	Публикация, перезапуск, логи и сквозная проверка.	`DEPLOY.md + RUNBOOK.md`	16
11. Усложняем только при необходимости Добавить автопроверки и автоматический выпуск (CI/CD), повышенную надёжность и автономность только по необходимости.	Оправдать новую сложность.	Добавлять автопроверки, очередь задач и управляющую оболочку только по необходимости.	`Результаты этапа роста`	17-19
12. Проверяем деньги и спрос Доказать спрос, экономику и продажи.	Работать с реальными людьми и деньгами.	Считать экономику одной операции или клиента и понимать источник денег.	`OFFER.md + COSTS.md`	20
13. Передача проекта Передать проект без устного пересказа.	Проверить владельцев системы и доступы.	Собрать полный пакет передачи проекта.	`HANDOFF.md`	Экзамен

MVP, API и данные в рабочем продукте — MVP соединяет данные, API и интеграции в первый реально работающий сценарий.

сначала договорённость о данных

Между частями проекта сначала существует договор

СЕРВИС А → { JSON-ДОГОВОРЁННОСТЬ } → СЕРВИС Б

До реализации интеграции зафиксируй: вход, выход, обязательные поля, проверку данных, ошибки, время ожидания, защиту от дублей и версию. Тогда интерфейс, серверная логика и внешние сервисы не обязаны знать внутренности друг друга. Они обязаны соблюдать одну договорённость о данных.

Договорённость API - это как накладная между двумя отделами. Один отдел не обязан знать, как другой выполняет работу. Но оба должны одинаково понимать, что передаётся и что возвращается.

Поиск ошибок

Когда сломалось, не разрешай AI устраивать лотерею

ВОСПРОИЗВЕСТИ → ЧТО ЖДАЛИ / ЧТО ПОЛУЧИЛИ → НАЙТИ ГРАНИЦУ ПРОБЛЕМЫ → ЛОГИ → 3 ГИПОТЕЗЫ → ПРОВЕРИТЬ ОДНУ → МИНИМАЛЬНО ИСПРАВИТЬ → ПОВТОРИТЬ ТЕСТ → ПРОВЕРИТЬ СТАРОЕ → ДОКАЗАТЕЛЬСТВО

Закон: если причина неизвестна, AI не должен одновременно менять пять независимых вещей.

Диагностика и тесты проекта — Диагностика и тесты превращают «кажется работает» в проверенный результат.

Передача проекта

Финальный пакет передачи проекта

Продукт
README
требования / критерии готовности
ARCHITECTURE
DATA_MAP
API_CONTRACT

Рабочая версия
GitHub
Сервер
Домен
База данных
Публикация
Мониторинг

Владение
Карта секретов без значений
Резервная копия / восстановление
Расходы
Владельцы и ответственность
Инструкция при сбое
Условия поддержки

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

Безопасность и публикация рабочей версии — Безопасность, права и секреты должны быть проверены до публикации рабочей версии.

Работа через ИИ

8 мастер-промптов на весь Уровень 1

Не запускай все восемь одновременно. Выбирай под текущую фазу.

1. Исследование

Ты мой ИИ-исследователь. Не начинай писать код. Восстанови цель, пользователя, ограничения и критерии готовности. Найди существующие продукты, репозитории, библиотеки и официальные способы решить задачу. Для важных вариантов покажи источник, актуальную версию, ограничения, стоимость, риски и что нужно проверить на практике. Выдели один риск, который способен разрушить план, и предложи минимальную проверку идеи (проверочный прототип (PoC)). В финале дай короткий список и один следующий шаг.

2. Архитектура

Ты ИИ-архитектор моего реального проекта. Сначала изучи фактическое состояние и существующие компоненты. Построй минимальную архитектуру под текущий MVP. Покажи путь одного пользовательского запроса от входа до результата, главное место хранения для каждого типа данных, договорённости о данных между компонентами, секреты, поведение при сбоях и что сознательно не добавляем сейчас. Обнови ARCHITECTURE.md, DATA_MAP.md и SYSTEM_MAP.md.

3. Подготовка проекта

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

4. Реализация

Реализуй только текущий согласованный шаг. Восстанови контекст из файлов проекта и Git. Делай минимальные проверяемые изменения. Не расширяй объём задачи. После изменения запусти относящиеся проверки, обнови документацию и покажи список изменений, доказательство и то, что осталось непроверенным.

5. Поиск ошибки

Не чини наугад. Сначала воспроизведи проблему. Зафиксируй ожидаемый результат и фактический результат. Найди границу работающего поведения, прочитай релевантные логи и сформулируй максимум три гипотезы. Проверяй по одной. После подтверждения первопричины сделай точечное исправление, повтори исходный сценарий и повторную проверку старых функций.

6. Приёмка

Проведи независимую приёмку. Не доверяй сообщению «готово». Сверь каждый критерий приёмки с доказательством. Запусти быструю проверку, главный сквозной сценарий, нужную повторную проверку старых функций и минимум один сценарий ошибки. Для каждого пункта верни ПРОШЛО, НЕ ПРОШЛО или НЕ ПРОВЕРЕНО.

7. Проверка рабочей версии

Проведи аудит текущей рабочей версии. Определи точную запущенную версию Git, состояние сервиса, публичную ссылку, проверку состояния, быструю проверку, главный сквозной сценарий, последние безопасные логи, ресурсы VPS, резервную копию и путь отката. HTTP 200 сам по себе не считай доказательством правильного содержимого. Не выполняй разрушительных действий без подтверждения.

8. Передача проекта

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

Словарь выживания

50 терминов, которые достаточно понимать, а не зубрить

Термин	По-человечески
Файл (File)	Файл с кодом, настройками или данными.
Папка (Folder)	Папка проекта.
Путь (Path)	Точный адрес файла или папки.
Рабочая папка (Working directory)	Папка, относительно которой выполняется команда.
Процесс (process)	Запущенная программа.
Служба (service)	Управляемый процесс с автозапуском и статусом.
Порт (port)	Сетевой вход конкретного сервиса.
Среда запуска	Среда, в которой выполняется код.
Переменная окружения (Environment variable)	Настройка, переданная процессу извне.
Зависимость (Dependency)	Пакет или сервис, от которого зависит проект.
Локальный адрес компьютера (localhost)	Этот же компьютер с точки зрения программы.
IP	Сетевой адрес машины.
Домен (Domain)	Имя, которое ведёт на сервис.
Репозиторий (Repository)	Проект под контролем Git.
Сохранённая версия (Commit)	Точка истории.
Ветка изменений (Branch)	Отдельная линия изменений.
Список изменений (Diff)	Точная разница между версиями.
Главное место хранения	Главное место истины для конкретного типа данных.
API	Способ программного общения систем.
Договорённость о данных (Contract)	Правила входных данных, результата и ошибок.
Адрес функции API (Endpoint)	Адрес конкретной функции API.
JSON	Текстовый формат структурированных данных.
База данных	Структурированное хранилище данных.
Интерфейс (Frontend)	То, что видит пользователь.
Серверная логика (Backend)	Скрытая логика и проверки.
Публикация	Доставка версии в рабочую среду.
Рабочая версия	Версия для реальных пользователей.
Лог, журнал событий (Log)	Фактическая запись о событии.
Телеметрия, данные о работе системы (Telemetry)	Метрики времени, ошибок, нагрузки и стоимости.
Поиск ошибок	Поиск и доказательство причины проблемы.
Быстрая проверка	Быстрая проверка основы.
Сквозная проверка (E2E)	Полный путь пользователя.
Повторная проверка старых функций	Проверка, что новое не сломало старое.
Откат (Rollback)	Возврат к рабочей версии.
Резервная копия (Backup)	Копия данных для восстановления.
Секрет, ключ доступа (Secret)	Ключ, токен или пароль.
RAG	Поиск релевантных знаний перед ответом.
ИИ-агент (Agent)	AI с целью и возможностью действовать.
Инструмент агента (Tool)	Реальная возможность агента.
MCP	Стандарт доступа ИИ к инструментам и ресурсам.
Управляющая оболочка агента (Harness)	Управляющая оболочка агента.
Контрольная точка (Checkpoint)	Контрольная точка состояния.
Доказательство	Фактическое доказательство результата.
Защита от повторного эффекта (Idempotency)	Защита от двойного эффекта.
Очередь задач (Queue)	Очередь фоновых задач.
Исполнитель фоновых задач (Worker)	Исполнитель задач.
Повторная попытка (Retry)	Контролируемый повтор.
Резервный путь (Fallback)	Резервный путь.
автопроверки и автоматический выпуск (CI/CD)	Автопроверка и доставка изменений.
Передача проекта	Передача проекта другому человеку или AI.

Финальный экзамен

Уровень 1 пройден не после 20 прочитанных гайдов

Экзамен - один реальный проект. Не тест и не пересказ терминов.

Объяснить проблему пользователя и измеримый результат.
Показать требования / критерии готовности.
Показать исследование и выбор архитектуры.
Показать репозиторий Git и последняя проверенная рабочая версия.
Показать работающий MVP.
Подключить хотя бы один внешний API или инструмент, если он нужен.
Показать безопасное хранение секреты.
Запустить локально или на VPS.
Найти реальную ошибку через логи.
Исправить её через цикл поиска ошибки.
Показать проверки.
Сделать рабочая версия публикация.
Доказать рабочую версию реальным сквозным сценарием, а не только HTTP 200.
Показать резервную копию и план отката.
Посчитать себестоимость.
Показать реального пользователя, пилот или измеримый первый результат.
Собрать пакет передачи проекта.
Передать проект другому человеку/AI и доказать, что он способен продолжить.

Главный критерий: ты один раз прошёл весь путь с AI и можешь повторить его на следующем проекте.

Пользователи и деньги, финальный этап проекта — Финал маршрута: реальные пользователи, ценность, продажи, деньги и следующий цикл роста.

Финальная самопроверка

36 пунктов владельца ИИ-проекта

Выполнено 0 из 36 критериев.

Финал

Твоя новая роль

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

ЦЕЛЬ → ИИ → РЕЗУЛЬТАТ ЭТАПА → ДОКАЗАТЕЛЬСТВО → ПОЛЬЗОВАТЕЛЬ → ДЕНЬГИ → СЛЕДУЮЩЕЕ УЛУЧШЕНИЕ

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