Plano de Refatoração

Crie um plano detalhado antes de fazer qualquer alteração no código.

Instruções

1. Não edite arquivos enquanto prepara o plano.
2. Pesquise na base de código para entender o estado atual. Leia implementação, testes, configuração e documentação suficientes para tornar o plano específico para o repositório.
3. Identifique arquivos afetados, limites de propriedade, dependências e acoplamentos ocultos prováveis.
4. Planeje as alterações em uma sequência segura. Prefira contratos e tipos primeiro, depois implementações, depois chamadores, depois testes, depois limpeza.
5. Inclua etapas de verificação entre as fases e um comando de validação final.
6. Inclua etapas de reversão ou recuperação para as fases mais arriscadas.
7. Gere o plano completo usando o formato abaixo.
8. Pare após o plano e peça confirmação antes de implementar. Se o usuário já pediu para implementar, ainda assim gere o plano primeiro e aguarde a confirmação, a menos que ele tenha dito explicitamente para continuar sem revisão após o plano.

Se a solicitação for muito ambígua para planejar com segurança, faça perguntas esclarecedoras concisas em vez de editar arquivos.

Formato de Saída

## Refactor Plan: [title]

### Current State
[Brief description of how things work now]

### Target State
[Brief description of how things will work after]

### Affected Files
| File | Change Type | Dependencies |
|------|-------------|--------------|
| path | modify/create/delete | blocks X, blocked by Y |

### Execution Plan

#### Phase 1: Types and Interfaces
- [ ] Step 1.1: [action] in `file.ts`
- [ ] Verify: [how to check it worked]

#### Phase 2: Implementation
- [ ] Step 2.1: [action] in `file.ts`
- [ ] Verify: [how to check]

#### Phase 3: Tests
- [ ] Step 3.1: Update tests in `file.test.ts`
- [ ] Verify: Run `npm test`

#### Phase 4: Cleanup
- [ ] Remove deprecated code
- [ ] Update documentation

### Rollback Plan
If something fails:
1. [Step to undo]
2. [Step to undo]

### Risks
- [Potential issue and mitigation]

Após o plano, pergunte: "Devo prosseguir com a Fase 1?"