# ADR-XXXX: [Short Title]
**Date**: YYYY-MM-DD
**Status**: Proposed
**Deciders**: [List key decision makers]
**Tags**: [architecture, security, performance, etc.]
---
## Context
<!-- Describe the problem or opportunity -->
<!-- What forces are at play? Technical, political, social, project constraints? -->
<!-- What is the background that led to this decision? -->
### Problem Statement
[Clear description of the problem]
### Goals
- Goal 1
- Goal 2
- Goal 3
### Non-Goals
- What we're explicitly NOT trying to solve
## Decision
<!-- What is the change we're proposing/making? -->
<!-- State the decision in full sentences with active voice -->
<!-- "We will..." -->
### Approach
[Detailed description of the solution]
### Implementation Plan
1. Step 1
2. Step 2
3. Step 3
### Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3
## Consequences
### Positive Consequences
<!-- What becomes easier? -->
- Benefit 1
- Benefit 2
- Benefit 3
### Negative Consequences
<!-- What becomes harder? -->
- Trade-off 1
- Trade-off 2
- Trade-off 3
### Risks
- Risk 1 (Mitigation: ...)
- Risk 2 (Mitigation: ...)
## Alternatives Considered
### Alternative 1: [Name]
**Pros:**
- Pro 1
- Pro 2
**Cons:**
- Con 1
- Con 2
**Why not chosen:**
[Explanation]
### Alternative 2: [Name]
**Pros:**
- Pro 1
- Pro 2
**Cons:**
- Con 1
- Con 2
**Why not chosen:**
[Explanation]
## References
<!-- Links to related resources -->
- [Related- [ADR-XXXX: Title](#)
- [Issue #XXX](https://github.com/Boring206/boring-gemini/issues/XXX)
- [External documentation]
- [Research papers]
- [Blog posts]
## Notes
<!-- Any additional context or discussion points -->
---
## Changelog
| Date | Status Change | Notes |
|------|--------------|-------|
| YYYY-MM-DD | Proposed | Initial draft |
| | | |
