Decision Records

Architecture Decision Records (ADRs) for Stella. Each record captures a significant decision, its context, and its consequences — so "why is it like this?" always has an answer.

Index

#	Title	Status	Date
001	<e.g. Choice of agent-loop framework>	Accepted	YYYY-MM-DD

Create new records as pages named ADR-NNN-Short-Title and add them to this table.

When to write an ADR

Write one when a decision is expensive to reverse, affects multiple components, or you found yourself explaining the same rationale twice. Skip it for easily reversible, local choices.

Template

# ADR-NNN: Title

- **Status:** Proposed | Accepted | Superseded by ADR-NNN
- **Date:** YYYY-MM-DD
- **Deciders:** @names

## Context
What problem are we solving and what constraints apply?

## Decision
What we chose, in one or two sentences.

## Alternatives considered
What else was on the table and why it lost.

## Consequences
What gets easier, what gets harder, what we're committing to.