| name | dotnet-service-change |
| description | Use esta skill ao alterar a aplicacao .NET deste repositorio, incluindo API, Business, Data, EF Core, autenticacao, configuracao ou testes relacionados. Nao use para mudancas apenas em governanca, CI/CD puro ou documentacao sem impacto tecnico. |
Objetivo
Orientar alteracoes pequenas e seguras na solution WebApiCoreSeed.slnx, respeitando o estado atual em .NET Core 3.1 e a modernizacao incremental planejada para .NET 10.
Quando usar
- Alteracoes em Controllers, filtros, middlewares, Swagger, autenticacao ou configuracao da API.
- Alteracoes em services, validadores, modelos de dominio legado ou interfaces.
- Alteracoes em EF Core, DbContext, mappings, migrations ou repositories.
- Ajustes de comportamento que exijam testes unitarios ou, no futuro, testes de integracao.
- Migracao tecnica da solution quando o prompt pedir explicitamente.
Quando nao usar
- Mudancas apenas em
.agents/, AGENTS.md, prompts ou SDD.
- Revisoes puramente de automacao ou hooks.
- Documentacao geral sem impacto em contrato, arquitetura, setup local ou comportamento.
Processo
- Leia
AGENTS.md, .sdd/phase-2/ e a documentacao relevante.
- Localize a solution e os projetos reais antes de editar.
- Confirme o framework alvo atual e nao altere target framework sem prompt especifico.
- Verifique impacto em contrato HTTP, autenticacao, EF Core, Redis, logs e documentacao.
- Aplique a menor mudanca coerente com os padroes existentes.
- Preserve comportamento observavel salvo quando a tarefa pedir mudanca funcional.
- Se a tarefa envolver testes de integracao, consulte
integration-tests-dotnet.
- Revise o diff e confirme que nao houve refactor ou formatacao fora do escopo.
- Valide com restore, build e testes proporcionais quando o ambiente permitir.
Validacao
Comandos baseline, a partir da raiz:
dotnet restore WebApiCoreSeed.slnx
dotnet build WebApiCoreSeed.slnx --no-restore
dotnet test tests/WebApiCoreSeed.UnitTests/WebApiCoreSeed.UnitTests.csproj --no-build
Se a validacao for bloqueada por ambiente legado, registre o bloqueio sem alterar SDK, target framework ou pacotes.
Restricoes
- Nao altere migrations antigas sem necessidade explicita.
- Nao altere testes apenas para faze-los passar.
- Nao introduza segredos, URLs ou portas inventadas.
- Nao crie abstracoes sem beneficio comprovado.
- Nao faca push nem abra Pull Request sem pedido explicito.
