/// На деле вообще не так. В среднем продукте на рынке миллионы строк кода. Документирования логики и алгоритмов ни разу не видел. В норме работа кода понятна из UI, API, архитектуры и имен функций и дополнительно стабилизируется тестами. Пока из кода нельзя понять что и как он делает, такой код не пройдет ревью. Разобраться в тысячах строк чужого самодокументированного кода и внести доработки, это собственно и была ежедневная работа программистов. ///

Это уважаемый, Ваше чисто субъективное мнение с позиции типичного "кодера", а не как профессионального разработчика ПО. Поясню.

Во первых, вот уже как полвека, разработка серьезного ПО соотносится 1в1 с разработкой технического изделия, повторяет все его жизненные циклы. Непосредственная разработка (создание) программного кода одна из операций этого процесса и работа программиста соответствует функциям технолога по разработке технологии изготовления конкретной детали (то есть разработка алгоритма модуля, процедуры) и изготовлению ее рабочим на станке (написание кода этого модуля, процедуры на ЯП). В конечном итоге от правильно спроектированного ПО и надёжности программного кода зависит успех всего софт продукта. Как и техническое изделие, программный продукт может дорабатываться, совершенствоваться и поддерживаться достаточно долго во времени отчасти уже другими людьми не первоначально его создававшими. Другой рабочий по взятой из архива документированной технологии быстро изготовит новую деталь. А программист чтобы доработать конкретный модуль (процедуру), должен сначала потратить время чтобы разобраться и понять созданный его предшественником НЕ ДОКУМЕНТИРОВАННЫЙ программный код, чтобы корректно внести изменения. А если программная система содержит, как Вы говорите миллионы (хватит даже и десятков тысяч) строк на ЯП ? Поэтому документирование (! не путать с пояснениями функций отдельных операторов ЯП) программного модуля, включающее сам алгоритм и выделение его фрагментов в тексте, является необходимым и обязательным требованием профессиональной разработки ПО. Если Вы, как разработчик, работаете и создание свой продукт индивидуально, то можете делать это как считаете нужным. Но, согласитесь, что через полгода, вам придется разбираться и вспоминать что вы сами там написали.

Во вторых, созданный, а точнее автоматический сгенерированный программный код не соответствует стандартам принятым в организации. Например, конкретная процедура обязана в самом начале своей работы проверять корректность входных параметров на соответствие алгоритму и выдавать соответствующее сообщение вызывающей процедуре и заносить его в log-журнал (стек) системных вызовов для облегчения тестирования и обнаружения ошибок. Будет ли делать подобную работу автогенератор ? Сомневаюсь.

Тут ещё что важно отметить: КАК автоматом (AI-агентом) генерируется программный код ? Берет ли он уже готовый из своей БД на этом же ЯП или переписывает с него на требуемый ЯП, либо аналогично программисту "продумывает" алгоритм и согласно его логике генерирует операторы конкретного ЯП. Отсюда и можно будет сделать вывод: понимает ли автомат смысл созданного им кода и, соответственно, способен ли его как человек документировать.

В заключении. Было бы намного нужнее и полезнее, если бы автомат (AI, ИИ) был способен протестировать и верифицировать на надёжность программный код разработанный самим программистом и пояснить выявленные в нем недостатки.