DVT New Service Scaffold
Stand up a new DVT backend service that matches the house architecture on day one.
When to use this skill
Use this skill when you need to:
- Create a brand-new backend service or microservice.
- Bring an existing prototype up to the DVT baseline.
Standard layout
src/
api/ # transport layer (HTTP/gRPC handlers) — thin
domain/ # business logic, no framework imports
infra/ # db, queues, external clients
config/ # typed config loaded from env
test/
Steps
- Create the layout above; keep
domain/free of framework/transport imports. - Add a
/healthz(liveness) and/readyz(readiness) endpoint. - Wire structured JSON logging with a request/correlation id on every log line.
- Load config from environment via a typed config module — never read
process.envdirectly in business code. - Add the standard CI pipeline (lint → test → build → container scan).
References
| Reference | When to load |
|---|---|
| references/checklist.md | Full pre-merge checklist for a new service |