# Decision: [DECISION TITLE]

**Date**: YYYY-MM-DD
**Decided by**: [agent-name]
**Status**: [proposed / accepted / implemented / superseded]

## Context

[What situation led to this decision? What problem are we solving?]

## Decision

[What was decided? Be specific and clear.]

## Rationale

[Why did we make this decision? What factors influenced it?]

## Alternatives Considered

### Option 1: [Alternative Name]
- **Pros**:
  - [Pro 1]
  - [Pro 2]
- **Cons**:
  - [Con 1]
  - [Con 2]
- **Why not chosen**: [reason]

### Option 2: [Alternative Name]
- **Pros**:
  - [Pro 1]
- **Cons**:
  - [Con 1]
- **Why not chosen**: [reason]

## Implications

**Impact on**:
- **Architecture**: [how this affects system design]
- **Performance**: [performance implications if any]
- **Maintenance**: [how this affects future work]
- **Other features**: [what else is affected]

## Implementation

**Files affected**:
- `path/to/file1.ext`
- `path/to/file2.ext`

**Commits implementing this**:
- `abc1234` - [commit message]
- `def5678` - [commit message]

**Testing requirements**:
- [ ] Test requirement 1
- [ ] Test requirement 2

## Reversibility

**Can this be reversed?** [yes / no / partially]

**If yes, how?**
[Steps to reverse this decision if needed]

**Cost of reversal**:
[How much work to reverse it]

## References

- Related decisions: [link to other decision docs]
- External docs: [relevant links]
- Discussion: [where this was discussed]

---

**Decision ID**: [unique identifier if needed]
**Reviewed by**: [other agent if applicable]
**Last updated**: YYYY-MM-DD
