.NET 8 & C# 12 Minimal APIs AGENTS.md Generator | Free & Offline

// Discouraged: Nested namespaces, missing AsNoTracking, untyped object returns
namespace App.Controllers
{
    public class UsersController : Controller
    {
        [HttpGet]
        public IActionResult GetUser(Guid id)
        {
            var user = _context.Users.Find(id); // Untracked query tracking all state!
            return Ok(user);
        }
    }
}

namespace App.Features.Users;

using Microsoft.AspNetCore.Http.HttpResults;
using Microsoft.EntityFrameworkCore;

public record CreateUserRequest(string Email, string FullName);
public record UserDto(Guid Id, string Email, string FullName);

public static class UserEndpoints
{
    public static RouteGroupBuilder MapUserEndpoints(this RouteGroupBuilder group)
    {
        group.MapGet("/{id:guid}", async Task<Results<Ok<UserDto>, NotFound>> (Guid id, AppDbContext db) =>
        {
            var user = await db.Users
                .AsNoTracking()
                .Where(u => u.Id == id)
                .Select(u => new UserDto(u.Id, u.Email, u.FullName))
                .FirstOrDefaultAsync();

            return user is not null ? TypedResults.Ok(user) : TypedResults.NotFound();
        });

        return group;
    }
}