# {{title}}

**Type:** feature  
**Status:** todo  
**Branch:** feat/{{scope}}-{{slug}}  
**Linked roadmap section:** {{phase}}

---

## 🧠 Context
{{short background}}

## 🎯 Goal
{{clear description of what needs to change}}

## 📏 Success Metrics
- [ ] {{metric 1}} (target: {{value}})
- [ ] {{metric 2}} (target: {{value}})

## 🧩 Acceptance Criteria
- [ ] Behavior matches specification and edge cases covered
- [ ] Unit/integration tests for success and failure paths
- [ ] Documentation updated (README, architecture, examples)
- [ ] CHANGELOG entry added

## 🧪 Implementation Steps
1. Create/switch to branch `feat/{{scope}}-{{slug}}`
2. Write minimal prototype or stub
3. Add tests first (happy + failure cases)
4. Implement and refactor toward abstractions (Factory/Strategy/Adapter as applicable)
5. Update docs and examples
6. Move this file to `in_progress/` then `done/`
7. Create PR referencing this issue

## 🚫 Out of Scope
- {{items}}

## 🔬 Risks / Mitigations
- {{risk}} → {{mitigation}}

## 🔗 Discussion Notes
{{from exploration}}


