Architecture Decision Records¶

This folder records the non-obvious design decisions behind orca — the choices a future contributor would otherwise have to reverse-engineer from the code, and where a casual refactor could silently undo a deliberate trade-off.

ADRs are intentionally short (one page each). Format:

# ADR-NNNN: Title

**Status**: Accepted | Superseded by ADR-MMMM | Deprecated
**Date**: YYYY-MM-DD

## Context
What problem we faced.

## Decision
What we chose to do.

## Consequences
- Positive: ...
- Negative / trade-off: ...

When a decision is reversed, don't delete the ADR — mark it Superseded by ADR-MMMM and add a new file. The history of choices is part of the documentation.

Architecture Decision Records¶

Index¶