Microservice Template — Agent handbook

Default Layer 3 product service: DDD, Clean Architecture, HTTP/gRPC surfaces, optional messaging — built on Base.

Canonical public spec: Microservice — ConnectSoft.Documentation

When agents choose this template

Signal	Action
Blueprint says bounded context + REST/gRPC	Microservice
Blueprint says queue consumer / cron only	Worker
Need SDK for external HTTP API	API Library

Agent non-negotiables

1. Domain projects stay free of infrastructure / ASP.NET types.
2. Kernel regressions → ConnectSoft.BaseTemplate, not submodule-only hacks.
3. Configuration keys → extended template alignment.

Blueprint sketch

service: Order
surfaces: [RestApi, Grpc]
persistence: NHibernate
messaging: MassTransit
observability: OpenTelemetry
multi_tenant: true | false

Topic index

Deep public pages are linked from each (agents) topic file. Start with Architecture, Clean Architecture, Domain Driven Design.

Related

• Microservice Generator Agent
• Topic hub
• Legacy deep dive — long-form historical Factory content