# 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

Proposed | Accepted | Superseded

## Context

What problem exists now.

## Decision

What we are choosing.

## Consequences

What gets easier, harder, or deferred.

## Follow-Up

Specific implementation steps or migrations.
```
