Usar um assistente de IA no código é como ter um par técnico do lado. Ele não substitui sua análise, mas ajuda a pensar, revisar e melhorar.
A chave está no contexto e nos critérios claros.
- Sem isso, a IA devolve respostas genéricas.
- Com isso, ela vira uma parceira de engenharia.
A seguir, alguns prompts práticos para o dia a dia. No meu caso, testei usando o Augment, mas funcionam em qualquer assistente.
Prompts Práticos para Engenharia de Software
1. Revisão ao Terminar o Código
Ao finalizar um trecho, peça uma revisão estruturada que vá além da sintaxe.
“Analise este código. Quais problemas de lógica, performance ou legibilidade você vê e como devo corrigi-los agora? Gere diffs curtos. Classifique os pontos em alta, média e baixa prioridade.”
2. Refatoração Guiada
Peça mudanças específicas e seguras, evitando reescritas radicais.
“Proponha uma refatoração mínima e segura para reduzir complexidade e acoplamento neste trecho. Explique passo a passo o que mudar e por que, justificando o ganho.”
3. Design e Boas Práticas
Use a IA para validar se você está seguindo os padrões arquiteturais da sua equipe.
“Analise este código segundo boas práticas de design e arquitetura, como SOLID, Clean Code, DDD, legibilidade, acoplamento e coesão. Liste o que está bom e o que pode melhorar, com exemplos curtos.”
4. Testes (TDD/Unitários)
Melhore a cobertura e a eficácia dos seus testes.
“Verifique se há cenários de teste relevantes que estão faltando. Veja se há testes redundantes que podem ser removidos. Sugira casos de teste que realmente aumentem a confiabilidade da feature.”
5. Segurança e Confiabilidade
Peça uma auditoria de risco rápida, focada nos pontos mais sensíveis.
“Faça uma revisão de segurança neste endpoint. Cheque validação de entrada, timeouts, retries, idempotência e logs. Liste o que falta para a máxima confiabilidade.”
6. Performance
Use a IA para identificar gargalos antes que eles cheguem em produção.
“Avalie a complexidade e possíveis gargalos deste algoritmo. Sugira estruturas de dados e micro melhorias que tragam ganho real de performance.”
7. Documentação Rápida
Gere documentação inicial que ajude no onboarding da equipe.
“Escreva um README curto para este módulo. Inclua propósito, como rodar, dependências, contrato público, exemplos de uso e limitações conhecidas.”
Dica Final: O Segredo da Parceria
O segredo para dominar essa ferramenta é simples:
- Dê Contexto: Explique o problema de negócio e a arquitetura.
- Limite o Escopo: Aponte para o trecho exato de código (ou arquivo).
- Peça Critérios Claros: Use termos técnicos específicos (SOLID, alta prioridade, idempotência, ganho real).
Com isso, a IA deixa de gerar resultados genéricos e se estabelece como uma parceira de código, precisa, didática e segura