Spec-driven разработка: чем отличается от Waterfall

Что в ролике
Если AI-инструмент для кодинга делает не совсем то, что вы хотели, приходится уточнять через повторные промпты — команды решают эту проблему, описывая требования заранее в виде спецификации. Такой подход называют spec-driven development, и он напоминает водопад, но только на первый взгляд: в водопаде спецификация пишется целиком до начала разработки и застывает, а изменения стоят дорого, потому что приходится возвращаться на шаг назад. В spec-driven разработке спецификация тоже стартует первой, но дальше идёт короткий цикл: агент строит по ней, вы проверяете результат и уточняете спецификацию, обнаружив новые кейсы. Например, для функции сброса пароля спецификация может состоять из трёх строк: отправлять ссылку на email, ссылка истекает через 15 минут и работает только один раз; после проверки выясняется, что надо добавить правило «использовать только последнюю ссылку». Отличие от водопада в том, что спецификация хранится в виде markdown-файла рядом с кодом и не устаревает, а также задаёт критерии для тестирования и приёмки. AI меняет ситуацию: неоднозначность теперь превращается в дополнительные промпты и итерации, которые стоят денег и времени, поэтому чёткая спецификация экономит ресурсы, а агент может помочь её составить и обновлять. Спецификации могут включать требования безопасности и соответствия, например, обязательную аутентификацию или запрет на хранение персональных данных в логах; в водопаде такие вещи всплывали поздно, на этапе тестирования. При этом специфицировать всё подряд не нужно: быстрый багфикс можно делать без неё, а вот крупная фича с затрагиванием нескольких сервисов выиграет от такого подхода.
Практика
- Что получишь
- Понимание, как организовать работу с AI-инструментами через спецификацию, чтобы получать более точный код с меньшим числом итераций, а также критерии, когда спецификация нужна, а когда нет.
- Первый шаг
- Попробуйте для следующей крупной фичи, которую вы даёте агенту, написать короткую спецификацию из 3–5 строк с требованиями и критериями приёмки, и сравните результат.
- Цифры
- —15 минут — на столько должна истекать ссылка для сброса пароля по спецификации из примера
- —3 строки — из стольких пунктов состояла исходная спецификация для сброса пароля
- —часы или дни — столько занимает один цикл spec-driven разработки для одной фичи против месяцев в водопаде
- Честно
- Рекламы или продвижения в ролике нет, это образовательный материал IBM Technology. Автор показывает пример спецификации для сброса пароля, но конкретные шаблоны или код не предоставляет, поэтому для применения нужно самостоятельно составить спецификацию под свой проект.
Если слова незнакомы — 3 терминов
- промпттекст-задание, которое ты пишешь AI-ассистенту
- агентпрограмма, которая сама выполняет шаги по заданной спецификации
- markdownпростой текстовый формат с разметкой, который удобно хранить рядом с кодом
Формат: разбор · для практикующих · уверенность разметки 0.9 · источник