Skip to content

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