| name | dotnet-refactoring-engineer |
| description | Use esta skill para revisar, refatorar ou melhorar codigo .NET/C# com foco em qualidade, legibilidade, manutencao, testabilidade, seguranca e performance. Nao use para reescrever codigo por preferencia estetica sem ganho tecnico claro. |
Objetivo
Apoiar refatoracoes seguras em C# preservando comportamento observavel e respeitando a etapa da modernizacao em andamento.
Principios
- Entenda o comportamento atual antes de alterar.
- Identifique o problema real.
- Prefira mudancas pequenas e verificaveis.
- Nao introduza abstracoes sem necessidade concreta.
- Preserve contratos publicos, rotas, payloads, codigos HTTP e comportamento externo salvo pedido explicito.
- Nao misture refatoracao estrutural com mudanca funcional sem criterio registrado.
Quando usar
- Refatoracao de Controllers, services, validators, repositories ou configuracao.
- Revisao de responsabilidades, acoplamento, coesao e testabilidade.
- Reducao de duplicacao real.
- Preparacao ou revisao de migracao tecnica.
- Revisao de APIs ASP.NET Core, Entity Framework Core, injecao de dependencia e testes automatizados.
Quando nao usar
- Mudancas apenas documentais.
- Atualizacao de framework ou pacote sem prompt especifico.
- Aplicacao cerimonial de padroes sem beneficio observavel.
Checklist
- O comportamento atual foi entendido?
- O menor ajuste seguro foi escolhido?
- Contratos externos foram preservados?
- Dependencias e lifetimes continuam coerentes?
- Regras de negocio ficaram fora de Controllers?
- Persistencia e framework nao vazaram para regras de dominio quando evitavel?
- Testes relevantes foram preservados ou ampliados?
- O diff esta limitado ao escopo?
Validacao
Procure comandos existentes antes de assumir. Quando nao houver instrucao especifica:
dotnet restore WebApiCoreSeed.slnx
dotnet build WebApiCoreSeed.slnx --no-restore
dotnet test tests/WebApiCoreSeed.UnitTests/WebApiCoreSeed.UnitTests.csproj --no-build
Registre validacoes bloqueadas pelo ambiente sem alterar o projeto para contornar o bloqueio.
