Четыре уровня работы вайбкодера — от фикса до проекта

Простым языком

Не все задачи одинаковые. Поправить опечатку — это одно. Построить целый сайт — совсем другое. Этот гайд объясняет как правильно оценить размер задачи и не тратить лишнее время.

Думай об этом как о ремонте. Заменить лампочку — фикс. Переставить мебель — фича. Сделать евроремонт — эпик. Построить дом — проект. Каждое требует разного подхода.

Зачем нужны уровни

Не каждая задача требует полной спецификации, команды агентов и тонн планирования. Баг в одном файле и новый продукт с нуля — это разные вселенные. Уровень задачи определяет глубину процесса: какие инструменты включить, сколько проверок провести, нужны ли агенты.

Переусложнить простую задачу (Фикс через Проект) — потеря времени. Недооценить сложную (Проект через Фикс) — потеря нервов при переделке. Научись выбирать уровень правильно.

Уровень 1: Фикс — быстрое исправление

Когда использовать

Баг в одном или двух файлах
Опечатка, неправильный текст, цвет
Сломавшийся импорт или конфиг
Мелкая правка поведения

Время и команда

5–15 минут. Команда: /bug-fix. Агентов: 0–1.

Процесс

Определи проблему — скопируй полный стектрейс
Исправь — Claude находит и правит файл
Проверь — убедись, что не сломал остальное

Главное правило Фикса: копируй стектрейс целиком, не пересказывай своими словами. В ошибке есть строка файла, тип исключения, контекст — это именно то, что нужно Claude.

# Хорошо — полный стектрейс
claude "Получаю ошибку:
TypeError: Cannot read properties of undefined (reading 'map')
    at FeedCard (src/components/FeedCard.tsx:47:23)
    at renderWithHooks (node_modules/react-dom/...)
Исправь"

# Плохо — пересказ
claude "Компонент FeedCard падает"

Уровень 2: Фича — одна возможность

Когда использовать

Новый эндпоинт или страница
Новый компонент UI
Изменение поведения существующей функции
Добавление поля в форму и обработка на бэкенде

Время и команда

15–60 минут. Команда: /ship. Агентов: 1–3.

Процесс

Brainstorm — Claude задаёт уточняющие вопросы
Plan — получи план с блоками до начала кодинга
Approve — просмотри план, одобри или скорректируй
Build — реализация блоками с чекпоинтами
Test — авто-тесты и ревью
Commit — один коммит с описанием

Всегда проси Claude показать план ПЕРЕД реализацией. Это в 10 раз дешевле, чем переделывать готовый код.

Фича — основная единица работы вайбкодера. Большинство задач умещается сюда.

Уровень 3: Эпик — крупная функциональность

Когда использовать

Система авторизации (регистрация + логин + восстановление пароля + профиль)
Переделка платёжной системы
Новый раздел сайта с несколькими страницами
Рефакторинг крупного модуля

Время и команда

1–4 часа. PM + Agent Teams с wave-параллелизмом.

Пример декомпозиции Эпика

Эпик: Система авторизации

Wave 1 (параллельно, ~15 мин):
  task-001: Модель User + миграция PostgreSQL
  task-002: JWT хелпер + refresh tokens

Wave 2 (параллельно, ~20 мин):
  task-003: POST /api/auth/register
  task-004: POST /api/auth/login
  task-005: POST /api/auth/refresh

Wave 3 (последовательно, ~15 мин):
  task-006: Middleware авторизации
  task-007: GET /api/profile (защищённый)

Wave 4 (параллельно, ~20 мин):
  task-008: Интеграционные тесты полного флоу
  task-009: Документация + обновление CLAUDE.md

Уровень 4: Проект — создание с нуля

Когда использовать

Новый продукт или MVP
Полная переработка существующего сервиса
Сложная система с несколькими модулями

Время

Дни–недели. Команда: /new-project. Все агенты задействованы.

7 фаз Проекта

Фаза 0: Инфраструктура (VPS, Docker, Nginx, SSL)
Фаза 1: User Spec — глубинное интервью (7 циклов)
Фаза 2: Tech Spec — архитектура, стек, модель данных
Фаза 3: Декомпозиция — атомарные задачи + волны
Фаза 4: Реализация — TDD-цикл + Agent Teams
Фаза 5: Тестирование — до 14 типов тестов
Фаза 6: Финализация — QA + деплой + документация

Быстрая шпаргалка

Баг в одном-двух файлах?          → Фикс    (5–15 мин)
Одна новая функция или страница?   → Фича    (15–60 мин)
Несколько связанных функций?       → Эпик    (1–4 часа)
Новый продукт с нуля?              → Проект  (дни)

Правило неопределённости:
  Не уверен → начни с Фичи
  Вырастает за час → повысь до Эпика

Лучше повысить уровень, чем недооценить и переделывать.