Спецификация — документ, который описывает, что и как должно быть сделано в проекте: функции, сценарии, требования к дизайну и технике, критерии готовности. Её пишут до разработки, чтобы все участники одинаково понимали результат.
Спецификация снимает разночтения между заказчиком и исполнителем и служит основой для оценки сроков и бюджета. Если чего-то нет в спецификации, это не входит в работу — так проще управлять объёмом и избегать бесконечных правок.
Чем отличается от ТЗ и брифа
Бриф собирает цели и пожелания заказчика: что за бизнес, кому продаём, какой результат нужен. Спецификация переводит их в конкретные решения: какие страницы, что на каждой, как работает форма, куда уходит заявка. ТЗ — привычное в России название близкого документа; часто это одно и то же, просто спецификация обычно подробнее и живёт вместе с проектом.
Что входит в спецификацию сайта
- карта страниц и адреса;
- контент каждой страницы: блоки, заголовки, тексты, медиа;
- сценарии: что делает посетитель и что происходит в ответ;
- интеграции: CRM, аналитика, оплата, рассылки;
- требования к скорости, адаптиву, доступности, SEO и разметке;
- критерии готовности — по чему проверяют, что работа сделана.
Как работает в AI-разработке
С приходом нейросетей в разработку спецификация стала ещё важнее. AI-агент пишет код по описанию: чем точнее описание, тем меньше переделок. Подход, при котором проект ведут от спецификации к коду, называют Spec coding. Спецификацию хранят рядом с кодом в репозитории и обновляют, когда меняются решения. Тогда документ не устаревает после первой недели.
Что сделать на своём проекте
- Начните с брифа и ответьте на вопрос «какой результат нужен бизнесу».
- Опишите страницы и сценарии простыми словами.
- Для каждой функции запишите, как проверить, что она работает.
- Согласуйте документ с заказчиком до начала работ.
- Меняйте спецификацию раньше, чем код.
Частый вопрос
Нужна ли спецификация для лендинга? Да, короткая: структура блоков, тексты, форма, аналитика. Одна страница текста экономит недели правок. С этого начинается разработка лендинга.