Хорошая спецификация упрощает проверку изменения. Начните с поведения, которое должен увидеть человек, затем свяжите его с реализацией и проверками.
Описать конкретный запуск сценария
Запишите действие пользователя и ожидаемый результат. Добавьте текущее поведение, чтобы было понятно, что меняется. Оставляйте неизвестные допущения заметными до появления подтверждений.
Сохранить фокус изменения
Найдите минимальный набор файлов, который отвечает за поведение. Сначала используйте существующие подходы проекта. Небольшой diff помогает связать каждую правку с запрошенным результатом.
Проверить значимую границу
Выберите проверки, способные найти реальную регрессию: отказ в доступе, несоответствие языка, прерванный внешний вызов или повторную операцию. Тест не должен просто пересказывать реализацию другими словами.
Зафиксировать наблюдения
Укажите, что запускалось, что прошло и что ещё не проверено. Локальная проверка браузера, сборка контейнера и рабочая интеграция подтверждают разные вещи. Разделяйте эти выводы при передаче результата.
Оставить полезный следующий шаг
Поддерживайте документацию в соответствии с поведением системы. Если внешнее действие требует согласования, подготовьте результат, который можно проверить. Спецификация приносит пользу, пока связана с работой, которую люди действительно рассматривают.