# {{title}}

**Type:** {{type}}  
**Status:** proposal  
**Branch:** (to be determined after promotion to todo)  
**Linked roadmap section:** {{phase}} (if applicable)

---

## 🧠 Context
{{what exists and why this improvement was identified}}

## 💡 Proposal

{{description of the proposed improvement or issue}}

## 🎯 Potential Benefits

- {{benefit 1}}
- {{benefit 2}}
- {{benefit 3}}

## 📏 Success Metrics (if implemented)

- [ ] {{metric}} (baseline: {{value}} → target: {{value}})

## 🧩 Implementation Considerations

- {{consideration 1}}
- {{consideration 2}}
- {{consideration 3}}

## 🔍 Alternatives Considered

- {{option}} → {{tradeoffs}}

## ⚠️ Risks / Mitigations

- {{risk}} → {{mitigation}}

## 🔗 Discussion Notes

{{from agent analysis or user discussion}}

---

**Note**: This is an agent-generated proposal. It requires user confirmation before being promoted to `todo/` for implementation.

