# Architecture Decision Records (ADR)

This directory contains Architecture Decision Records for the epsilon-machine framework project.

## What is an ADR?

An ADR is a document that captures an important architectural decision made along with its context and consequences.

## ADR Index

| ADR # | Title | Status | Date |
|-------|-------|--------|------|
| [ADR-001](001-programming-language.md) | Programming Language Selection | Accepted | 2026-01-14 |
| [ADR-002](002-architecture-principles.md) | Core Architecture Principles | Accepted | 2026-01-14 |
| [ADR-003](003-error-handling-strategy.md) | Error Handling Strategy | Accepted | 2026-01-14 |
| [ADR-004](004-project-requirements.md) | Project Requirements Summary | Living | 2026-01-14 |
| [ADR-005](005-package-naming.md) | Package Naming | Accepted | 2026-01-14 |
| [ADR-006](006-symbolic-computation.md) | Symbolic Computation Strategy | Accepted | 2026-01-14 |
| [ADR-007](007-parallelization-strategy.md) | Parallelization Strategy | Accepted | 2026-01-14 |
| [ADR-008](008-benchmarking-tool.md) | Benchmarking Tool Architecture | Accepted | 2026-01-26 |

## Status Definitions

- **Proposed**: Under discussion
- **Accepted**: Decided and approved
- **Deprecated**: No longer valid
- **Superseded**: Replaced by another ADR
