Blueprint в вайбкодинге: от идеи к плану за один промпт

Что такое blueprint простыми словами

Представь: ты пришёл к строителям и сказал «постройте мне дом». Они схватили молотки и понеслись. Через неделю - три стены, лестница в никуда и жаркий спор, где вообще должна быть кухня. Знакомо? Вот так выглядит вайбкодинг без плана.

Теперь нормальный заход. Сначала чертёж. На бумаге решили: где фундамент, где стены, что строим первым, что от чего зависит. И только потом - молотки. Этот самый чертёж для кода и называется blueprint Blueprint (англ. «чертёж, синька») - пошаговый план проекта: одна фраза-идея разбивается на маленькие понятные шаги, каждый со своей инструкцией. Сначала план - потом код. .

Зачем вайбкодеру blueprint

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

Blueprint лечит это так:

• режет огромную задачу на маленькие куски, которые реально проверить;
• задаёт порядок - что строить первым, а что потом;
• даёт работать в несколько заходов: закрыл сессию, открыл завтра - план на месте;
• ловит грабли заранее, пока это ещё текст, а не сломанный код.

Разница между «ИИ собрал мне непонятную кашу» и «ИИ собрал мне рабочее приложение» - это часто разница между «я попросил всё сразу» и «у нас был чертёж». План - это и есть искусство правильно просить.

Как Claude строит план: 5 шагов чертёжника

Запускаешь blueprint - и Claude не кидается писать код. Он проходит пять этапов, как нормальный архитектор перед стройкой. По очереди.

1. Разведка участка

Сначала агент осматривает «участок»: что уже есть в проекте, какие файлы, какие заметки и правила. Чертить дом, не зная грунта? Так себе идея.

2. Дизайн: режем идею на куски

Идею разбивают на шаги размером с один кусок работы (обычно их 3-12). Для каждого шага решают: что от чего зависит, что можно делать параллельно, а что строго по очереди, и как откатиться назад, если что-то пойдёт не так.

3. Черновик плана и контекст-бриф на каждый шаг

Вот тут самая хитрая штука. Каждый шаг пишут так, чтобы его смог выполнить свежий агент, который вообще не читал предыдущие шаги. Внутри шага лежит контекст-бриф Контекст-бриф - короткая самодостаточная инструкция внутри шага плана: что делать, зачем, как проверить результат. Благодаря ему агент выполняет шаг «с холодного старта», ничего не зная о прошлом. : что сделать, как проверить и когда считать шаг готовым.

4. Проверка вторым агентом

Готовый план отдают другому, более придирчивому агенту. Он читает въедливо: всё ли учли, правильный ли порядок, нет ли знакомых граблей. Критичные дыры чинят до начала стройки, а не после.

5. Регистрация плана в проекте

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

Зависимости и параллель: почему порядок шагов решает

Главная сила плана - он видит зависимости Зависимость - это «А нельзя сделать раньше Б». Например, нельзя красить стены, которых ещё нет. План выстраивает шаги в правильном порядке. . Дверь не навесишь, пока нет стены. Оплату не прикрутишь, пока нет корзины. Порядок тут не каприз - это физика стройки.

А ещё план замечает, что некоторые шаги друг другу не мешают, и пускает их параллельно. Страница «О нас» и страница «Контакты» нигде не пересекаются - значит, можно делать разом. Меньше ожидания, больше дела.

Пример из жизни: магазин стикеров без плана

Ты пишешь агенту: «сделай мне магазин по продаже стикеров». Он бодро стартует и сыплет файлами разом: каталог, корзина, оплата, админка. Через час - сюрприз. Корзина не дружит с каталогом, оплату приделали раньше входа, половину уже надо переписывать. Стройка встала.

Что пошло не так? Ты попросил весь дом одной фразой, без чертежа.

А вот как зайдёт вайбкодер, который уже обжёгся, - сначала просит план:

Не пиши пока код. Сначала составь пошаговый план проекта - интернет-магазин стикеров.
Требования к плану:

Разбей всё на маленькие шаги, каждый размером с один понятный кусок работы.
Для каждого шага напиши: что сделать, что от чего зависит и как проверить, что шаг готов.
Укажи, какие шаги можно делать параллельно, а какие строго по очереди.
Сохрани план в файл PLAN.md, чтобы я мог вернуться к нему завтра.
Покажи план и остановись - жди моего «ок», и только потом начинай первый шаг.

Что делать, когда план меняется по ходу

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

Частые ошибки при работе с blueprint

• Просить весь проект одной фразой. Агент захлебнётся. Сначала попроси план.
• Кидаться в код без чертежа. Переделка построенного - это часы, правка плана - минуты.
• Делать blueprint для мелочи. Цвет кнопки планировать не надо - это дольше, чем просто его поменять.
• Шаги-великаны. «Сделай весь магазин» проверить нельзя. Режь на шаги размером с одну понятную задачу.
• Держать план только в чате. План должен лежать в файле (PLAN.md), иначе после перезапуска его просто нет.
• Игнорировать зависимости. Приделал оплату раньше корзины - готовь время на переделку. Порядок решает.