dev-workflows/skills/wf-refactor/SKILL.md

name, description, license, metadata

name	description	license	metadata
wf-refactor	Use para refatorar, reorganizar, renomear, extrair, simplificar ou limpar código sem mudar o comportamento. Congela o comportamento com testes antes de mexer e mexe em passos pequenos.	MIT	dev-workflows uses external

Workflow Refactor

1. Rede de segurança

Os testes atuais cobrem o comportamento que você vai tocar? Se não, escreva testes de caracterização antes de mudar qualquer coisa: eles registram o que o código faz hoje, mesmo que pareça estranho. Rode e confirme que estão verdes.

2. Passos pequenos

Cada passo deixa o código compilando e os testes verdes. Rode os testes a cada passo, não só no fim. Renomeação: procure também em strings, configs, rotas e docs (grep -rn), não só nos imports.

3. Comportamento não muda

Os testes de caracterização não são editados. Se você precisa editar um deles, a mudança não é refactor: pare e pergunte ao usuário.

4. Gate e relatório

"${CLAUDE_PLUGIN_ROOT}/scripts/quality-gate" --tier 1 (nível 2 se o refactor atravessa módulos). No relatório, as linhas líquidas: um bom refactor costuma reduzir. Se aumentou, explique.

Não faça

• Misturar refactor com feature ou correção de bug no mesmo diff.
• Mudar API pública sem o usuário pedir.
• Criar camada ou abstração nova "para ficar mais limpo" sem um uso concreto hoje.