Backend · Windsurf Cascade
.NET 10 & C# 14 Minimal APIs Windsurf Cascade Rules
Generate Windsurf Cascade rules for .NET 10 & C# 14 Minimal APIs in .windsurf/rules/, with the stack's conventions and checks.
- Path
- .windsurf/rules/csharp-dotnet-10.md
- Loads
- Per-rule trigger
- Format
- Markdown with frontmatter (.md)
- Used by
- Windsurf Cascade
What this file tells the agent
Windsurf's Cascade agent reads rules from .windsurf/rules/. This rule gives Cascade the .NET 10 & C# 14 Minimal APIs conventions, commands and patterns to avoid, so its edits follow the stack instead of generic or outdated defaults.
- Use current C# features: primary constructors, collection expressions, file-scoped namespaces, C# 14's field keyword, and nullable reference types (#nullable enable).
- Structure lightweight microservices with ASP.NET Core Minimal APIs using typed route groups and TypedResults return values.
- Enforce AsNoTracking() on read-only EF Core queries to eliminate memory overhead from change trackers.
- Validate request payloads using FluentValidation or MiniValidation before executing business logic.
- Use IHttpClientFactory with typed resilience pipelines (Polly) for outbound HTTP calls.
Code to avoid, and what to write instead
The rule steers the agent away from the left and toward the right.
// 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;
}
}Install it in one command
- 01
Go to your project root
The file goes at .windsurf/rules/csharp-dotnet-10.md, relative to the root.
- 02
Download the file
Run the command on the right. It downloads this preset and writes the file.
- 03
Make sure it gets used
Cascade reads rules in .windsurf/rules/ and applies this one according to its trigger.
$ mkdir -p ".windsurf/rules" && curl -fsSL "https://www.devscratchpad.tech/api/raw/windsurf-rules/csharp-dotnet-10" -o ".windsurf/rules/csharp-dotnet-10.md"
writes .windsurf/rules/csharp-dotnet-10.md
.windsurf/rules/csharp-dotnet-10.md
To write the file from your own code instead, use Read your code or Convert Legacy Rules in the editor above.
More for .NET 10 & C# 14 Minimal APIs
Questions
- Where do I save this Windsurf rule?
- Save it as .windsurf/rules/csharp-dotnet-10.md in your project. Cascade picks up rules in that folder automatically.
- When does Windsurf apply this rule?
- According to the trigger in its frontmatter: always on, on a glob match, when Cascade decides the description fits the task, or when you @-mention it.