Files
dev-workflows/skills/wf-refactor/SKILL.md
T
evandro 2ef6f6be10 wip: snapshot das alterações não commitadas (2026-10-20)
Origem: D:/Documents/Github/dev-workflows
Arquivos omitidos (segredos, bancos de dados, logs, >50 MB): 0
2026-10-20 00:49:23 -03:00

1.4 KiB

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.