Every workflow used to run all of its phases for any request, so a one-line fix paid the cost of a feature. dev-router classifies the request into tiers 0-3 with security triggers that raise the tier, and picks the workflow, agents and gate tier. Agents get only the tools their role needs. Co-Authored-By: Claude Opus 5.5 <[email protected]>
34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
---
|
|
name: wf-refactor
|
|
description: 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.
|
|
---
|
|
|
|
# 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.
|