Você levantou pontos realmente muito relavantes e importantes. Fico feliz que alguém tenha tido esse tipo de visão e concordo com absolutamente tudo que você disse.

O meu caso de fato foi uma situação mais "simples", na qual eu apenas tinha que escrever alguns documentos explicando o que cada coisa faz. De forma bruta mesmo!

Claro que esse processo de automatizar não elimina de forma alguma a necessidade de revisão e adapção da documentação. Mas encarei como uma forma de "comprar tempo" e conseguir focar no que era mais importante para mim no momento.

O script que eu fiz, como eu já comentei, é extremamente simples e bruto! Deixei open-source no github aberto para a comunidade de devs.

Coloquei o repositório no ar hoje! Fica a vontade para usar, melhorar ou compartilhar

Já deixa uma ⭐ no projeto!
https://github.com/jefferson-calmon/codocx

Obrigado pelo tempo lendo o post e escrevendo um artigo tão detalhado e completo 💪🏻