Agent RulesAgent Rules
CQ

CQRS

Used in 126 csharp projects (avg ★307)

C#
Architecture
Used by 126 projects
api
webapp
Use in BuilderAll C# Options

Details

Language / Topic
csharpC#
Category
Architecture

Rules

balanced
- Use MediatR `IRequest<T>` for queries (return data) and `IRequest` for commands (no return value).
- Controllers dispatch via `IMediator.Send()` — no business logic in controllers.
- Separate read models (thin DTOs, denormalized views) from write models (rich domain entities) — use MediatR for dispatching commands and queries.
- Organize as `Features/Users/Commands/CreateUser.cs`, `Features/Users/Queries/GetUser.cs`.
- Use FluentValidation with MediatR pipeline behavior for automatic validation.
- Use `IPipelineBehavior<TRequest, TResponse>` for cross-cutting: logging, caching, transaction management.
- Keep handlers focused: one handler per command/query, one file per handler.