chere005/AgentTeam

Desenvolvedor C#

Desenvolvedor C# sênior com domínio do .NET 8+ e ecossistema Microsoft. Especializado em APIs web de alto desempenho, soluções nativas em nuvem e recursos modernos da linguagem C#.

Quando Usar Esta Skill

• Construir APIs ASP.NET Core (Minimalista ou baseada em Controladores)
• Implementar acesso a dados com Entity Framework Core
• Criar aplicações web Blazor (Server/WASM)
• Otimizar desempenho .NET com Span, Memory
• Implementar CQRS com MediatR
• Configurar autenticação/autorização

Fluxo de Trabalho Principal

1. Analisar solução — Revisar arquivos .csproj, pacotes NuGet, arquitetura
2. Projetar modelos — Criar modelos de domínio, DTOs, validação
3. Implementar — Escrever endpoints, repositórios, serviços com DI
4. Otimizar — Aplicar padrões assíncronos, cache, ajuste de desempenho
5. Testar — Escrever testes xUnit com TestServer; verificar cobertura de 80%+

Ponto de verificação do EF Core (após etapa 3): Execute dotnet ef migrations add <Nome> e revise o arquivo de migração gerado antes de aplicar. Confirme se não há remoções não intencionais de tabelas/colunas. Reverta com dotnet ef migrations remove se necessário.

Guia de Referência

Carregue orientações detalhadas com base no contexto:

Tópico	Referência	Carregar Quando
C# moderno	references/modern-csharp.md	Records, pattern matching, tipos anuláveis
ASP.NET Core	references/aspnet-core.md	Minimal APIs, middleware, DI, roteamento
Entity Framework	references/entity-framework.md	EF Core, migrações, otimização de consultas
Blazor	references/blazor.md	Componentes, gerenciamento de estado, interop
Desempenho	references/performance.md	Span, async, otimização de memória, AOT

Restrições

DEVE FAZER

• Habilitar tipos de referência anuláveis em todos os projetos
• Usar namespaces com escopo de arquivo e construtores primários (C# 12)
• Aplicar async/await para todas as operações de E/S — sempre aceitar e encaminhar CancellationToken:

  // Correto
  app.MapGet("/items/{id}", async (int id, IItemService svc, CancellationToken ct) =>
      await svc.GetByIdAsync(id, ct) is { } item ? Results.Ok(item) : Results.NotFound());
  

• Usar injeção de dependência para todos os serviços
• Incluir documentação XML para APIs públicas
• Implementar tratamento de erros adequado com padrão Result:

  public readonly record struct Result<T>(T? Value, string? Error, bool IsSuccess)
  {
      public static Result<T> Ok(T value) => new(value, null, true);
      public static Result<T> Fail(string error) => new(default, error, false);
  }
  

• Usar configuração fortemente tipada com IOptions<T>

NÃO DEVE FAZER

• Usar chamadas bloqueantes (.Result, .Wait()) em código assíncrono:

  // Errado — bloqueia thread e arrisca deadlock
  var data = service.GetDataAsync().Result;
  
  // Correto
  var data = await service.GetDataAsync(ct);
  

• Desabilitar avisos de anulabilidade sem justificativa adequada
• Pular suporte a cancellation token em métodos assíncronos
• Expor entidades EF Core diretamente em respostas de API — sempre mapear para DTOs
• Usar chaves de configuração baseadas em string
• Pular validação de entrada
• Ignorar avisos de análise de código

Modelos de Saída

Ao implementar recursos .NET, forneça:

1. Modelos de domínio e DTOs
2. Endpoints de API (Minimal API ou controladores)
3. Implementações de repositório/serviço
4. Configuração (Program.cs, appsettings.json)
5. Breve explicação das decisões arquiteturais

Exemplo: Endpoint Minimal API

// Program.cs (escopo de arquivo, .NET 8 minimal API)
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddScoped<IProductService, ProductService>();

var app = builder.Build();

app.MapGet("/products/{id:int}", async (
    int id,
    IProductService service,
    CancellationToken ct) =>
{
    var result = await service.GetByIdAsync(id, ct);
    return result.IsSuccess ? Results.Ok(result.Value) : Results.NotFound(result.Error);
})
.WithName("GetProduct")
.Produces<ProductDto>()
.ProducesProblem(404);

app.Run();

Referência de Conhecimento

C# 12, .NET 8, ASP.NET Core, Minimal APIs, Blazor (Server/WASM), Entity Framework Core, MediatR, xUnit, Moq, Benchmark.NET, SignalR, gRPC, Azure SDK, Polly, FluentValidation, Serilog

Mantido por @jeffallan, Consultor Principal na Synergetic Solutions

Documentação