Decision Records¶
Architecture Decision Records (ADRs) for elfmem. Each file documents a significant decision: the context, the alternatives considered, the choice made, and why.
ADRs are append-only. We don't edit old decisions; if a decision is superseded, we write a new ADR that references it.
Format¶
# NNNN — Short title
**Status**: Accepted | Superseded by NNNN | Deprecated
**Date**: YYYY-MM-DD
**Deciders**: who reasoned about this
## Context
What was the situation that called for a decision?
## Alternatives considered
What options were on the table? With brief notes on each.
## Decision
What did we choose? Why?
## Consequences
What does this commit us to? What does it preclude?
## References
Links to plans, research, issues, simulation results.
Current ADRs¶
| # | Title | Status |
|---|---|---|
| 0001 | Power-law decay rejected | Accepted |
| 0002 | v0.17 scope: bundle four scoring fixes | Accepted |
| 0003 | Defer constitutional evolution mechanisms | Accepted |
| 0004 | Manual constitutional review (v0.18) | Accepted |
| 0005 | Peer-protocol hardening (v0.19) | Accepted |
| 0006 | Defer multi-parameter self-tuning (issue #73) | Accepted |
| 0007 | Bound and checkpoint consolidation for slow LLM adapters | Accepted |
| 0008 | MCP entry generation default, drift detection, and migration | Accepted |
| 0009 | Retire decay-driven block archival trigger | Accepted |
| 0010 | Retire pairwise LLM contradiction detection at consolidate-time | Accepted |
| 0011 | Substrate migration folded into elfmem migrate, cutover deferred |
Accepted |
| 0012 | Use-aware archival rejected | Accepted |
| 0013 | Substrate cutover as a second migration step | Accepted |