Worker Template — Agent handbook¶
Pick Worker when the workload is async: queues, scheduled jobs, long-running consumers — not a primary interactive HTTP API.
For request/response HTTP/gRPC product APIs, use the Microservice overview instead.
Canonical public page: Worker — ConnectSoft.Documentation
Agent checklist¶
| Rule | Detail |
|---|---|
| Kernel fixes | Patch ConnectSoft.BaseTemplate, bump base-template/ — same as other Layer 3 |
| Config keys | Use worker-specific tokens (e.g. WORKER_ORLEANS_DATABASE) per alignment |
| No public edge | Do not implement Gateway-style JWT validation here unless product explicitly adds HTTP |
Blueprint sketch¶
workload: background
messaging: MassTransit | none
hangfire: true | false
orleans: optional
trace_id: required_in_pr_descriptions
Topic index¶
| Topic | Agents use it for |
|---|---|
| Architecture | Host vs web stack |
| Parameters | dotnet new / symbol merge |
| Resiliency | Consumers, DLQ, retries |
| Use cases | Worker vs Microservice |