🎯 Бесцельная цель

Меня попросили ознакомиться со спецификацией стороннего сервиса на предмет возможности его использования в будущем. Открываю Confluence, читаю шапку: "Цель: доработка входных и выходных параметров".

Печаль... 😭

Я не знаю, что делает этот сервис. Не понимаю, какую бизнес-задачу он решает для потребителей. Понимаю только, что это уже не первая итерация, раз что-то дорабатывается, но вот что и зачем?

Любые параметры можно переделывать бесконечно: сделать их красивее, привести к snake_case, перенести на другой уровень вложенности. Но зачем? Как мы поймём, что доработка успешна, если критерий успеха состоит в самом факте изменения?

💡И вот тут есть отличный маркер понятности текста. Хорошо настроенный ИИ в агентном режиме при генерации черновика спецификации почти наверняка потребует контекст. Он спросит: какую проблему пользователя мы решаем? На основе вашего ответа (а скорее всего, серии вопросов-ответов) модель сама предложит осмысленную бизнес-цель ("ускорить поиск", "снизить количество ошибок валидации") и только потом опишет необходимые технические изменения в контракте.

Опять же, если LLM сформулирует не ту цель или что-то выдумает, это сразу бросится в глаза и позволит вовремя скорректировать текст. А значит, при прочтении пользователь документации всё поймёт и не напишет пост на эту тему в своём телеграм-канале. 😅

Друзья, надеюсь, теперь понятно, почему первым пунктом в шаблоне спецификации должен идти раздел с описанием боли пользователя, а не список полей будущего JSON.

#ai #интеграции #сервисы #кейсы