Refatorando código legado com cursor (testes primeiro, coragem depois)
Um módulo de 600 linhas sem testes atendeu ao Cursor. O fluxo de trabalho que o refatorou sem interromper a produção tinha menos a ver com IA e mais com sequenciamento.
O módulo tinha 600 linhas, dez anos, suportava carga e foi testado apenas pelo tráfego de produção. O Cursor refatorou bem, mas a IA foi talvez um terço da história. Os outros dois terços eram o sequenciamento: testes, limites e recusa em deixar o agente se mover rapidamente.
O primeiro passo são os testes de caracterização, e o Cursor é realmente bom em ajudar a escrevê-los. Pedi para ler o módulo e listar todos os comportamentos observáveis: entradas, saídas, casos extremos, caminhos de erro. Em seguida, gerar testes que afirmem o comportamento atual, incluindo as coisas estranhas, explicitamente rotuladas como 'caracterização: afirma o comportamento atual, não a correção'. Esses testes são a rede de segurança que torna tudo possível.
O segundo passo são os limites antes da cirurgia. Fiz o Cursor extrair funções puras primeiro (análise, cálculo, formatação) sem alterar nenhum comportamento, cada extração verificada em verde. Só então começou a refatoração real, função por função, com a instrução que mais importa: 'mudar uma coisa por passagem, executar os testes, parar'. Agentes que refatoram ousadamente reescrevem com confiança e quebram sutilmente. Pequenos passes com verificação entre eles são como você mantém o controle.
A etapa que ninguém espera que importe: fiz o Cursor explicar cada alteração em uma frase antes de aplicá-la. As explicações capturaram duas coisas que os testes não detectaram: uma mutação de um objeto compartilhado que apenas bitia sob simultaneidade e uma reordenação de operações que era segura no fuso horário dos testes e não no fuso horário da produção. Ler o raciocínio de uma frase leva dez segundos por mudança e pegar o que as redes perderam.
Contagem final: o módulo agora tem 300 linhas com estrutura que um novo contratado pode ler, comportamento idêntico verificado pelo conjunto de caracterização e zero incidentes de produção. A IA fez a digitação. A disciplina fez a refatoração. Ambos eram necessários; apenas um deles era opcional.