Универсальный подход к вайбкодингу

Полное руководство: от идеи до деплоя

Яков Васильев
Strategy Director | AI and Communication Expert
Пишу про этику AI: t.me/nfg_ai
Учился AI: ai-lab.tech
Стек: Cursor • v0 • Gemini • Claude • GPT • Kiro • Wisprflow • GitHub
1. Генерация идеи2. PRD3. Архитектура4. Код5. Дебаг6. Деплой
1. Генерация идеиrole: Product Strategist
Goal
Сформулировать ценность для пользователя и проверить уникальность
Inputs
  • Проблема или потребность
  • Контекст рынка (опционально)
Activities
  1. Сгенерировать 5+ вариантов идей
  2. Deep research — узнать что уже существует
  3. Отсеять до 1-3 идей финалистов
Outputs
  • Короткое описание идеи (1-2 предложения)
  • Таблица: идея / целевой пользователь / ключевая ценность / риски
Tools
LLM с deep research • Parallel AI
Done when
Можешь объяснить идею за 30 секунд и назвать 1 причину почему это нужно
Antipatterns ✗
  • Влюбиться в первую идею
  • Пропустить проверку аналогов
  • Слишком широкий скоуп
Prompt
Я хочу создать [тип продукта] для [аудитория]. Сгенерируй 5 вариантов с разным фокусом. Для каждого укажи: core value, главный риск, сложность реализации (1-5).
2. PRDrole: Product Manager
Goal
Зафиксировать ЧТО делаем и ЗАЧЕМ, не КАК
Inputs
  • Выбранная идея из этапа 1
Activities
  1. Описать Purpose — кому и какую ценность
  2. Определить Users & Scenarios (3-5 сценариев)
  3. Задать KPIs — как измерим успех
  4. Зафиксировать Constraints (стек, бюджет, время, лицензии)
  5. Описать Rollout plan
  6. Перечислить риски
Outputs
  • PRD документ (1-2 страницы)
  • Таблица KPIs с метриками
Tools
ChatPRD • LLM
Done when
Другой человек (или LLM) может понять что строим без дополнительных вопросов
Antipatterns ✗
  • Писать КАК вместо ЧТО
  • Перфекционизм — PRD это живой документ
  • Игнорировать constraints
Prompt
Вот идея: [описание]. Создай PRD со следующей структурой: Purpose, Target Users (персоны), User Scenarios (3-5), Success Metrics, Constraints, Risks. Формат: markdown, максимум 2 страницы.
3. Архитектураrole: Software Architect
Goal
Определить КАК будет работать продукт технически
Inputs
  • PRD из этапа 2
Activities
  1. Преобразовать PRD в минимальную архитектуру
  2. Выбрать стек (или подтвердить constraint из PRD)
  3. Определить структуру файлов/модулей
  4. Описать data model
  5. Зафиксировать API/Events/Auth/Errors/Limits
Outputs
  • Структура проекта (дерево папок/файлов)
  • contracts.md — API endpoints или события
  • schema.sql / data_model.md — модель данных
  • tech_decisions.md — почему выбран стек
Tools
Context7 MCP • Sequential Thinking MCP • LLM + IDE
Done when
Структура файлов создана, можно начинать писать код без архитектурных вопросов
Antipatterns ✗
  • Over-engineering для MVP
  • Копировать архитектуру без понимания
  • Игнорировать constraints из PRD
Prompt
Вот PRD: [вставить]. Предложи минимальную архитектуру. Нужно: 1) Структура папок, 2) Описание каждого файла (1 строка), 3) Data model, 4) Список API endpoints. Стек: [constraint из PRD].
4. Кодrole: Developer
Goal
Реализовать минимальный функционал по архитектуре
Inputs
  • Архитектура из этапа 3
  • PRD для контекста
Activities
  1. Добавить в контекст: PRD + план + структуру
  2. Закрыть тесты относящиеся к задаче
  3. Писать код — модуль за модулем
  4. После каждого модуля — проверка и коммит
  5. После каждого чанка: проверка, тест, коммит
  6. Только потом следующий чанк
Outputs
  • Работающий код
  • Базовые тесты
  • README с инструкцией запуска
Tools
Cursor • Claude Code • Codex
Done when
Код написан, тесты проходят, нет явных ошибок в консоли, закоммичено
Antipatterns ✗
  • Писать всё сразу без промежуточных проверок
  • Игнорировать ошибки и идти дальше
  • Не коммитить рабочие состояния
Prompt
Роль: Fullstack developer. Задача: [конкретный чанк функционала]. Контекст: [только релевантные файлы]. Когда закончишь — скажи что нужно для следующего.
5. Дебагrole: Developer / QA
Goal
Найти и устранить ошибки систематически
Inputs
  • Код с ошибками или неожиданным поведением
Activities
  1. Воспроизвести ошибку стабильно
  2. Изолировать: где именно ломается
  3. Собрать контекст: лог, стек, входные данные
  4. Сформулировать гипотезу
  5. Проверить гипотезу минимальным изменением
  6. Зафиксировать решение
Outputs
  • Исправленный код
  • Запись: что было, почему, как починил
Tools
Встроенный дебаггер IDE • Console/Logs • Claude для анализа ошибок • Git diff для отката
Done when
Ошибка исправлена, добавлен тест, задокументировано
Antipatterns ✗
  • Менять всё подряд надеясь что заработает
  • Не читать сообщение об ошибке
  • Дебажить в проде
  • Не записывать что пробовал
Framework
  1. Воспроизведи — если не можешь воспроизвести, не можешь починить
  2. Изолируй — убери всё лишнее, найди минимальный код с ошибкой
  3. Гипотеза — что по-твоему сломано и почему
  4. Проверь — одно изменение за раз
  5. Зафиксируй — коммит + комментарий что было не так
Prompt
Ошибка: [полный текст ошибки]. КАК ВОСПРОИЗВЕСТИ ОШИБКУ — СРЕДА, ТУЛЫ И ТД. Код: [релевантный фрагмент]. Что я уже пробовал: [список]. Объясни вероятную причину и предложи 2-3 варианта решения с объяснением почему каждый может помочь.
6. Деплойrole: DevOps / Developer
Goal
Доставить продукт пользователям
Inputs
  • Протестированный код
  • PRD (для проверки что деплоим то что планировали)
Activities
  1. Проверить что PRD выполнен
  2. Выбрать платформу деплоя
  3. Настроить CI/CD (если нужно)
  4. Задеплоить
  5. Проверить в проде
  6. Мониторинг первых часов
Outputs
  • Рабочий URL / приложение
  • Инструкция для пользователей
  • Алерты на критичные ошибки (опционально)
Tools
Vercel • Railway • Render • GitHub Actions
Done when
Пользователь может открыть/использовать продукт без твоей помощи
Antipatterns ✗
  • Деплоить без тестирования
  • Не проверять после деплоя
  • Забыть про environment variables
  • Нет способа откатиться
Prompt
Проект: [стек]. Нужно задеплоить на [платформа]. Создай пошаговую инструкцию. Укажи: 1) Какие env vars нужны, 2) Команды для билда, 3) Как проверить что работает, 4) Как откатить если сломается.

Feedback Loops — когда возвращаться назад

Откуда → КудаТриггерДействие
АрхитектураPRDНевозможно реализоватьСократить scope
КодАрхитектураСтруктура не работаетУпростить
ДебагКодБагПочинить + тест
ДебагАрхитектураСистемный багМенять архитектуру
ДеплойКодНе работает в продеФиксить env
ДеплойPRDНужно другоеНовая итерация
Когда сокращать
Эксперимент: Идея → сразу код
Знакомый стек: Сократить архитектуру
Прототип: Без тестов и CI/CD
Когда расширять
Команда: +review на каждом этапе
Прод: +security, load testing
Регуляции: +compliance checks
Принципы
• Маленькие итерации лучше больших
• Рабочий код > идеальная документация
• Фиксируй решения, не только код
• Застрял → вернись назад
• LLM — помощник, не замена