Architecture Decision Records
This section documents significant architecture decisions made in the TeaLeaf project. Each record captures the context, decision, and consequences of a choice that affects the project’s design or implementation.
ADR Index
| ADR | Title | Status | Date |
|---|---|---|---|
| ADR-0001 | Use IndexMap for Insertion Order Preservation | Accepted | 2026-02-05 |
| ADR-0002 | Fuzzing Architecture and Strategy | Accepted | 2026-02-06 |
| ADR-0003 | Maximum Nesting Depth Limit (256) | Accepted | 2026-02-06 |
| ADR-0004 | ZLIB Compression for Binary Format | Accepted | 2026-02-06 |
What is an ADR?
An Architecture Decision Record (ADR) is a short document that captures an important architectural decision along with its context and consequences. ADRs help future contributors understand why certain design choices were made, not just what was built.
ADR Lifecycle
Each ADR has one of the following statuses:
- Proposed — Under discussion, not yet implemented
- Accepted — Approved and implemented (or in progress)
- Superseded — Replaced by a newer ADR (linked in the record)
- Deprecated — No longer applicable due to project changes