Спека — это не документ на 20 страниц. Это контракт из пяти пунктов:
1.
Outcome. Что должно быть правдой, когда работа закончена. Не «напиши стратегию», а «документ на 2 страницы с тремя сценариями выхода, unit-экономикой для каждого и рекомендацией с обоснованием».
2.
Scope. Что входит в задачу. Рынок — Казахстан. Горизонт — 12 месяцев. Данные — из нашей CRM за последний год.
3.
Non-scope. Что
не входит. Это важнее, чем кажется. Агент без ограничений будет расширять задачу бесконечно. Martin Fowler тестировал: агенты добавляли фичи, которых не было в спеке, меняли допущения по ходу работы и заявляли «done» при сломанном билде. Non-scope — это забор. Без забора агент уходит в поле.
4.
Constraints. Какие решения уже приняты. Какие ограничения есть. Бюджет, формат, тональность, запрещённые подходы.
5.
Verification. Как проверить, что работа сделана правильно. Это самый недооценённый пункт. Без него у вас нет критерия, чтобы отличить результат от
workslop.
Пять полей. Markdown-файл. Никаких фреймворков не нужно.
Есть красивая параллель из экономики. В 2019 году исследователи из Гарварда и Торонто опубликовали работу: проблема AI alignment структурно идентична проблеме неполных контрактов. Когда ты нанимаешь подрядчика — контракт всегда неполный. Невозможно предусмотреть всё. Но хороший контракт фиксирует, что делать, когда что-то идёт не так. Кто решает спорные вопросы. Какие границы.
Промпт — это устная договорённость. «Ну ты понял, сделай нормально». Спека — подписанный контракт. Разница не в том, что написано. Разница в том, что происходит, когда всё пойдёт не по плану.
А оно пойдёт.