Como Parar de Chutar e Começar a Entender Seu Parceiro de IA

Recentemente me peguei pensando: passo mais tempo com o GitHub Copilot e o Cursor do que com meus próprios colegas de equipe. Trocamos prompts constantemente, ele escreve código para mim, eu corrijo. Mas se alguém me perguntar quão efetivamente estou usando, não conseguirei dar uma resposta clara. "Bom, parece ajudar" — não exatamente uma métrica sólida para um engenheiro.

Parece que a Microsoft fez a mesma pergunta a si mesma. Um grupo de funcionários open-sourceou o AI Engineering Coach. É uma ferramenta que olha para seus logs locais de interação com IA e os transforma em um painel de analytics. Nenhum dado enviado para a nuvem, apenas análise post-mortem local.

O que é isso afinal

O projeto é uma extensão do VS Code (ou canvas para o app do GitHub Copilot) que analisa suas sessões. Ele não apenas conta o número de requisições — tenta avaliar a qualidade da sua interação com a rede neural.

A ferramenta é útil para quem se sente preso no nível de "me escreva uma função para validação de email" e quer tirar o máximo proveito dos agentes de IA. Ela destaca anti-patterns, encontra habilidades recorrentes e até constrói um mapa do contexto do seu projeto.

Cinco coisas que me chamaram a atenção

Detector de anti-patterns

O repositório tem cerca de 45 regras embutidas que verificam a higiene das suas sessões. Por exemplo, se você está sobrecarregando a IA com prompts muito longos e confusos ou esquecendo de limpar o contexto, o "coach" vai perceber. Ele mostrará um card com a descrição do problema e, mais importante, sugerirá ações específicas para corrigir.

Localizador de habilidades ocultas

Frequentemente escrevemos as mesmas instruções em diferentes chats. O Skill Finder analisa essas repetições e sugere transformá-las em habilidades reutilizáveis. Isso ajuda a formalizar seu estilo pessoal de codificação.

Análise de contexto

Esta é provavelmente a parte mais útil para trabalhar com projetos complexos. A ferramenta avalia a Context Health — quão bem a IA entende a estrutura do seu workspace. Ela verifica arquivos de instrução e a prontidão do projeto para trabalhar com agentes.

Visualização de atividade

Lá dentro há timelines no estilo Gantt. Você pode ver a que horas do dia mais frequentemente recorre ao assistente e em quais projetos trabalha mais intensamente. Há até um heatmap de atividade 24/7.

Gamificação do aprendizado

Os desenvolvedores adicionaram um sistema de conquistas e níveis (do bronze ao diamante). Há até uma seção Learning Center que gera quizzes baseados no seu código real e logs. Parece um jeito de transformar rotina em level up de personagem.

Como executar

Há um porém aqui: a extensão não está no marketplace oficial. A Microsoft posiciona isso como um experimento da comunidade, então você terá que compilar o arquivo você mesmo.

Se você tem o Node.js instalado, o processo é assim:

git clone https://github.com/microsoft/ai-engineering-coach.git
cd ai-engineering-coach
npm ci
npm run package

Depois disso, um arquivo de extensão aparecerá na pasta. Você pode instalá-lo via console:

code --install-extension ai-engineer-coach-*.vsix

Ou simplesmente arraste-o para a janela do VS Code. Após a instalação, chame a paleta de comandos (Ctrl+Shift+P) e procure por AI Engineer Coach: Open Dashboard.

Por que vale a pena tentar

A principal vantagem é a privacidade. Toda a análise acontece localmente na sua máquina. A extensão funciona no modo somente leitura e não envia nada "para casa." Ela usa as APIs de modelo integradas do VS Code apenas quando você mesmo pressiona o botão "analisar".

A ferramenta é específica. Ela não escreverá código para você, mas fará você pensar: "Será que estou alimentando o modelo com muita sujeira?" Para quem quer passar do chat simples para um Agentic SDLC consciente, este é um ótimo ponto de entrada.

Especialmente recomendo conferir a seção Coding Moments. É uma galeria de screenshots das suas sessões que permite literalmente navegar pelo seu histórico de desenvolvimento e entender em que ponto algo deu errado.

Para quem é

O projeto definitivamente vai agradar quem ama números e quer otimizar seus fluxos de trabalho. Se você sente que o Copilot às vezes trava, talvez o problema não seja com o modelo, mas com como você atribui tarefas a ele. Esse "coach" ajuda a encontrar esses gargalos.

O único ponto negativo é a necessidade de compilação manual, mas para um desenvolvedor isso provavelmente não será uma barreira. Além disso, lá dentro você encontrará um Rule Editor onde pode escrever suas próprias regras de análise em Markdown e testá-las diretamente nos seus dados. Um construtor para quem gosta de personalizar ferramentas para si mesmo.