All skills
Skillintermediate
design service
Design a backend service architecture with clear boundaries, data models, and API contracts.
Claude Code Knowledge Pack7/10/2026
Overview
Design a backend service architecture with clear boundaries, data models, and API contracts.
Steps
- Define the service scope:
- Design the data model:
- Design the API layer:
- Plan the service internals:
- Design inter-service communication:
- Plan for observability:
- Document the service contract.
Format
Service: <name>
Domain: <what it owns>
Entities: <data model summary>
API Endpoints: <list>
Rules
- Each service should own its data; no shared databases.
- Design for failure: every external call can fail.
- Use interface segregation; expose only what consumers need.