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

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

Яков Васильев

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. PRD→3. Архитектура→4. Код→5. Дебаг→6. Деплой

1. Генерация идеиrole: Product Strategist

Goal

Сформулировать ценность для пользователя и проверить уникальность

Inputs

Проблема или потребность
Контекст рынка (опционально)

Activities

Сгенерировать 5+ вариантов идей
Deep research — узнать что уже существует
Отсеять до 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

Описать Purpose — кому и какую ценность
Определить Users & Scenarios (3-5 сценариев)
Задать KPIs — как измерим успех
Зафиксировать Constraints (стек, бюджет, время, лицензии)
Описать Rollout plan
Перечислить риски

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

Преобразовать PRD в минимальную архитектуру
Выбрать стек (или подтвердить constraint из PRD)
Определить структуру файлов/модулей
Описать data model
Зафиксировать 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

Добавить в контекст: PRD + план + структуру
Закрыть тесты относящиеся к задаче
Писать код — модуль за модулем
После каждого модуля — проверка и коммит
После каждого чанка: проверка, тест, коммит
Только потом следующий чанк

Outputs

Работающий код
Базовые тесты
README с инструкцией запуска

Tools

Cursor • Claude Code • Codex

Done when

Код написан, тесты проходят, нет явных ошибок в консоли, закоммичено

Antipatterns ✗

✗ Писать всё сразу без промежуточных проверок
✗ Игнорировать ошибки и идти дальше
✗ Не коммитить рабочие состояния

Prompt

Роль: Fullstack developer. Задача: [конкретный чанк функционала]. Контекст: [только релевантные файлы]. Когда закончишь — скажи что нужно для следующего.

5. Дебагrole: Developer / QA

Goal

Найти и устранить ошибки систематически

Inputs

Код с ошибками или неожиданным поведением

Activities

Воспроизвести ошибку стабильно
Изолировать: где именно ломается
Собрать контекст: лог, стек, входные данные
Сформулировать гипотезу
Проверить гипотезу минимальным изменением
Зафиксировать решение

Outputs

Исправленный код
Запись: что было, почему, как починил

Tools

Встроенный дебаггер IDE • Console/Logs • Claude для анализа ошибок • Git diff для отката

Done when

Ошибка исправлена, добавлен тест, задокументировано

Antipatterns ✗

✗ Менять всё подряд надеясь что заработает
✗ Не читать сообщение об ошибке
✗ Дебажить в проде
✗ Не записывать что пробовал

Framework

Воспроизведи — если не можешь воспроизвести, не можешь починить
Изолируй — убери всё лишнее, найди минимальный код с ошибкой
Гипотеза — что по-твоему сломано и почему
Проверь — одно изменение за раз
Зафиксируй — коммит + комментарий что было не так

Prompt

Ошибка: [полный текст ошибки]. КАК ВОСПРОИЗВЕСТИ ОШИБКУ — СРЕДА, ТУЛЫ И ТД. Код: [релевантный фрагмент]. Что я уже пробовал: [список]. Объясни вероятную причину и предложи 2-3 варианта решения с объяснением почему каждый может помочь.

6. Деплойrole: DevOps / Developer

Goal

Доставить продукт пользователям

Inputs

Протестированный код
PRD (для проверки что деплоим то что планировали)

Activities

Проверить что PRD выполнен
Выбрать платформу деплоя
Настроить CI/CD (если нужно)
Задеплоить
Проверить в проде
Мониторинг первых часов

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 — помощник, не замена