Melhores Práticas de .NET/C#

Sua tarefa é garantir que o código .NET/C# em ${selection} atenda às melhores práticas específicas desta solução/projeto. Isso inclui:

Documentação e Estrutura

• Crie comentários de documentação XML abrangentes para todas as classes públicas, interfaces, métodos e propriedades
• Inclua descrições de parâmetros e descrições de valores de retorno em comentários XML
• Siga a estrutura de namespace estabelecida: {Core|Console|App|Service}.{Feature}

Padrões de Design e Arquitetura

• Use a sintaxe de construtor primário para injeção de dependência (por exemplo, public class MyClass(IDependency dependency))
• Implemente o padrão Command Handler com classes base genéricas (por exemplo, CommandHandler<TOptions>)
• Use segregação de interface com convenções de nomenclatura claras (prefixe interfaces com 'I')
• Siga o padrão Factory para criação de objetos complexos.

Injeção de Dependência e Serviços

• Use injeção de dependência por construtor com verificações de nulo via ArgumentNullException
• Registre serviços com tempos de vida apropriados (Singleton, Scoped, Transient)
• Use os padrões do Microsoft.Extensions.DependencyInjection
• Implemente interfaces de serviço para testabilidade

Gerenciamento de Recursos e Localização

• Use ResourceManager para mensagens localizadas e strings de erro
• Separe os arquivos de recursos LogMessages e ErrorMessages
• Acesse recursos via _resourceManager.GetString("MessageKey")

Padrões Async/Await

• Use async/await para todas as operações de I/O e tarefas de longa duração
• Retorne Task ou Task<T> de métodos async
• Use ConfigureAwait(false) onde apropriado
• Trate exceções async corretamente

Padrões de Teste

• Use o framework MSTest com FluentAssertions para asserções
• Siga o padrão AAA (Arrange, Act, Assert)
• Use Moq para simular dependências
• Teste cenários de sucesso e falha
• Inclua testes de validação de parâmetro nulo

Configuração e Ajustes

• Use classes de configuração fortemente tipadas com anotações de dados
• Implemente atributos de validação (Required, NotEmptyOrWhitespace)
• Use a vinculação do IConfiguration para configurações
• Suporte aos arquivos de configuração appsettings.json

Integração Semantic Kernel e IA

• Use Microsoft.SemanticKernel para operações de IA
• Implemente configuração adequada do kernel e registro de serviço
• Gerencie configurações de modelo de IA (ChatCompletion, Embedding, etc.)
• Use padrões de saída estruturada para respostas de IA confiáveis

Tratamento de Erros e Logging

• Use logging estruturado com Microsoft.Extensions.Logging
• Inclua logging com escopo e contexto significativo
• Lance exceções específicas com mensagens descritivas
• Use blocos try-catch para cenários de falha esperados

Desempenho e Segurança

• Use recursos do C# 12+ e otimizações do .NET 8 onde aplicável
• Implemente validação e sanitização de entrada adequadas
• Use consultas parametrizadas para operações de banco de dados
• Siga práticas de codificação segura para operações de IA/ML

Qualidade do Código

• Garanta a conformidade com os princípios SOLID
• Evite duplicação de código através de classes base e utilitários
• Use nomes significativos que reflitam conceitos de domínio
• Mantenha métodos focados e coesos
• Implemente padrões de descarte adequados para recursos