DocGen: Construindo um Assistente de IA para Analistas de Sistemas Sem Perder a Cabeça

Um desenvolvedor criou o DocGen, um assistente de IA para analistas de sistemas, que processa solicitações de stakeholders por meio de uma cadeia de sete agentes de LLM para produzir um rascunho de documentação de software. O sistema é dividido em duas cadeias independentes: a primeira lida com a avaliação de contexto e a geração de perguntas para entrevistas, e a segunda processa as respostas das entrevistas para produzir um documento. Entre as cadeias, há um fator humano, no qual os analistas conduzem as entrevistas. A arquitetura inclui o Agente 0 para avaliação da qualidade do contexto e recomendação de temperatura, o Agente 1 para geração de perguntas específicas para o stakeholder, o Agente 2 para normalização das respostas brutas em dados estruturados, o Agente 3 para geração do rascunho, o Agente 4 para validação e verificação de consistência, e o Agente 5 para formatação. Um loop de esclarecimento permite reexecutar o pipeline até três vezes se a validação encontrar problemas. O desenvolvedor adicionou um modo híbrido na versão 1.0.9, combinando geração de texto por LLM com geradores programáticos de PlantUML para diagramas arquiteturais e UML, garantindo validade de sintaxe. O sistema suporta oito tipos de documento, incluindo SRS, Arquitetura, Especificação de API, README, Plano de Teste e diagramas UML. O autor observa que o projeto levou cerca de uma semana de iterações e atualmente está em testes; ele vê a IA como um complemento, e não como um substituto, para analistas, pois a comunicação verbal e o julgamento humano continuam sendo importantes.