Architectural Decision Records
This directory captures significant architectural decisions made in the Owlat project. Each record explains the context, the decision, and the trade-offs...
This directory captures significant architectural decisions made in the Owlat project. Each record explains the context, the decision, and the trade-offs involved.
Format
We use a lightweight ADR format:
# ADR-NNN: Title
- Status: Accepted | Superseded | Deprecated
- Date: YYYY-MM-DD
- Context: What prompted this decision
- Decision: What was decided
- Consequences: Trade-offs, what this enables/prevents
Decisions
| ADR | Title | Status |
|---|---|---|
| 001 | Custom email renderer over MJML | Accepted |
| 002 | Convex as backend | Accepted |
| 003 | Notion-like email builder | Accepted |
| 004 | Monorepo with Bun workspaces | Accepted |
| 005 | Custom MTA | Accepted |
| 006 | Self-hosted Convex | Accepted |
| 007 | Pluggable LLM provider | Accepted |
| 008 | Agent process architecture | Accepted |
| 009 | Task-based model routing | Accepted |
Adding a New ADR
- Create a new file:
NNN-short-title.md(use the next available number) - Follow the format above
- Add a row to the table in this index
- Submit with your PR