ДРАКОН-схемы хорошо передают логику работы сценария, но не подходят для подробного описания элементов. Так ответ бота может содержать несколько вариантов реплик, специфичную разметку, TTS и прочие нюансы. Уместить всё это в маленьком блоке на схеме невозможно.

Другая проблема — учёт изменений. Сообщения в мессенджерах теряются, а разноцветные стикеры засоряют схему. Мелкие правки так и вовсе могут остаться назамеченными — можно добавить в интент пару новых примеров и забыть сообщить об этом в чате.

Обе эти проблемы решает спецификация — текстовый документ, подробно описывающий сценарий.

Почему нельзя прятать детали

Поддерживать несколько источников информации об одном и том же сценарии неудобно. Логичным решением кажется спрятать всю информацию внутрь схемы. Тем более, что в Miro и других подобных редакторах есть для этого подходящий инструмент — раскрывающиеся карточки. Но дьявол кроется в деталях.

Во время тестирования QA сверяет правильность ответа бота с документацией. И далеко не всегда очевидно, к какому промпту находится нужная реплика. Ctrl+F здесь не поможет — придётся открывать каждую карточку вручную.

Кроме того, у проверяющего может не быть доступа к схеме. Если экспортировать её в PDF, то заглянуть внутрь карточки не получится.

Как выглядит спецификация

Для интентов

Для промптов

| Интент | Промпт | Текст | TTS | Дальнейшие действия |
|—|—|—|—|—|