# ADR Process
Use Architecture Decision Records to preserve important design choices.
## When To Write An ADR
Write an ADR when changing:
- product direction
- security model
- storage model
- retrieval strategy
- API or MCP surface
- integration assumptions
## File Naming
Use:
`NNNN-short-kebab-case-title.md`
Example:
`0002-memory-ledger-separate-from-obsidian.md`
## Suggested Template
```md
# ADR NNNN: Title
## Status
## Context
What problem exists now.
## Decision
What we are choosing.
## Consequences
What gets easier, harder, or deferred.
## Follow-Up
Specific implementation steps or migrations.
```