AI легко перескажет, что делает функция: прочитает код, соберёт README, нарисует схему. Такая документация перестаёт быть дефицитом.
Дефицитом остаётся другое: почему при повторной оплате мы выбрали отмену операции, а не повторную попытку. В коде этого не видно, а восстановить через полгода почти невозможно.
Похоже, ценность документации сместится от описания системы к следам решений, которые система не умеет объяснить сама.