# Dotnet Service Change

> 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.

- Skill: `rodri-oliveira-dev/dotnet-service-change-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rodri-oliveira-dev/dotnet-service-change-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rodri-oliveira-dev/dotnet-service-change-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: rodri-oliveira-dev (https://skillmd.com/u/rodri-oliveira-dev)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/rodri-oliveira-dev/dotnet-service-change-3

---


# 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

1. Leia `AGENTS.md`, `.sdd/phase-2/` e a documentacao relevante.
2. Localize a solution e os projetos reais antes de editar.
3. Confirme o framework alvo atual e nao altere target framework sem prompt especifico.
4. Verifique impacto em contrato HTTP, autenticacao, EF Core, Redis, logs e documentacao.
5. Aplique a menor mudanca coerente com os padroes existentes.
6. Preserve comportamento observavel salvo quando a tarefa pedir mudanca funcional.
7. Se a tarefa envolver testes de integracao, consulte `integration-tests-dotnet`.
8. Revise o diff e confirme que nao houve refactor ou formatacao fora do escopo.
9. Valide com restore, build e testes proporcionais quando o ambiente permitir.

# Validacao

Comandos baseline, a partir da raiz:

```bash
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.