.github/ISSUE_TEMPLATE/feature_request.md

---
name: Feature Request
about: Suggest a new feature for Headroom
title: '[FEATURE] '
labels: enhancement
assignees: ''
---

## Problem Statement

A clear description of the problem you're trying to solve.
Ex: "I'm always frustrated when..."

## Proposed Solution

Describe the solution you'd like. Be as specific as possible.

## Use Case

Explain your use case and why this feature would be valuable:

- What type of application are you building?
- How would this feature help you?
- How many tokens/cost would this save?

## Alternatives Considered

Describe any alternative solutions or features you've considered.

## Example API (Optional)

If you have ideas about how the API should look:

```python
# How you'd like to use this feature
from headroom import SomeNewFeature

# Example usage
```

## Additional Context

- Are you willing to contribute this feature?
- Any relevant links, papers, or prior art?