Template de prompt
Um prompt para refatorar sem perder o comportamento existente.
Este template substitui “limpe este código” por uma tarefa delimitada. Ele registra contrato de comportamento, escopo, testes e interfaces que precisam permanecer estáveis antes de mudar a estrutura da implementação.
Revisado em 22 de setembro de 2026 · Os templates e exemplos usam dados fictícios.
Quando usar este prompt de refatoração
Use-o quando o objetivo for estrutural: extrair responsabilidades, reduzir duplicação, isolar uma dependência, simplificar ramificações ou facilitar testes. Se a tarefa mudar comportamento visível, corrigir um defeito ou substituir uma API, descreva isso como uma implementação separada.
Uma refatoração segura precisa de limite e âncora comportamental. Testes existentes são evidências úteis, mas podem estar incompletos. Crie verificações de caracterização para comportamentos importantes ainda não cobertos.
Template reutilizável
Prompt para refatoração segura
# Refatore {{componente}}
## Objetivo
Melhore {{componente}} no projeto {{projeto}} para {{objetivo_refatoracao}}.
## Contrato de comportamento
{{contrato_comportamento}}
## Escopo e restrições
- Arquivos ou limite em escopo: {{escopo}}
- Testes e validações existentes: {{testes}}
- Interfaces, comportamentos e dependências que não podem mudar: {{restricoes}}
<instructions>
Inspecione as responsabilidades atuais e os consumidores afetados antes de alterar o código. Mantenha a refatoração delimitada e preserve o contrato de comportamento informado. Não combine correções de bugs, mudanças de API pública, atualizações de dependências ou alterações de formatação não relacionadas.
Se as evidências disponíveis não comprovarem a preservação do comportamento, pare e identifique o teste de caracterização ou a verificação ausente. Prefira etapas pequenas e revisáveis, com um ponto de validação reversível após cada etapa.
</instructions>
<output_format>
1. Responsabilidades e acoplamentos atuais
2. Etapas propostas de refatoração
3. Riscos à preservação do comportamento
4. Testes de caracterização e regressão necessários
5. Implementação ou patch, seguido pelos resultados da validação
</output_format>Defina o contrato antes da mudança
{{objetivo_refatoracao}}
A melhoria estrutural: extrair, separar, deduplicar, simplificar ou isolar.
{{contrato_comportamento}}
Saídas, erros, efeitos, eventos, acessibilidade, tempo ou compatibilidade que ficam estáveis.
{{escopo}}
O menor conjunto útil de arquivos, componentes ou caminhos que pode mudar.
{{testes}}
Verificações existentes e comandos exatos usados para validar o comportamento atual.
Exemplo: isolar a persistência de sessão
Componente: Middleware de autenticação e consultas ao banco.
Objetivo: Extrair a persistência de sessão para uma interface de repositório.
Contrato: Preservar decisões de autorização, códigos públicos de erro, renovação de cookie e revogação.
Escopo: Middleware, novo módulo e testes relacionados. Sem alteração de schema ou dependências.
Validação: Suíte de integração e testes de caracterização para expiração e revogação.
O agente pode mapear consumidores, propor etapas pequenas e parar caso a revogação não esteja coberta. Ele não deve redesenhar a autenticação silenciosamente.
Uma sequência revisável
- Mapeie responsabilidades. Identifique consumidores, efeitos e contratos públicos.
- Estabeleça a âncora. Execute verificações atuais e cubra comportamentos ausentes.
- Mude uma fronteira. Mantenha cada etapa pequena e reversível.
- Valide após cada etapa. Compare comportamento, não apenas tipos e compilação.
- Revise o escopo. Separe correções e atualizações não relacionadas.
O que este prompt não garante
O agente não preserva comportamento que não consegue observar ou inferir. Consumidores ocultos, testes incompletos, configuração de runtime e efeitos não documentados continuam sendo riscos. Use verificações de integração ou ponta a ponta quando necessário.