Design Document template

Canonical template for the Design Document format.

# [System / Feature Name] Design Document

## Status

[Draft | In Review | Accepted | Superseded]

## Problem

[What problem is being solved. The constraints that shape the solution space.]

## Proposed Design

[How the system will work. Schemas, APIs, component boundaries, data flows.
Be specific enough that a reviewer can evaluate the approach.]

## Alternatives Considered

[Other approaches evaluated and why they were not chosen.]

## Risks and Open Questions

[What could go wrong. What is still uncertain.]

## Appendix (optional)

[Supporting diagrams, data models, or reference material.]