# Design

Design docs capture durable principles and decisions that should outlive a
single pull request.

## Files

- `principles.md` - engineering principles for structure and documentation.
- `decisions/` - architecture decision records.

## Decision Record Template

```markdown
# ADR-0000: Title

## Status
Proposed | Accepted | Superseded

## Context
## Decision
## Consequences
## References
```
