Cara, antes de tudo a ideia central de preparar o contexto antes de jogar no LLM é muito boa.

Só tomaria MUITO cuidado com a frase “comentários e docstrings são úteis pra humanos, mas pra IA são só ruído”.

Comentário óbvio é ruído; comentário errado é veneno; comentário bom é OURO (principalmente para LLMs).

Em código real especialmente sistema grande tem comentário que carrega a intenção que o código sozinho não mostra. No kernel Linux tem comentários desse tipo aos montes: regra de lifetime dizendo “depois dessa chamada não acesse mais esse objeto”; comentário de concorrência explicando uma race codition que faria uma thread dormir para sempre e um monte de coisa desse tipo.

Se remove esse tipo de comentário não é limpar ruído. É jogar fora a especificação do sistema.

No fim, o inimigo não é comentário. O inimigo é contexto irrelevante. E comentário bom é contexto relevante pra caramba.