Então entrei nesse buraco de coelho e é impressionante o quanto eu sabia pouco sobre práticas e frameworks de documentação, e tudo isso nunca é mencionado em documentos reais ou algo que você verá em grandes cursos. arc42, modelagem C4, Diátaxis são abordagens que nunca vi pessoas praticando explicitamente. a maioria dos códigos que vi tinha documentação muito ad-hoc construída como um pensamento tardio ou, como outro lado do espectro, foi completamente simplificada e abstraída por redatores técnicos experientes, tornando impossível compreender a complexidade do produto por trás da superfície. Dito isso, agora estou trabalhando na própria ferramenta de documentação agente, que deve aplicar algumas dessas ferramentas na prática, manter documentos consistentes para bases de código de alta velocidade e ser compatível com qualquer tipo de fluxo de trabalho de desenvolvimento, com possibilidades de processar repositórios inteiros do zero e mantê-los depois, processando git diffs de origem arbitrária.