Бесплатный разбор
Сайты и SEO

ТЗ программисту: как описать задачу, чтобы её приняли

Какие блоки нужны в ТЗ на доработку сайта, как писать критерии приёмки, чем сценарий отличается от пожелания и почему «сделать красиво» не работает. С шаблоном карточки задачи и промптами.

Коротко. Задача готова, когда её можно проверить. В ТЗ нужны контекст, цель, сценарий, критерии приёмки, ограничения и примеры. «Сделать красиво» и «как у конкурента» проверять нельзя.

Как читать материал. Соберите карточку задачи, добавьте примеры и проверьте, что каждый пункт можно протестировать. Нейросеть помогает переписать, но критерии приёмки утверждает человек.

Почему ТЗ разваливается

  • нет цели, есть только «хочу»;
  • нет сценария;
  • критерии звучат как пожелания;
  • нет примеров;
  • несколько задач в одной.

Разработчик делает то, что понял. Если понял не то, виновато ТЗ.

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

Блоки ТЗ

Блок Что писать
Контекст что за страница и зачем нужна
Цель что должно измениться для пользователя
Сценарий шаги: открыл, нажал, увидел
Критерии как проверить, что готово
Ограничения сроки, технологии, устройства
Примеры ссылки и скриншоты

Критерии приёмки

Плохо: «форма должна работать».

Хорошо:

  • форма отправляется с телефона;
  • письмо приходит на почту;
  • в аналитике фиксируется цель;
  • при ошибке видно сообщение.

Каждый пункт можно проверить руками. Это и есть критерий.

Ограничения

  • браузеры и устройства;
  • скорость;
  • доступность;
  • SEO-требования: canonical, редиректы, разметка;
  • что нельзя менять.

Если ограничений нет, разработчик выберет удобное ему решение.

Классический путь. Напишите карточку и проверьте каждый критерий вручную.

С нейросетью. Попросите превратить пожелание в проверяемые пункты.

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

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

Частые ошибки

  • Несколько задач в одной.
  • Критерии «красиво» и «удобно».
  • Нет примеров.
  • Нет ограничений.
  • Нет тестовой среды для проверки.
  • Приёмка «на глаз».

Влияет ли это на SEO

ТЗ может защитить SEO-требования: редиректы, canonical, разметку, скорость. Если их не указать, при доработке их легко сломать.

Отдельно фиксируйте, какие URL и метатеги менять нельзя.

Где помогает нейросеть

Задача Что делает модель Что проверять руками
Критерии превращает пожелания в пункты проверяемость
Сценарии расписывает шаги реальность
Формулировки сокращает смысл
Проверка находит пробелы факты

Вопросы

Чем ТЗ отличается от брифа?

Бриф — контекст и цель. ТЗ — требования и критерии приёмки.

Сколько критериев нужно?

Столько, сколько нужно для проверки. Обычно 3–7.

Можно ли приложить скриншот?

Да, как пример. Но критерии всё равно нужны текстом.

Может ли нейросеть написать ТЗ?

Она помогает структурировать, но технические решения и приёмка — за людьми.

Связанные материалы

Источники

Официальные документы 2

Разбор проекта

Разберём сайт и спрос

Посмотрим сайт и спрос, скажем, что исправить первым. 20–30 минут в Zoom, Telegram или по телефону. Бесплатно и без обязательств.

Разобрать проектВсе материалы →