A complexidade de lidar com sistemas legados é um desafio comum a muitas organizações em crescimento. Além disso, a necessidade de padronizar e otimizar a documentação técnica torna-se cada vez mais urgente. Para uma das maiores empresas do setor industrial, desenvolvemos o Oráculo. Especificamente, criamos uma solução de IA generativa que analisa códigos-fonte complexos e automatiza a criação de documentação técnica.

A organização enfrentava um desafio comum a muitas corporações. Especificamente, lidava com múltiplos repositórios de código com documentação defasada ou inexistente. Como consequência, criou-se um ambiente de alto risco e baixa eficiência, com as seguintes dores principais:

• Conhecimento centralizado: dependência excessiva de desenvolvedores veteranos. Isso criava gargalos operacionais e aumentava riscos de perda de conhecimento crítico.
• Alto custo de manutenção: processos manuais consumiam tempo excessivo. Em outras palavras, recursos valiosos eram desviados da inovação.
• Barreiras para a inovação: a dificuldade em compreender sistemas legados tornava projetos mais lentos. Certamente, isso aumentava os riscos em novas iniciativas.
• Redundância de trabalho: a falta de documentação padronizada levava à duplicação de esforços. Diferentes equipes resolviam os mesmos problemas repetidamente.

O objetivo, então, era desenvolver uma solução para automatizar a geração de documentação técnica. Primeiramente, queríamos extrair informações do código-fonte. Em seguida, transformar o conhecimento técnico em um ativo dinâmico e acessível. Finalmente, preparar a organização para a nova era da IA.

Desenvolvemos e implementamos o Oráculo com integração a dados privados e criamos interações com modelos de linguagem avançados (LLM). A solução gera documentação automatizada que alimenta a Wiki do Azure. Convenientemente, esta já está na interface de gestão do time, facilitando consultas.

Além do mais, criamos uma interface conversacional tipo chat para os desenvolvedores. Através dela, eles podem conversar com a documentação e com os repositórios de código. É como se o time dialogasse com a aplicação. Por exemplo, podem perguntar onde determinada lógica está implementada. Como resultado, o onboarding do time e as manutenções tornaram-se muito mais eficientes.

O Oráculo oferece recursos abrangentes para transformar a gestão do conhecimento técnico:

• Geração automatizada de documentação: com um clique, o desenvolvedor aciona a documentação completa. Naturalmente, ela segue o padrão da empresa para todos os componentes.
• Visão abrangente dos componentes: o Oráculo documenta todos os elementos do sistema. Isso inclui backend, frontend e serviços de integração.
• Insights técnicos imediatos: os usuários podem questionar sobre tecnologias e estruturas. Assim, identificam o perfil ideal de desenvolvedor para cada projeto.
• Padronização e boas práticas: a ferramenta reforça a aderência a padrões estabelecidos.
• Informações detalhadas e acionáveis: fornece links para documentações oficiais e sistemas. Adicionalmente, inclui estruturas de pastas e camadas arquiteturais.
• Documentação completa: não se limita a texto. Na verdade, inclui diagramas arquiteturais e insights técnicos valiosos.

A implementação do Oráculo gerou ganhos qualitativos imediatos e mensuráveis. Como resultado, estabeleceu-se uma base sólida para a aceleração digital da companhia.

• Otimização de recursos e redução de custo operacional: liberamos horas de desenvolvedores sêniores de tarefas repetitivas. Consequentemente, seu tempo foi alocado em atividades de maior valor estratégico.
• Aceleração do desenvolvimento e onboarding: reduzimos drasticamente o tempo de compreensão da arquitetura. O período caiu de 1 mês para apenas 1 semana, representando uma redução de 75%.
• Elevação da qualidade e padronização: a automação garantiu documentação com padrão de excelência, eliminando ambiguidades e facilitando manutenções futuras.
• Mitigação de riscos operacionais: descentralizamos o conhecimento antes retido em poucos colaboradores. Dessa forma, fortalecemos a resiliência da operação.
• Comunicação e colaboração aprimoradas: a documentação padronizada otimiza a comunicação entre times. Além disso, facilita a movimentação de profissionais entre squads.
• Escalabilidade comprovada: seis softwares já foram documentados e validados. Enquanto isso, a empresa mapeia os próximos sistemas para a Wiki.

A IA generativa revoluciona a gestão de sistemas legados, transformando códigos complexos em documentação técnica padronizada e acessível. Soluções como o Oráculo desmistificam o conhecimento crítico, cortam custos de manutenção e reduzem drasticamente o tempo de onboarding de equipes (de 1 mês para apenas 1 semana), catalisando o desenvolvimento e a inovação em larga escala, e fortalecendo a eficiência operacional.