Skill

refactor

Refatoracao ou migracao sistematica com inventario e execucao por waves. Para: renomear, reestruturar, migrar patterns, modernizar APIs. Ativado por: /refactor, "refatorar", "migrar", "renomear", "reestruturar", "reorganizar".

Install

npx claudepluginhub souzalemos/spec-driven-workflow --plugin spec-driven-workflow

Tool Access

This skill uses the workspace's default tool permissions.

Preview

4 fases com artefatos em .spec/workflows/refactors/.

SKILL.md

Similar Skills

kotlin-ktor-patterns

Provides Ktor server patterns for routing DSL, plugins (auth, CORS, serialization), Koin DI, WebSockets, services, and testApplication testing.

everything-claude-code

163.2k

deep-research

Conducts multi-source web research with firecrawl and exa MCPs: searches, scrapes pages, synthesizes cited reports. For deep dives, competitive analysis, tech evaluations, or due diligence.

everything-claude-code

163.2k

inventory-demand-planning

Provides demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation for multi-location retailers managing 300-800 SKUs.

everything-claude-code

163.2k

Stats

Stars1

Forks0

Last CommitApr 6, 2026

Actions

View Source View Plugin View on GitHub View README

Refactor — Transformacao por waves

4 fases com artefatos em .spec/workflows/refactors/.

Fase 1: Inventory

Goal: Conhecer o escopo COMPLETO antes de mudar qualquer coisa.

Scan o codebase — encontre TODAS as instancias do que precisa mudar

Arquivos, funcoes, tipos, imports, testes, docs, config
Use grep/glob para ser exaustivo — nao confie na memoria

Categorize por tipo: source, test, config, docs

Identifique dependencias — qual ordem as mudancas devem acontecer?

Crie .spec/workflows/refactors/INVENTORY.md:

Lista completa de arquivos/locais que precisam mudar
Relacoes de dependencia
Escopo estimado (numero de arquivos, linhas afetadas)

Gate: Revise inventario com humano. Confirme que nada falta.

Fase 2: Plan

Goal: Dividir a migracao em waves seguras e verificaveis.

Defina waves — agrupe mudancas para que cada wave:

Deixe o codebase em estado funcional
Possa ser commitada e testada independentemente
Respeite dependencias (mude a definicao antes dos consumidores)

Estrutura tipica de waves:

Wave 1: Tipos/interfaces
Wave 2: Implementacao core
Wave 3: Consumidores/callers
Wave 4: Testes
Wave 5: Documentacao e config

Crie .spec/workflows/refactors/PLAN.md com waves e file lists

Gate: Confirme plano com humano

Fase 3: Migrate

Goal: Execute uma wave por vez com verificacao entre cada.

Para cada wave:

Faca as mudancas
Rode testes (no minimo, build deve passar)
Commit: refactor([escopo]): wave N — [descricao]

Se uma wave introduz falhas, corrija ANTES da proxima

Se escopo novo aparece, atualize inventario e plano

Fase 4: Verify

Rode suite completa de testes

Rode build e lint

Busque remanescentes do padrao antigo (grep pelo nome/padrao velho)

Crie .spec/workflows/refactors/SUMMARY.md:

O que mudou e por que
Arquivos modificados (count e lista)
Follow-up items restantes

Refactor — Transformacao por waves

4 fases com artefatos em .spec/workflows/refactors/.

Fase 1: Inventory

Goal: Conhecer o escopo COMPLETO antes de mudar qualquer coisa.

Scan o codebase — encontre TODAS as instancias do que precisa mudar
- Arquivos, funcoes, tipos, imports, testes, docs, config
- Use grep/glob para ser exaustivo — nao confie na memoria
Categorize por tipo: source, test, config, docs
Identifique dependencias — qual ordem as mudancas devem acontecer?
Crie .spec/workflows/refactors/INVENTORY.md:
- Lista completa de arquivos/locais que precisam mudar
- Relacoes de dependencia
- Escopo estimado (numero de arquivos, linhas afetadas)
Gate: Revise inventario com humano. Confirme que nada falta.

Fase 2: Plan

Goal: Dividir a migracao em waves seguras e verificaveis.

Defina waves — agrupe mudancas para que cada wave:
- Deixe o codebase em estado funcional
- Possa ser commitada e testada independentemente
- Respeite dependencias (mude a definicao antes dos consumidores)
Estrutura tipica de waves:
- Wave 1: Tipos/interfaces
- Wave 2: Implementacao core
- Wave 3: Consumidores/callers
- Wave 4: Testes
- Wave 5: Documentacao e config
Crie .spec/workflows/refactors/PLAN.md com waves e file lists
Gate: Confirme plano com humano

Fase 3: Migrate

Goal: Execute uma wave por vez com verificacao entre cada.

Para cada wave:
- Faca as mudancas
- Rode testes (no minimo, build deve passar)
- Commit: refactor([escopo]): wave N — [descricao]
Se uma wave introduz falhas, corrija ANTES da proxima
Se escopo novo aparece, atualize inventario e plano

Fase 4: Verify

Rode suite completa de testes
Rode build e lint
Busque remanescentes do padrao antigo (grep pelo nome/padrao velho)
Crie .spec/workflows/refactors/SUMMARY.md:
- O que mudou e por que
- Arquivos modificados (count e lista)
- Follow-up items restantes