ghostfolio/docs/adr

Architecture Decision Records

Status: Active Format: ADR-XXX: Short title Location: docs/adr/

Template

# ADR-XXX: [Short Title]

**Status**: Proposed | Accepted | Deprecated | Superseded
**Date**: YYYY-MM-DD
**Context**: [What is the issue we're facing?]

## Options Considered

### Option A: [Name] ✅ (CHOSEN)
- Description: [One-liner]
- Pros: [Key benefits]
- Cons: [Key drawbacks]

### Option B: [Name] ❌ (REJECTED)
- Description: [One-liner]
- Pros: [Key benefits]
- Cons: [Key drawbacks]
- Reason: [Why we rejected this]

## Decision

[1-2 sentences explaining what we chose and why]

## Trade-offs / Consequences

- **Positive**: [What we gain]
- **Negative**: [What we lose or complicate]

## What Would Change Our Mind

[Specific conditions that would make us revisit this decision]

## Related

- Tests: [Link to tests/evals]
- PRs: [Link to PRs]
- Supersedes: [ADR-XXX if applicable]

Rules

1. Before architectural change: Check relevant ADRs
2. Citation required: Must cite ADR in proposed changes
3. Update after refactor: Keep ADR current or mark SUPERSEDED
4. Debug rule: Bug investigation starts with ADR review

Index

ADR	Title	Status	Date
ADR-001	[TBD]	-	-