Um Fluxo de Trabalho de IA em Duas Etapas para Modernização de Código Legado

Uma postagem no Reddit no r/ClaudeAI argumenta contra simplesmente pedir à IA para 'refatorar' código legado espaguete, observando que a IA tende a preservar estruturas existentes defeituosas. Em vez disso, propõe um fluxo de trabalho de 'engenharia reversa' em duas etapas que aproveita o raciocínio de LLM de forma mais eficaz.
O Problema com a Refatoração Direta
Quando você cola código antigo em um agente de IA com um pedido como 'Por favor, refatore isso e deixe limpo', o resultado geralmente é apenas uma versão polida da mesma arquitetura ruim. A IA é influenciada pelo código que você fornece—ela tenta preservar sua estrutura, nomes de variáveis e fluxo lógico, mesmo que estivessem defeituosos desde o início.
O Processo de 'Engenharia Reversa' em Duas Etapas
Etapa 1: Extrair a Intenção (O 'O Que')
Não peça à IA para corrigir o código. Em vez disso, peça para ela ignorar a estrutura do código e extrair a lógica de negócios. Especificamente, faça-a escrever um Documento de Requisitos de Negócios (BRD) de alto nível baseado no arquivo. Isso produz a lógica pura sem a dívida técnica.
Etapa 2: A Construção 'Do Zero' (O 'Como')
Pegue esse BRD novo e alimente-o em um prompt de 'Arquiteto Mestre'. Agora, a IA não está corrigindo erros antigos; está construindo uma solução do zero usando as melhores práticas modernas. Essa abordagem também facilita a migração de tecnologia (por exemplo, de Java legado para Node.js moderno) porque a camada intermediária do BRD é independente de tecnologia.
A postagem menciona que o prompt específico de 'Arquiteto Mestre' usado para a Etapa 2 é fornecido no primeiro comentário do tópico do Reddit.
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also
Pare de Usar Claude Code Como AutoCompletar: Vitórias Reais de Refatoração Consciente do Repositório
Um desenvolvedor compartilha como tratar o Claude Code como um assistente de refatoração que conhece o repositório — não como um autocomplete — trouxe grandes vitórias ao rastrear arquitetura, desembaraçar arquivos e encontrar acoplamento oculto.

O limite de taxa não documentado do pool OAuth da Anthropic requer o prompt do sistema Claude Code
Ao usar tokens OAuth da Anthropic, a API direciona as solicitações para o pool de limite de taxa do Claude Code com base em se seu prompt do sistema se identifica como Claude Code. Adicionar 'Você é o Claude Code, o CLI oficial da Anthropic para Claude.' ao seu prompt do sistema resolve erros 429 misteriosos.

A maioria das pessoas usa Claude a 5% da sua capacidade – Veja como corrigir isso
Após 60+ horas testando prompts no Claude Opus 4.7, um usuário compartilha uma receita de 5 etapas: atribuir função, carregar contexto específico, definir restrições, formatar saída e adicionar função de forçagem.

A negação como instrução é fraca: em vez disso, descreva explicitamente o comportamento desejado
Uma análise do Reddit mostra que dizer ao Claude "não seja prolixo" ou "não moralize" mal funciona. Em vez disso, use instruções positivas como "responda em 1-2 frases" ou "me dê uma resposta direta, trate ressalvas como opcionais". Além disso, terminar com "obrigado!" aquece o tom.