## 🎯 Goal

**Describe clearly what this issue should accomplish.**

<!-- What problem does this issue solve? -->

---

## 🧠 Context

**Explain why this issue matters in the project.**

<!-- Link to pipeline, architecture, or scientific logic if relevant -->

---

## 📦 Scope

**List precisely what is included in this issue.**

<!-- Define deliverables to avoid ambiguity -->

*

---

## ❌ Out of scope

**List explicitly what is NOT part of this issue.**

<!-- Prevents scope creep and helps break work into smaller pieces -->

*

---

## 🛠️ Proposed implementation

**Describe the planned technical approach.**

<!-- Classes, functions, modules, or overall strategy -->

*

---

## 📊 Acceptance criteria

**Define the conditions that must be met for this issue to be closed.**

<!-- Must be verifiable and measurable -->

* [ ]
* [ ]
* [ ]

---

## 🧪 Testing

**Explain how to verify that the implementation is correct.**

<!-- Unit tests, happy path, edge cases -->

*

---

## 📚 References

**Add relevant sources (scientific or technical).**

<!-- Papers, standards, documentation -->

*

---

## 🧩 Related issues

**List related issues or dependencies.**

<!-- Dependencies or logical continuity -->

*
