ArchAngel: o assistente de coding que ensina seus devs juniores enquanto eles escrevem código
TL;DR: O ArchAngel é um assistente de IA educacional que funciona dentro da IDE (VSCode, via LSP) para ensinar boas práticas de engenharia enquanto o dev escreve código — antes do commit. Baseado em Semantic Kernel e Microsoft Agent Framework, ele usa 'golden repositories' como fonte de verdade. Para empresas brasileiras, isso significa reduzir a carga de seniors e acelerar o onboarding de juniores com feedback contextualizado, sem abrir mão do aprendizado.
A IA está transformando o ciclo de desenvolvimento (SDLC) em velocidade impressionante. Mas isso levanta uma questão silenciosa: se o código está sendo escrito para seus desenvolvedores juniores — ou por eles com ajuda de copilots — quando é que eles aprendem as habilidades para se tornarem seniors? A maioria das ferramentas tenta resolver isso detectando problemas após o commit. O momento do aprendizado já passou. E se seus desenvolvedores pudessem aprender por que algo está errado e como corrigir, enquanto escrevem?
O ArchAngel nasce de uma ideia simples: transformar as melhores práticas de engenharia do seu time em um mentor que vive dentro da IDE e guia cada desenvolvedor a cada novo hire, a cada sprint, a cada repositório. O GitHub Copilot já demonstrou enorme valor ao reduzir o trabalho repetitivo (toil), liberando tempo para decisões de design de mais alto nível. Com a evolução para workflows mais agenticos, o poder de gerar e iterar código cresce ainda mais.
O próximo desafio para times de engenharia não é adoção. É como extrair o máximo dessas capacidades mantendo padrões de engenharia sólidos, consistência e entendimento compartilhado entre times. Mesmo com ferramentas poderosas, os desafios persistem: padrões espalhados por repositórios, documentação e conversas; boas práticas que evoluem mas são difíceis de descobrir e aplicar consistentemente; code reviews repetitivos; seniors perdendo tempo reforçando padrões em vez de focar em design de sistemas.
A IA acelera o desenvolvimento, mas não entende automaticamente como seu time constrói software — as decisões arquiteturais, trade-offs e convenções que mantêm os sistemas consistentes ao longo do tempo. Código tecnicamente correto não significa que está alinhado organizacionalmente.
A Solução: como o ArchAngel ensina dentro da IDE?
O ArchAngel é um assistente de IA construído por e para desenvolvedores. Em vez de esperar o commit para apontar problemas, ele acompanha o processo de coding, fornecendo feedback iterativo e ao vivo. Conectado aos seus 'golden repositories' — as práticas acordadas, repositórios aprovados e padrões organizacionais — ele também pode gerar documentos de estilo de código e wikis para consulta rápida.
A stack técnica é composta por:
- Semantic Kernel e Microsoft Agent Framework (MAF): O Semantic Kernel é um kit de desenvolvimento leve e open-source para construir agentes de IA. O MAF orquestra agentes e histórico de conversas para suportar design iterativo. Tudo servido via Foundry.
- Language Server Protocol (LSP): Permite invocar o ArchAngel de qualquer IDE. No VSCode, a command palette é usada para funcionalidades como geração de documentos.
- SQLite: Armazena a base de busca local.
- Config: Configuração similar a outras ferramentas de dev. No VSCode, carregue os repositórios base no
archangel.json, autentique com GitHub e execute "Index from config file" na command palette.
Conheça Priya (Senior) e Joe (Junior)
Priya: Arquiteta sistemas escaláveis, lidera code reviews, aplica boas práticas de CI/CD, testing e observability, mentoriza juniores e colabora com Product e Design. Joe: Escreve código limpo sob orientação, aprende a codebase e tech stack, participa de code reviews, colabora com o time e investe em crescimento pessoal.
Um dia na vida: Priya é responsável por Joe e mais dois juniores. Revisar cada PR para identificar antipadrões arquiteturais e más decisões de documentação — que fogem das melhores práticas — toma um tempo precioso que ela poderia usar no trabalho de senior que realmente agrega valor.
Entra o ArchAngel: Um novo hire entra 4 meses depois do início do projeto, sem ideia de quais repositórios usar como exemplo. O time usou o ArchAngel para gerar documentos de estilo de código e wiki. Os repositórios 'golden' estão linkados no config file. O junior clona, indexa e começa a codar. O ArchAngel, dentro do VSCode, fornece feedback educacional antes de qualquer commit. Chat informado pelo repositório, code completions e documentação tornam o onboarding, aprendizado e orientação uma tarefa assíncrona. Priya ganha fôlego, e a qualidade dos PRs dos juniores melhora drasticamente.
Além disso, o feedback construtivo e contextualizado do ArchAngel ensina o próprio processo de PR: o junior aprende a identificar os mesmos padrões que o assistente monitora, desenvolvendo julgamento técnico.
Arquitetura de Exemplo
- Project Repo: O repositório do projeto, onde o time sincroniza arquivos de configuração.
- Cloud Environment: Onde o poder de processamento do ArchAngel reside. Segurança, escala, monitoramento e governança com a plataforma Azure.
- User Environment: Onde o time codifica, constrói e cria o software que move o negócio.
- Golden Repos: A base de conhecimento ouro — fonte indexada dos padrões de coding, princípios norteadores e codebases que o time busca como referência de qualidade.
Como customizar o ArchAngel para sua realidade?
- VNETs (Virtual Networks): Permitem configurações de rede seguras no ambiente cloud, garantindo comunicação em canais seguros entre recursos e ferramentas.
- Microsoft Foundry: Use o conjunto completo de ferramentas do Foundry para customizar e adequar o ArchAngel à sua organização.
- API Management (AI Gateway): Use AI Gateway e APIM para proteger, escalar, monitorar e governar seus agentes e conexões com o Foundry.
- LSP: Adicione eventos e handlers customizados através dos canais LSP entre IDEs.
- Customizable Document Generation: Refine os prompts usados para criar documentos e formate como desejar. A versão base é um documento resumido com alguns snippets como fonte, projetado para ser facilmente extensível.
O repositório do GitHub está disponível em: rohitmadhavk/ArchAngel
Perguntas Frequentes
-
O ArchAngel substitui a revisão de código feita por seniors?
Não. Ele funciona como um mentor adicional dentro da IDE, fornecendo feedback educacional antes do commit. O objetivo é reduzir a carga de seniors ao diminuir correções repetitivas em code review, liberando tempo para decisões de arquitetura e design. -
Quais linguagens e IDEs o ArchAngel suporta?
Graças ao suporte ao Language Server Protocol (LSP), o ArchAngel pode ser invocado de qualquer IDE compatível. No VSCode, usa-se a command palette para funcionalidades como geração de documentos. -
Como o ArchAngel aprende as práticas do meu time?
A ferramenta é configurada apontando para 'golden repositories' — repositórios aprovados que representam as melhores práticas, padrões e convenções do time. O ArchAngel indexa esses repositórios e os usa como base para o feedback. -
Onde o ArchAngel é executado (nuvem ou local)?
A base de conhecimento local (indexação) fica armazenada em SQLite no ambiente do desenvolvedor. O processamento de IA e orquestração dos agentes ocorre no Azure, via Microsoft Foundry, garantindo escalabilidade e governança. -
Posso usar o ArchAngel com outros provedores de nuvem além do Azure?
O artigo descreve o ArchAngel integrado ao ecossistema Azure (Foundry, APIM, VNETs). Embora o LSP torne a ferramenta agnóstica de IDE, a camada de IA e orquestração é projetada para o Azure. Adaptações para outros clouds exigiriam customização.
Artigo originalmente publicado em Azure Updates - Latest from Azure Charts.
