Design specification: Title
Date: YYYY-MM-DD
Status: Draft
Problem
What is difficult, unsafe, or ambiguous today?
Goals
- Required outcome.
Non-goals
- Explicit exclusion.
Design
Describe boundaries, data flow, public APIs, and ownership.
Acceptance criteria
- Observable outcome.
Risks
- Risk and mitigation.
Alternatives considered
- Alternative and reason not chosen.