Files
dev-workflows/skills/wf-refactor/SKILL.md
EvandroandClaude Opus 5.5 f2db2d69da refactor(skills): cut the workflows to ~100 lines and scale phases by tier
Each workflow was ~300 lines of grep-count "VERIFICAR" steps and ran every
phase for every request. Phases now state their minimum tier, checks are the
quality gate plus real tools, detail moved to references/, and machine-specific
paths and non-public skills are gone. Security references move to OWASP Top
10:2025, ASVS 5.0 and the OWASP LLM Top 10.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-24 21:52:06 -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.