# {{PROJECT_NAME}} - C#/.NET

> Gerado: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}

## O Que (Stack & Estrutura)

**Stack**: {{TECH_STACK}}
**.NET**: {{DOTNET_VERSION}} | **C#**: 13

### Estrutura do projeto
```
src/
├── Domain/           # Logica de negocio (sem deps externas)
│   ├── Entities/     # Modelos de dominio ricos
│   ├── ValueObjects/ # Tipos imutaveis
│   └── Events/       # Domain events
├── Application/      # Use cases, CQRS (depende de Domain)
│   ├── Commands/     # Operacoes de escrita
│   └── Queries/      # Operacoes de leitura
├── Infrastructure/   # Concerns externos (depende de Domain + App)
│   └── Persistence/  # EF Core, repositories
└── WebAPI/           # Camada de apresentacao
```

## Por Que (Proposito & Organizacao)

### Arquitetura: Clean Architecture + CQRS
- **CQRS**: Commands/Queries separados com MediatR
- **DDD**: Modelos de dominio ricos, aggregates, value objects
- **Repository Pattern**: Abstracao para acesso a dados
- Dependencias fluem para dentro (Domain no centro)

Ver `rules/02-architecture.md` para padroes.

### Regras criticas

| Regra | Descricao |
|-------|-----------|
| Nullable | Nullable reference types habilitado |
| Async | Sempre passar CancellationToken |
| Naming | PascalCase publico, _camelCase privado |
| Testes | 80% cobertura, Domain 90%+ |

## Como (Comandos & Workflows)

### Comandos de desenvolvimento
```bash
dotnet build                        # Compilar
dotnet run --project src/WebAPI     # Executar
dotnet ef migrations add Name       # Criar migration
```

### Pipeline de qualidade
```bash
dotnet build -warnaserror           # Build sem warnings
dotnet test --collect:"XPlat Code Coverage" # Testes + cobertura
dotnet format --verify-no-changes   # Verificar formatacao
```

### Comandos Claude Craft
- `/csharp:check-compliance` - Auditoria completa
- `/csharp:check-architecture` - Validacao de arquitetura
- `/csharp:generate-feature` - Gerar feature CQRS

### Workflow de desenvolvimento
1. **Analisar** - `rules/01-workflow-analysis.md`
2. **TDD** - xUnit + FluentAssertions + Moq
3. **Qualidade** - Build limpo + Testes passando
4. **Commit** - Conventional Commits

## Referencias

| Contexto | Arquivo |
|----------|---------|
| Workflow | `rules/01-workflow-analysis.md` |
| Arquitetura | `rules/02-architecture.md` |
| Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Testes | `rules/07-testing.md` |
| Seguranca | `rules/11-security.md` |

<!-- PROJECT-SPECIFIC-START -->
## Especificidades do projeto

<!-- Adicionar configuracao especifica do projeto aqui -->

<!-- PROJECT-SPECIFIC-END -->
