Architecture Decision Records (ADR)
This directory contains Architecture Decision Records for EQ Wave hardware and firmware.
Naming Convention: Architecture decisions use prefix ADR-XXX. Enhancement proposals (forward-looking) use WEP-XXX.
Purpose
ADRs document significant technical decisions that have been made, including:
- The context and problem being solved
- Options that were considered
- The decision and rationale
- Trade-offs accepted
- Consequences (positive and negative)
Distinction from WEPs
| Type | Purpose | Timing |
|---|---|---|
| WEP | Propose a change | Before implementation |
| ADR | Record a decision | After decision is made |
A WEP may result in an ADR once the proposal is accepted and implemented.
Index
| ADR | Title | Date | Status |
|---|---|---|---|
| ADR-001 | Wave v2 Architecture (ADC, channels, BOM) | Nov 2025 | Accepted |
| ADR-002 | Wave v2 MCU Selection (MCXN947) | Nov 2025 | Accepted |
| ADR-003 | Wave v2 FPGA Strategy (ECP5) | Nov 2025 | Accepted |
Related Documentation
- ../enhancement-proposals/ - WEPs (forward-looking proposals)
- ../wave-v2/ - Detailed technical documentation
- ../archive/ - Historical analysis and exploration
Template
When creating a new ADR:
- Use the next sequential number:
ADR-XXX-short-title.md - Include: Date, Status, Context, Options Considered, Decision, Rationale, Trade-offs, Consequences
- Keep it concise - link to detailed analysis docs rather than duplicating content
- Update this README index
© 2026 EQ Systems Inc.