Skip to main content
This file defines a standard Markdown issue template for work items.
It can be used in GitHub, Linear descriptions, or anywhere a structured issue is helpful. 
## Title

TYPE: Short, action-focused summary
Example: `FEATURE: Add basic CSV ingestion`

---

## Summary

Briefly describe what this issue is about.

---

## Motivation

Why is this needed?
How does it help the user, the product, or the system?

---

## Scope

What is included in this issue?
What is deliberately out of scope?

---

## Acceptance criteria

- [ ] Condition 1
- [ ] Condition 2
- [ ] Condition 3

---

## Implementation notes (optional)

Short outline of how you expect to implement this.
Mention shared packages, components, or patterns to reuse.

---

## Risks / unknowns (optional)

- Possible edge cases
- Unclear dependencies
- Things to validate first

---

## Links

- Related docs
- Screenshots
- GitHub or Linear references

---

## Types

Prefix the title with one of:

- `FEATURE`
- `BUG`
- `CHORE`
- `DOCS`
- `RESEARCH`
Keeping a consistent structure makes issues easier to understand and track over time.