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

Spec-driven development это когда вы сначала пишете спецификацию: что строите, зачем, где границы, как поймёте, что готово. И только потом нейросеть генерирует код по ней. Без спецификации агент теряет нить и сваливается в бесконечные циклы «перегенери заново». Спека фиксирует смысл один раз, и дальше код ему служит.

Знакомая картина: «давай заново»

Если вы уже поручали нейросети писать код, сцена знакомая. Вы описываете, что нужно. Агент выдаёт результат. Не то. Вы поправляете. Он переделывает и попутно ломает то, что работало вчера. Вы просите вернуть как было. Он возвращает, но теряет половину новой логики. Третий заход, пятый, десятый.

Это и есть вайб-кодинг без спеки. Смысл проекта вы держите у себя в голове, а агент каждый раз достраивает картинку заново, по обрывку из последнего сообщения. Память у него короткая. Что вы говорили два часа назад, для него уже не существует.

Тут есть неприятная цифра. Исследователи из METR замерили, как ИИ влияет на скорость опытных разработчиков. Сами разработчики были уверены, что ускорились примерно на 20 процентов. По факту они замедлились на 19. Регенерация с нуля как раз и съедает эту разницу: кажется, что движешься быстро, а на деле ходишь по кругу.

Что такое спецификация на самом деле

«Спецификация» звучит громоздко. По сути это короткий текстовый документ. Кода в нём нет. В нём написано: что мы строим, для кого, зачем, где проходят границы (что в проект входит, а что точно нет) и как мы поймём, что задача закрыта.

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

Порядок здесь главное: смысл, потом план, потом код. Не наоборот. Спецификация это та самая нить, которую агент в вайб-кодинге постоянно теряет. Вы вытаскиваете её из головы и кладёте на стол. Дальше нить есть у обоих: и у вас, и у нейросети.

Это не новый тренд. Это то, что я повторяю давно

На менторских сессиях я чаще всего возвращаюсь к двум вещам.

Первая: идти от финиша к старту. Проект начинается не со строчки кода. Сначала ясная картинка готового результата, а уже потом её разбиваешь на части и двигаешься обратно, к началу.

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

Так вот, spec-driven development это ровно эти две вещи, собранные в документ. Картинка готового результата и есть спецификация. Заложенные смыслы и правила это снова она. Индустрия дала подходу название и собрала под него инструмент. Название удобное, не возражаю. Но суть была понятна и раньше: пока смысл не зафиксирован, нейросети нечему следовать.

Как это выглядит на практике

Спецификацию можно вести как обычный текстовый файл рядом с проектом. Это уже работает: агент читает файл и держится его. Но в мае 2026 у подхода появился инструмент, который быстро подхватили, GitHub Spec Kit.

Если коротко, это набор готовых команд для Claude Code и Codex (двух инструментов, которыми нейросеть пишет код прямо у вас на машине). Команд три, и они задают тот самый порядок.

/specify берёт вашу задачу в обычных словах и превращает в спецификацию. Дальше /plan раскладывает её на шаги. И только после этого /tasks выдаёт конкретные задачи, по которым уже пишется код.

К середине мая 2026 у Spec Kit больше 90 тысяч звёзд на GitHub и поддержка 29 разных ИИ-агентов. Издание Visual Studio Magazine назвало его противоядием от хаотичного вайб-кодинга. А в Amazon на похожем подходе (их инструмент называется Kiro) выпускали фичи, которые по старому счёту тянули на 40 часов работы, меньше чем за 8 часов живого времени человека. Не магия. Просто меньше походов по кругу.

Ставить Spec Kit, чтобы начать, не обязательно. Достаточно один раз написать спецификацию обычным текстом и приучить себя не давать агенту ни строчки кода, пока смысл не лежит на столе. Инструмент это удобство, а не условие.

Разовые промпты против спеки

Вот эта разница по пунктам.

Главная строка тут первая. Разовые промпты гонят число переделок вверх с каждым новым этапом. Спека держит его внизу.

С чего начать

Никакой инструмент для этого не нужен. Возьмите ближайшую задачу для нейросети и, прежде чем писать «сделай», запишите ответы на несколько вопросов. Что строим? Для кого? Зачем? Что в границы точно не входит? Как поймём, что готово? Вот это уже спецификация.

Если не хотите собирать формулировки с нуля, я собрал готовые шаблоны: спецификация фичи, правила проекта, план работ и промпт, который держит Claude Code и Codex на спеке. Шаблоны идут с разбором, что куда писать. Лежат в отдельном материале.

А если кабинет у вас уже есть, материалы и история заказов под рукой там.

Спека не добавляет нейросети ума. Она просто не даёт расходовать этот ум на угадывание, что вы имели в виду. Положите смысл на стол до того, как сядете за код. Вот и всё.