Arquitetura como código: como os LLMs aceleram o projeto de sistemas

A documentação de arquitetura em grandes empresas quase sempre é uma dor de cabeça. Semanas de aprovações, edições intermináveis de diagramas no Draw.io e um versionamento via Confluence que lembra mais uma escavação arqueológica do que um processo de engenharia. O departamento de IA do grupo de empresas BCS decidiu que era hora de acabar com isso e mostrou como a abordagem Architecture as Code, combinada com assistentes LLM, pode mudar radicalmente as regras do jogo.

Aleksey Pronsky, responsável pela arquitetura na divisão de IA da BCS, descreveu um problema conhecido de todo arquiteto corporativo. Sua equipe constrói sistemas agênticos, assistentes de IA, soluções de OCR, análise de fala e modelos clássicos de ML. Por trás de cada projeto há uma decisão de arquitetura: um documento que precisa passar por uma aprovação em várias etapas com o negócio, a arquitetura corporativa, a área de segurança da informação e os responsáveis por sistemas adjacentes. Em média, o caminho entre o recebimento dos requisitos de negócio e a aprovação final leva de duas a três semanas. Para um setor em que a velocidade de iteração define a competitividade, é tempo demais.

O cerne da abordagem proposta é tirar a documentação de arquitetura dos editores visuais e dos wikis e levá-la para o código. A equipe da BCS escolheu o Structurizr, ferramenta que permite descrever a arquitetura de sistemas de software em uma DSL própria. Em vez de arrastar blocos manualmente pela tela do Draw.io, o arquiteto descreve componentes, relações e contextos em texto. Isso traz todos os benefícios que os desenvolvedores já têm com Infrastructure as Code: versionamento via Git, code review, geração automática de diagramas e, o ponto crítico, a possibilidade de conectar um assistente LLM.

É aqui que a coisa fica interessante. Pronsky mostra como o Claude Code, no papel de assistente LLM, consegue assumir boa parte do trabalho rotineiro do arquiteto. Quando a arquitetura está descrita em código e não em imagens, o modelo de linguagem pode analisar a estrutura existente, propor mudanças, gerar novos componentes e até ajudar a preparar a documentação para aprovação. No fundo, acontece o mesmo que ocorreu com a programação no último ano: os assistentes LLM não substituem o especialista, mas multiplicam a velocidade do trabalho ao tirar a rotina de cima dele.

É importante entender o contexto em que essa prática surgiu. Architecture as Code não é uma ideia nova. Ferramentas como Structurizr, PlantUML e Mermaid existem há bastante tempo. Mas, antes dos modelos de linguagem potentes, descrever a arquitetura em texto era uma abordagem de nicho: a barreira de entrada era alta, e o ganho em relação aos editores visuais não era óbvio. Os LLMs mudaram essa equação. Um modelo que lida com texto e código com fluência transforma Architecture as Code de uma prática elegante, porém trabalhosa, em um fluxo de trabalho realmente eficiente. O arquiteto formula os requisitos, o assistente gera um rascunho na DSL, a pessoa revisa e corrige, e o ciclo encolhe de semanas para dias.

No ambiente enterprise, a abordagem traz vantagens adicionais. Quando a arquitetura vive em um repositório Git, cada mudança é transparente e rastreável. O code review de decisões de arquitetura se torna um processo tão natural quanto a revisão de código de software. A área de segurança pode automatizar parte das verificações. E, acima de tudo, diminui a dependência de uma ferramenta de visualização específica. Os diagramas são gerados automaticamente a partir do código e podem ser renderizados em qualquer renderizador compatível.

A experiência da BCS é reveladora também porque não se trata de uma startup testando novas abordagens, mas de um grande grupo financeiro com exigências rígidas de documentação e aprovação. Se Architecture as Code com apoio de LLM funciona em um contexto tão regulado, a abordagem é madura o bastante para uso corporativo amplo. O mais provável é que, no próximo ano, vejamos uma onda de implantações semelhantes, principalmente em empresas que já usam assistentes LLM no desenvolvimento e querem estender a prática a disciplinas de engenharia afins.