Перейти к тексту

Шаблон спецификации ​

Опишите входные данные, ожидаемый результат и ошибки. Gherkin ниже помогает согласовать сценарии; в учебном стенде он не запускается автоматически, тесты пишутся отдельно.

md
# Спецификация: <функция>

## Задача пользователя
Что он хочет сделать и какой результат получит?

## Данные
Поля, типы, обязательность, допустимые значения:
Поведение для пустых и некорректных данных:

## Ограничения
Правила продукта:
Доступ и работа с личными данными:
Что в эту функцию не входит:

## Сценарии
```gherkin
# language: ru
Функция: <название>
  Сценарий: Допустимые данные
    Допустим <конкретный вход>
    Когда <действие>
    Тогда <наблюдаемый результат>

  Сценарий: Граничное значение
    Допустим <значение на границе>
    Когда <действие>
    Тогда <точный результат>

  Сценарий: Отказ
    Допустим <некорректный вход или недоступный ресурс>
    Когда <действие>
    Тогда <ошибка и состояние после отказа>
```

## Проверка
Соответствующие тесты:
Что принимает человек:

## Открытые вопросы
Вопрос, владелец решения, можно ли начать работу до ответа:

Хендбук по Agentic Engineering