Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

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

С макетами ровно то же самое. «Собери экран заказа» — получаешь три варианта, выбираешь второй, через неделю просишь добавить состояние ошибки и получаешь четвёртый, не похожий ни на один из трёх.

Проблема не в модели. Вся договорённость о том, что мы вообще строим, жила в чате. А чат я закрыл.

Спек-ориентированная разработка (spec-driven development, SDD) — попытка вынести эту договорённость из чата в файл. Дальше по тексту я веду две линии сразу: как это работает в коде и как то же самое ложится на дизайн. Инструменты разные, механика одна.

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

1. Что такое спека

Самое честное определение я нашёл у Биргитты Бёкелер, Distinguished Engineer в Thoughtworks. В октябре 2025 она разобрала три инструмента SDD и написала об этом на martinfowler.com:

Спека — структурированный, ориентированный на поведение артефакт (или набор связанных артефактов) на естественном языке, который описывает функциональность и служит руководством для ИИ-агентов.

Ключевое слово — «поведение». Спека описывает, что система делает и почему. Не то, как это написано в коде.

Второе разграничение оттуда же, и оно важнее первого. Спека — не контекстные файлы проекта. Есть memory bank: AGENTS.md, CLAUDE.md, описание архитектуры, правила код-стайла. Он нужен всегда, в любой сессии. Спека относится только к той задаче, которая создаёт или меняет конкретную функциональность.

Смешивать их — первая типовая ошибка. Правила линтера в спеке фичи не нужны.

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

В дизайне граница проходит там же. Ваш memory bank — это дизайн-система: токены, шаг сетки, правила отступов, набор компонентов, тон текстов. Он действует всегда. Спека — это описание одного экрана или одного потока: что происходит, в каких состояниях, при каких данных. Бриф на редизайн — не спека, это постановка задачи. Мудборд — не спека, это референс вкуса. Спекой становится то, что можно проверить: «при пустом списке показываем иллюстрацию и кнопку „Создать первый заказ“».

Чем спека отличается от промпта

Тем, что переживает сессию.

Шон Гроув из OpenAI в докладе «The New Code» на AI Engineer World's Fair 2025 сформулировал издевательски точно: мы сохраняем сгенерированный код и удаляем промпт. Как если бы вы шредили исходники и бережно версионировали бинарник.

Второй его тезис многих взбесил: код — это 10–20% ценности программиста. Остальные 80–90% — структурированная коммуникация. Понять проблему, выделить требования, спланировать, проверить, что решили именно то, что нужно. Спека эту часть фиксирует, промпт — нет.

У дизайнера пропорция ещё жёстче. Фигурки на холсте — это финальный артефакт, но ценность создаётся раньше: в разговоре с продактом, в отборе сценариев, в решении, чего мы не делаем. Ровно эта часть обычно нигде не записана, и именно она теряется первой.

Как пример живой спеки Гроув приводит OpenAI Model Spec — документ о том, как должны вести себя модели OpenAI. Набор markdown-файлов на GitHub: человекочитаемо, версионируется, есть changelog. Править могут не только инженеры, но и продакты, юристы, policy.

Ну, круто же. Вот это и есть спека в максимально зрелом виде.

2. Откуда ноги растут (спойлер: не из 2025 года)

SDD подают как новинку эпохи агентов. На деле почти всё уже было.

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

EARS, 2009. Алистер Мэйвин с коллегами из Rolls-Royce разбирал требования к системе управления авиадвигателем и заметил: все хорошо написанные требования следуют одной структуре — клаузы всегда идут в одном порядке. Так родился Easy Approach to Requirements Syntax, показанный на конференции RE'09. В Rolls-Royce до этого насчитали восемь болячек обычных текстовых требований: двусмысленность, расплывчатость, сложность, пропуски, дублирование, многословие, протаскивание реализации в требования, непроверяемость. Переписывание по EARS дало значительное сокращение по всем восьми: по пяти критериям проблемы исчезли полностью, по трём оставшимся — двусмысленности, расплывчатости и многословию — заметно уменьшились.

BDD, середина 2000-х. Given / When / Then. Сценарии приёмки на человеческом языке — прямой предок acceptance criteria в современных спеках.

PR/FAQ в Amazon. Процесс Working Backwards: до разработки пишется пресс-релиз будущего продукта плюс большой FAQ. Через него прошло большинство крупных продуктов Amazon начиная с 2004 года — Kindle, Prime, AWS. Колин Брайар и Билл Карр разобрали процесс в книге Working Backwards 2021 года. Их мысль стоит вытатуировать: то, что большинство PR/FAQ не проходят, — не баг процесса, а фича.

MDD, 2000-е. Вот это самая интересная параллель, на неё указывает Бёкелер. В model-driven development модели (UML, текстовые DSL) были теми же спеками, и по ним генерировали код кодогенераторами. Не взлетело: слишком жёсткая абстракция, слишком много накладных расходов. LLM снимают часть ограничений — не нужен ни парсибельный язык, ни собственный генератор. Ценой недетерминированности.

У дизайна своя ветка того же дерева, и она даже длиннее. Аннотированные макеты, гайдлайны, спецификации состояний, UX-сценарии, дизайн-системы с документацией — всё это спеки, просто мы их так не называли и почти никогда не версионировали рядом с продуктом.

SDD — не изобретение. Старая идея, которой наконец достался исполнитель, читающий по-человечески.

3. Три уровня зрелости

Самая полезная схема во всей теме — тоже у Бёкелер. Три ступени, каждая надстраивается над предыдущей:

  1. Spec-first. Написали спеку → сделали по ней задачу → спека своё отработала. Дальше её можно выбросить.
  2. Spec-anchored. Спека живёт после задачи. Меняете фичу — сначала правите спеку, потом код.
  3. Spec-as-source. Спека — единственный исходник, код человек не трогает вообще. Это позиция Tessl: у них сгенерированные файлы помечены комментарием // GENERATED FROM SPEC - DO NOT EDIT.
Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

Та же лестница в дизайне читается так. Spec-first — вы описали экран словами, собрали макет, описание выкинули. Так работает почти вся индустрия. Spec-anchored — описание состояний живёт в аннотациях рядом с макетом, и при изменении вы правите сначала его. Так работают зрелые дизайн-системы. Spec-as-source — макет генерируется из описания, руками холст не трогают. В дизайне это пока фантастика: генерация даёт варианты, а не воспроизводимый результат.

Практически все команды сейчас на первой-второй ступени. И почти все инструменты умалчивают, что делать со спекой через полгода.

Держите эту лестницу в голове, когда читаете очередной тред «мы перешли на SDD». В девяти случаях из десяти речь про первую ступень. То есть про «я написал нормальное ТЗ, прежде чем звать агента».

4. Четыре школы в разработке

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

GitHub Spec Kit — тяжёлый, подробный, самый популярный

Spec Kit — опенсорсный тулкит от GitHub. Репозиторий появился в августе 2025, публичный анонс вышел 2 сентября. На момент написания в документации значится 130 тысяч звёзд, 270+ контрибьюторов, 38 интеграций с агентами, 157 расширений от 90+ авторов и 33 пресета. Ставится как CLI, дальше работаете слэш-командами прямо в своём агенте.

Полная цепочка из официальной справки: constitution → specify → clarify → plan → checklist → tasks → analyze → implement → converge.

Что делает каждая.

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

specify — сама спека. Что и зачем. Никакого стека.

clarify — агент задаёт точечные вопросы по недосказанным местам и вписывает ответы обратно в spec.md. Гоняйте несколько раз, каждый проход ловит свои дыры.

plan — вот теперь техника: стек, архитектура, ограничения.

checklist — та ещё находка. GitHub называет её юнит-тестами для требований: проверяется не код, а сама спека на полноту и непротиворечивость. «Правила drag-and-drop описаны для всех колонок?», «а что происходит, если назначенного пользователя удалили?». У меня она стабильно вытаскивает две-три дыры, которых я не видел.

tasks — разбивка по фазам. Setup, Foundational, дальше по фазе на каждую user story, в конце Polish.

analyze — read-only. Сверяет spec.md, plan.md и tasks.md между собой, выдаёт отчёт о конфликтах, файлы не трогает.

implement — исполнение. Крупную фичу запускайте по частям, а не одним махом.

converge — сверка готового кода со спекой. Только дописывает задачи, ничего не удаляет. Гоняете implement и converge, пока не сойдётся.

Короткий путь — пять шагов: specify → plan → tasks → implement → converge. Полные девять нужны там, где цена ошибки высокая.

AWS Kiro — три файла и никакой философии

Kiro — IDE на базе VS Code от Amazon, в общем доступе с ноября 2025, сейчас есть ещё и CLI. Спека живёт в .kiro/specs/<фича>/ и состоит из трёх файлов.

requirements.md — user stories и критерии приёмки в нотации EARS.

design.md — архитектура, sequence-диаграммы, модели данных, обработка ошибок, стратегия тестирования.

tasks.md — атомарные задачи, каждая со ссылкой на номер требования.

Плюс memory bank, который тут называется steering: product.md, tech.md, structure.md.

Ценного в Kiro две вещи. Трассируемость: каждая задача тянется к номеру требования, и видно, откуда взялся любой кусок кода. И два входа — Requirements-First, когда знаете что, но не знаете как, и Design-First, когда начинаете с архитектуры и выводите требования из неё. Есть ещё Quick Spec: прогоняет все три фазы без гейтов. И отдельный тип спеки под баги — Bugfix Specs, с разбором корневой причины.

Задачи Kiro раскладывает на «волны» по графу зависимостей. Всё, что не зависит друг от друга, идёт параллельно.

OpenSpec — лёгкий, для живых репозиториев

OpenSpec решает то, что Spec Kit и Kiro решают плохо, — brownfield. Существующий проект, куда надо аккуратно внести изменение.

Цикл из трёх шагов: propose → apply → archive. Плюс необязательный explore в начале, если ещё не поняли, чего хотите.

Ключевая идея — дельта-спеки. Вы не описываете систему целиком, вы описываете изменение. В openspec/specs/ лежит источник истины — текущее поведение системы. В openspec/changes/<имя-изменения>/ — папка предложения: proposal.md, specs/, design.md, tasks.md.

Дальше это ложится прямо на git-флоу: ветка → propose → ревью плана → apply → PR, в котором лежат и спека, и код → мерж → archive, дельта вливается в specs/.

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

Tessl — единственный, кто всерьёз идёт в spec-as-source

Фреймворк Tessl пока в бете. Спека — главный артефакт, код генерируется из неё, маппинг сейчас один к одному: одна спека → один файл. Есть теги @generate и @test, есть обратная операция: tessl document --code ... разбирает существующий файл в спеку.

Бёкелер честно описала, что было, когда она генерировала код из одной и той же спеки несколько раз. Результат отличался. Дальше она итеративно уточняла спеку, чтобы повысить повторяемость, — и, по её словам, это очень напомнило классические грабли написания непротиворечивой и полной спецификации.

И самый дешёвый вариант — просто SPEC.md

Не хотите тащить фреймворк — не тащите. У Anthropic в best practices для Claude Code описан цикл из четырёх фаз: explore → plan → implement → commit. Сначала plan mode: агент читает код и отвечает на вопросы, ничего не меняя. Потом просите план. Потом выходите из plan mode и реализуете.

Там же лежит приём, которым я теперь пользуюсь чаще всего:

Я хочу построить [краткое описание]. Проинтервьюируй меня подробно. Спрашивай про техническую реализацию, UI/UX, крайние случаи, риски и компромиссы. Не задавай очевидных вопросов — копай в сложное, о чём я мог не подумать. Продолжай, пока не покроем всё, потом напиши полную спеку в SPEC.md.

Дальше — новая сессия с чистым контекстом и готовой спекой. И оттуда же формулировка, лучшая в теме: самые полезные спеки самодостаточны. Называют конкретные файлы и интерфейсы, явно проговаривают, что вне скоупа, и заканчиваются сквозной проверкой, доказывающей, что фича работает.

5. Как это выглядит в дизайне

Отдельного «Spec Kit для дизайнеров» нет. Зато есть кое-что интереснее: индустрия пришла к тому же самому с другой стороны и назвала это design context.

Аннотация стала машиночитаемой

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

Это главное, что изменилось за последний год, и многие дизайнеры мимо этого прошли. Раньше аннотация в Figma была запиской для разработчика — человек прочитает, если заметит. Теперь Dev Mode MCP-сервер отдаёт аннотации агенту как часть контекста. Figma формулирует это прямо: сгенерированный код опирается и на структуру макета, и на дизайн-интент.

То есть ваша подпись рядом с кнопкой перестала быть комментарием и стала требованием, которое исполняется.

В блоге Figma про design context перечислено, что именно стоит аннотировать, и список читается как оглавление спеки: интерактивные элементы — что происходит по клику и ховеру, какой курсор; условные состояния — когда и по какой причине меняется состояние, например кнопка «Отправить» заблокирована, пока обязательные поля не прошли валидацию; динамический контент — где стоит заглушка, а данные придут из источника.

Сравните это с паттернами EARS ниже. Это они и есть, просто в интерфейсных терминах.

Что MCP-сервер отдаёт и чего не отдаёт

Figma рассказывала об устройстве сервера отдельно: агент получает структуру макета, переменные, свойства компонентов, имена слоёв, тексты, ссылки на изображения — и даже плейсхолдеры помогают модели понять, какими данными наполнять интерфейс. Работает сервер локально и цепляется к Copilot, Cursor, Windsurf, Claude Code.

А вот чего он не отдаёт, знать важнее. Связи прототипа, smart animate и поведение скролла через MCP пока не пробрасываются. Сервер в бете, ограничения по авто-лейауту и сеткам Figma сама отмечает как зону для доработки.

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

Дизайн-система как конституция

В Spec Kit конституция — это принципы, против которых проверяется каждый шаг. У вас такая конституция уже есть, просто лежит не в markdown, а в головах и в библиотеке компонентов.

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

И связка, которую стоит настроить один раз: если имена переменных в Figma совпадают с именами токенов в коде, агент перестаёт угадывать. Figma отдельно подчёркивает, что выравнивание именования между дизайном и кодом — условие вменяемого результата.

6. Как писать спеку

Теперь практика. Скелет один, примеры — в двух проекциях.

Анатомия

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

Проблема и зачем. В коде: не «добавить кэширование», а «добавить кэширование, потому что p95 у API 100 мс, а для автокомплита нужно меньше 20». В дизайне: не «переделать карточку товара», а «в карточке не видно итоговую цену с доставкой, треть обращений в поддержку про это». Причина важнее задачи: наткнувшись на неоднозначность, агент решит её сам — и решит правильно, только если понимает цель.

Скоуп и антискоуп. Что делаем и, обязательно, чего не делаем. В дизайне антискоуп звучит так: «делаем только мобильную версию, десктоп и письма не трогаем, иконки не перерисовываем». Это самый экономящий блок в обеих проекциях, потому что именно туда агент уходит гулять.

Сценарии. В коде — user stories с критериями приёмки. В дизайне — поток целиком: откуда пользователь пришёл, что видит, что делает, куда попадает. Не один экран, а путь.

Крайние случаи. В коде: дубль вебхука, отрицательный баланс, внешний сервис недоступен 30 минут. В дизайне свой набор, и он длиннее, чем кажется: пустое состояние, состояние загрузки, ошибка сети, отказ прав, заголовок в 200 символов вместо 20, имя без пробелов, отсутствующая картинка, один элемент в списке, 999+ элементов, длинная валюта, RTL. Каждый из этих пунктов — экран, который кто-то нарисует. Вопрос только, вы или агент наугад.

Ограничения. В коде: стек, версии, что нельзя ломать, инварианты бизнес-логики. В дизайне: токены и компоненты системы, платформенные гайдлайны, минимальная зона нажатия, требования к контрасту, длина строки, что не должно сломаться на планшете.

Проверка. Как поймём, что готово. В коде — тест, скрипт, exit code. В дизайне — сравнение с эталонным скриншотом, прогон сценария от входа до конца, проверка контраста, проверка на самых длинных данных. Главное требование то же: результат должен читаться как pass или fail без вашего вкуса в роли арбитра.

EARS: пять шаблонов на все случаи

Общая формула одна: While «предусловие», when «триггер», the «система» shall «реакция».

Правило: 0..n предусловий, 0..1 триггер, ровно одно название системы, 1..n реакций. Клаузы всегда в одном порядке. Отсюда получается пять паттернов.

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

Ubiquitous — без ключевого слова. Работает всегда. В коде: «Система шифрует токены в состоянии покоя». В интерфейсе: «Все интерактивные элементы имеют видимое состояние фокуса».

Event-driven — «когда». Срабатывает на событие. В коде: «Когда админ отправляет форму с валидным email, система создаёт инвайт и шлёт письмо с подписанной ссылкой». В интерфейсе: «Когда пользователь нажимает „Сохранить“, кнопка переходит в состояние загрузки и блокируется до ответа сервера».

Unwanted behaviour — «если». Ловит нежелательное. В коде: «Если email уже принадлежит участнику воркспейса, система возвращает ошибку и не создаёт инвайт». В интерфейсе: «Если обязательное поле пустое, кнопка отправки остаётся неактивной, а под полем появляется подсказка». Это ровно тот пример, который Figma приводит в своём же руководстве по аннотациям.

State-driven — «пока». Действует, пока держится состояние. В коде: «Пока инвайт не принят и не истёк, система разрешает завершить регистрацию». В интерфейсе: «Пока данные грузятся, на месте карточек показывается скелетон, а не спиннер».

Optional feature — «где». Только там, где фича включена. В коде: «Где включён SSO, система скрывает форму пароля». В интерфейсе: «Где у пользователя выбрана тёмная тема, иллюстрации подменяются на тёмный вариант».

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

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

До и после: код

До: «Нужна нормальная авторизация с инвайтами, чтобы админ мог позвать коллегу».

После:

## История: админ приглашает коллегу

- Система разрешает создавать инвайты только пользователям с ролью admin.
- Когда админ отправляет форму с валидным email, система создаёт запись инвайта и отправляет письмо с подписанной ссылкой.
- Если email уже принадлежит участнику воркспейса, система возвращает «Пользователь уже в воркспейсе» и не создаёт инвайт.
- Пока инвайт не принят и с момента создания прошло меньше 7 дней, система разрешает приглашённому завершить регистрацию.

### Вне скоупа
Массовый импорт по CSV, SCIM-провижининг, кастомные роли.

### Проверка
`pytest tests/test_invites.py` — зелёный, включая кейс просроченной ссылки.

До и после: экран

До: «Сделай красивый экран списка заказов».

После:

## Экран: список заказов

- Экран всегда показывает заказы по убыванию даты.
- Когда пользователь тянет список вниз, подгружается следующая страница по 20 штук.
- Если заказов нет, вместо списка показывается иллюстрация, строка «Здесь появятся ваши заказы» и кнопка «В каталог».
- Если запрос не прошёл, показывается строка ошибки и кнопка «Повторить», уже загруженные заказы остаются на месте.
- Пока грузится первая страница, на месте карточек — скелетон.
- Где у заказа больше трёх товаров, превью показывает три и счётчик «+N».

### Вне скоупа
Фильтры, поиск, десктоп, письма о статусе.

### Ограничения
Только токены системы, карточка — существующий компонент `order-card`, минимальная зона нажатия 44 px.

### Проверка
Прогон сценария на трёх наборах данных: пусто, один заказ, 120 заказов с названиями по 200 символов.

Разница не в объёме. Второй вариант нельзя понять двумя способами — и по нему видно, сколько экранов на самом деле нужно нарисовать.

Чего в спеке быть не должно

Кода и пиксельных значений. Спека, которая превратилась в псевдокод или в список координат, стала деталью реализации и потеряла смысл. Отступы живут в токенах, а не в требованиях.

Технических решений на функциональном уровне. Стек — в plan.md. Выбор между модалкой и отдельным экраном — тоже решение, а не требование; если оно уже принято, вынесите его в ограничения и назовите решением.

Правил проекта. Их место в конституции, CLAUDE.md или steering.

Воды. Каждая строчка, которую агент проигнорирует, увеличивает шанс, что он проигнорирует и соседнюю.

7. Где спека не нужна

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

Опечатка. Строчка лога. Переименование переменной. Сдвиг иконки на два пикселя. Замена одного текста в кнопке.

Лучший фильтр — правило из документации Anthropic: можете описать диф одним предложением — планирование это чистые накладные расходы.

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

8. Где подход трещит

Претензии в духе «ИИ переоценён» сюда не годятся — они про ИИ вообще, а не про спеки. Вот что ломается именно в SDD.

Спека не решает проблему требований. Она её переносит. Это самая недооценённая претензия. SDD меняет, где лежат требования и как они попадают в результат. Оно не трогает то, как они написаны. Команда, которая умела писать мутные тикеты, теперь будет писать мутные спеки — и получать плохо описанные системы быстрее и в большем количестве. Поэтому EARS в этой статье занимает больше места, чем любой из инструментов: синтаксис бьёт по проблеме там, где она живёт, — в отдельном предложении. Фреймворк бьёт по папкам.

«Контракт», который никто не обязан исполнять. GitHub в анонсе Spec Kit прямо называет спеку контрактом поведения кода. Слово красивое и неверное. За настоящим контрактом стоит принуждение: компилятор не соберёт, типы не сойдутся, тест упадёт. За спекой не стоит ничего, кроме ещё одного прогона модели. Бёкелер сгенерировала код из одной спеки несколько раз и получила разные результаты. Это не контракт. Это подробно оформленное пожелание.

Спека расходится с результатом молча. У кода есть сторожа — линтер, тайпчекер, CI. Соврал в коде — тебе сказали. Соврала спека — не сказал никто. Spec Kit пришлось завести отдельную команду converge, которая ходит по кодовой базе и ищет расхождения со спекой. Инструмент сам признал, что рассинхрон — норма жизни.

В дизайне этот разрыв ещё шире, потому что источников два. Аннотации живут в Figma, спека и код — в репозитории. Поправили макет, забыли аннотацию — и агент собирает по описанию того экрана, которого больше нет. Сторожа тут нет вообще никакого.

Переносимости ноль. Kiro кладёт спеки в .kiro/specs/, Spec Kit — в specs/, OpenSpec — в openspec/ с дельтами. Форматы разные, гранулярность разная, философия разная. Написали сорок спек в одном инструменте, захотели в другой — переписывайте руками. Вендор-локин мы научились распознавать, а это локин на уровне процесса.

Молоток по мухе. Бёкелер попросила Kiro починить маленький баг. Kiro выдала 4 user story и 16 критериев приёмки, включая шедевр «Как разработчик, я хочу, чтобы функция трансформации изящно обрабатывала крайние случаи». Ни один из инструментов внятно не отвечает, на какой размер задачи он рассчитан.

И главное ограничение для дизайна: спека не описывает вкус. EARS блестяще ловит поведение и совершенно беспомощен в композиции, ритме, типографике, ощущении от интерфейса. Можно описать все состояния кнопки и получить технически безупречный и при этом мёртвый экран. Спека снимает с вас вопросы «что происходит» — и ровно ноль вопросов «почему это выглядит хорошо». Вторую половину работы никто не отменял, её просто стало видно отдельно. Мне это, честно говоря, нравится.

И маленькая деталь, которая говорит больше остальных абзацев. В CONTRIBUTING.md самого Spec Kit написано: если мейнтейнер видит, что правку целиком сгенерировал ИИ без участия и тестирования человека, такую правку завернут, а тех, кто шлёт их регулярно, ограничат в контрибьютах. Проект, который учит мир правильно направлять агентов, вынужден отбиваться от того, что эти агенты нагенерировали. Не лицемерие — просто честный масштаб задачи.

Общий диагноз у Бёкелер звучит одним немецким словом: Verschlimmbesserung — улучшение, которое сделало хуже. Ощущение контроля растёт быстрее, чем сам контроль.

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

9. Что это меняет для дизайнера

По State of the Designer 2026 от Figma — опрос 906 дизайнеров в пяти регионах, проводил NewtonX — 72% уже используют генеративный ИИ в работе. Инструменты освоены. Открытый вопрос теперь другой: что именно мы им отдаём.

Спеки вместо промптов: спек-ориентированная разработка — дизайнеру на заметку

Описание состояний — это работа дизайнера, а не остаток от работы. Пока аннотация была запиской для разработчика, её можно было не писать: спросят — расскажу. Теперь она исполняется. Ненаписанное состояние — это не пробел в документации, это экран, который агент придумает за вас.

Проверка вместо «мне нравится». У Anthropic в best practices описан приём: дать агенту скриншот эталона, попросить реализовать, снять скриншот результата, сравнить, выписать различия и починить. Это ваш pass/fail для визуалки, и он работает ровно настолько, насколько точно вы задали эталон.

Спека — единственный артефакт, который читают все. Продакт, дизайнер, разработчик, юрист, агент. Макет читают не все, код — тем более. Markdown, git, changelog: правит кто угодно, не только тот, кто умеет в Figma.

Дизайнер естественным образом занимает место автора требований. Не потому, что это модно, а потому, что описание поведения интерфейса — это ровно то, чем дизайнер и так занимается, только раньше он это проговаривал голосом на созвоне. Записанное вслух становится артефактом. Артефакт становится входом для агента. Кто пишет вход, тот и управляет выходом.

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

10. Что сделать завтра за полчаса

Не ставьте фреймворк первым делом. Начните с самого дешёвого уровня.

Если вы пишете код:

  1. Возьмите ближайшую задачу, которую нельзя описать одним предложением.
  2. Попросите агента проинтервьюировать вас промптом из раздела 4. Отвечайте честно, особенно на неудобное.
  3. Получите SPEC.md и прочитайте глазами. Половина ценности прямо здесь: вы увидите вопросы, которые сами себе не задали.
  4. Допишите руками «Вне скоупа» и «Проверку». Эти два блока агенты пишут хуже всего.
  5. Новая сессия, чистый контекст, реализация по спеке.
  6. Закоммитьте спеку рядом с кодом. Через месяц она объяснит, почему код или дизайн такой.

Если вы проектируете:

  1. Возьмите экран, который уже в работе, и выпишите его состояния — все, включая пустое, загрузку, ошибку и предельные данные.
  2. Каждое состояние сформулируйте по EARS: «когда», «если», «пока», «где». Пять минут на экран.
  3. Пройдитесь по списку из руководства Figma: интерактивность, условные состояния, динамический контент. Чего не хватает — допишите.
  4. Перенесите это в аннотации рядом с макетом, а не в отдельный документ, который никто не откроет.
  5. Проверьте именование: переменные в Figma и токены в коде должны называться одинаково.
  6. Отдайте агенту и сравните результат с тем, что вы имели в виду. Разошлось — дело не в агенте, дело в формулировке.

Прошло три-четыре задачи, стало тесно — вот тогда смотрите на инструмент. Живой проект — берите OpenSpec с его дельтами. Новый проект и нужна строгость — Spec Kit. Хотите всё в одной IDE — Kiro.

Итого

SDD — не революция и не новая методология. Старое доброе «сначала подумай, потом делай», которому впервые дали исполнителя, читающего по-русски. Первая ступень окупается почти всегда и стоит полчаса. Вторая — на проектах, которые живут дольше квартала. Третья пока эксперимент, и Бёкелер справедливо напоминает: MDD на этом месте уже спотыкался.

Главное, что я вынес: спека нужна не агенту. Она нужна мне. Агент и по мутному промпту что-нибудь напишет или спроектирует — а вот я через месяц не вспомню, почему решил именно так. Только поэтому я теперь пишу спеки даже для задач, которые делаю руками.

Буду благодарен за дополнения — особенно от тех, кто гонял SDD на живом продакшене больше пары месяцев. Очень хочу услышать, что происходит со спеками на третий квартал.

Ссылки

Первоисточники и документация

Дизайн и передача контекста

Разбор и критика

Требования и история

22