Документации для ИИ всегда мало

Результаты эксперемента. Итак, проблемы начались уже на старте. В требованиях было указано использовать Kerberos-аутентификацию. Для разработчика системы тут всё более чем понятно. А вот агенту — нет.

При этом никаких уточняющих вопросов он не задал и вместо этого нагенерировал приличное количество кода для решения задачи. В противовес: у программистов эта часть обычно переиспользуется, занимает пару строк кода и легко понимается даже новичками, которые просто заглядывают в репозиторий. Правда, у агента доступа к нему, естественно, не было.

Дальше выяснилось, что описания данных и ER-диаграммы (ну или их вариации) агенту тоже недостаточно. Он вообще невдуплил откуда взять данные и куда их положить.

А дальше уже сдалась я. Поскольку программист из меня всё-таки так себе, решила больше не вайбкодить. Стало очевидно, что мы уверенно движемся куда-то не туда.

Зачем я вообще это делала?

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

Сейчас же у меня ровно противоположное ощущение.

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