DWG NO. FR‑2026 · AI‑NATIVE .NET 10 FRAMEWORK
Fraimio is a .NET 10 framework for Domain‑Driven Design and CQRS, built specifically to bring AI into your application — where agents, chat, and retrieval participate directly in how your users work, on the same compile‑time guarantees as every other layer. Not a chatbot bolted to the side.
01 — SPECIFICATION
Boilerplate is written by Fraimio.Generators.* at compile time, not discovered by reflection at runtime. Mistakes surface as build errors, not production incidents — and the generated code is AOT‑compatible from the start.
Every identifier is a typed struct, never a raw Guid or string. Every enum is a SmartEnum. Every public API returns Result<T>. Primitive obsession and unchecked exceptions aren't discouraged — they're structurally unavailable.
Aggregate roots, domain events, outbox delivery, and a full mediator pipeline ship as first‑class building blocks. You compose them — you don't re‑implement them on every new service.
A strict Suite → Module → Extension configuration hierarchy with Azure Key Vault normalization is built into the kernel — not bolted on after the first enterprise customer asks for it.
Agents, retrieval, and conversation are dispatched through the same Fraimio.Mediator pipeline, governed by the same Result<T> contracts, and scoped to the same multi‑tenant boundaries as everything else. AI participates in how your users work — it doesn't sit beside your application as a separate widget.
02 — AI SURFACE
AI isn't a chatbot widget dropped into a corner of the UI. It's a set of modules with the same standing as Repository or Messaging — itemized below.
03 — SAMPLE
A typed identifier and a CQRS command handler, exactly as they look in an application built on Fraimio. The same handler contract dispatches an AI agent turn just as easily as a domain command.
// The struct body is generated: New(), Parse(), TryParse(), equality, comparison.
public readonly partial struct OrderId : IFraimioIdentifier, IParsable<OrderId>;
public sealed record PlaceOrderCommand(CustomerId CustomerId, IReadOnlyList<OrderLine> Items)
: IFraimioRequest<Result<OrderId>>;
public sealed class PlaceOrderHandler(IRepository<Order, OrderId> orders)
: IFraimioRequestHandler<PlaceOrderCommand, Result<OrderId>>
{
public async Task<Result<OrderId>> HandleAsync(PlaceOrderCommand command, CancellationToken ct)
{
var order = Order.Place(command.CustomerId, command.Items);
if (order.IsInvalid())
return Result<OrderId>.Invalid(order.ValidationErrors);
await orders.AddAsync(order.Value, ct);
return Result<OrderId>.Success(order.Value.Id);
}
}1Typed ID — never a raw Guid, never a raw string.
2Result<T> failure paths — no unchecked throw from a public API.
3Dispatched through Fraimio.Mediator — no manual wiring, no service‑locator lookups.
04 — ARCHITECTURE
Each layer maps to a module boundary. Dependencies point one direction: inward, toward the domain.
05 — NEXT STEP
Fraimio is built and maintained by Parts Oracle for enterprise .NET teams bringing AI directly into how their users work — not bolting a chatbot onto the side of it.
Get in touch