# Feature Proposal: {{titleCase FEATURE_NAME}}

> Proposal for a new feature. This document describes WHAT and WHY.
> For technical details, see `spec.md`.

## Metadata

| Field | Value |
|-------|-------|
| **Proposed** | {{DATE}} |
| **Author** | {{AUTHOR}} |
| **Status** | Draft / Under Review / Approved / Rejected |
| **Priority** | High / Medium / Low |
{{#if STACK}}| **Stack** | {{STACK}} |{{/if}}

---

## Overview

{Brief 2-3 sentence summary of the feature}

---

## Acceptance Criteria

Verifiable conditions that mean this feature is done:

- [ ] {Criterion 1 — observable / testable}
- [ ] {Criterion 2}
- [ ] {Criterion 3}

---

## Problem Statement

### What is the problem?

{Describe the problem this feature solves. Be specific.}

### Who is affected?

{Who suffers from this problem? End users? Developers? Operations?}

### What is the impact?

{What is the impact of NOT solving this problem?}
- User productivity loss: {X}
- Revenue/Cost impact: {X}
- User satisfaction: {X}

---

## Proposed Solution

### Overview

{Describe the proposed solution in 2-3 paragraphs}

### Key Features

1. **{Feature 1}** - {brief description}
2. **{Feature 2}** - {brief description}
3. **{Feature 3}** - {brief description}

{{#if (eq STACK "nextjs-neon")}}
### Technical Approach

| Layer | Technology | Role |
|-------|-----------|------|
| **Database** | Neon (PostgreSQL + RLS) | {tables, policies, storage} |
| **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
| **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
| **Infra** | Coolify + Docker | {deployment, SSL} |
{{/if}}

### User Journey

```
1. User {initial action}
2. System {response}
3. User {next action}
4. System {final result}
```

---

{{#if (eq STACK "nextjs-neon")}}
## Cost Estimate

| Resource | Provider | Monthly Cost | Notes |
|----------|----------|-------------|-------|
| Neon | Free / Launch | $0 - $19 | {DB, Connection Pooling, Branching} |
| VPS (Coolify) | {provider} | ${X} | {API + Web containers} |
| External APIs | {provider} | ${X} | {if applicable} |
| **Total** | | **${X}/month** | |

---

{{/if}}
## Success Metrics

How will we know this feature is successful?

| Metric | Current | Target |
|--------|---------|--------|
| {Metric 1} | {X} | {Y} |
| {Metric 2} | {X} | {Y} |

---

## Scope

### In Scope

- {Item 1 that is included}
- {Item 2 that is included}
- {Item 3 that is included}

### Out of Scope

- {Item 1 that is NOT included}
- {Item 2 that is NOT included}

### Future Considerations

- {Item that could be added later}

---

## Risks & Concerns

| Risk | Likelihood | Impact | Mitigation |
|------|------------|--------|------------|
| {Risk 1} | High/Med/Low | High/Med/Low | {mitigation strategy} |
| {Risk 2} | High/Med/Low | High/Med/Low | {mitigation strategy} |

---

## Dependencies

- [ ] {Dependency 1} - {status}
- [ ] {Dependency 2} - {status}

---

## Estimated Effort

| Phase | Estimate |
|-------|----------|
| Design & Spec | {X}h |
{{#if (eq STACK "nextjs-neon")}}| Database & Migrations | {X}h |
| Backend API | {X}h |
| Frontend | {X}h |
{{else}}| Implementation | {X}h |
{{/if}}| Testing | {X}h |
| **Total** | **{X}h** |

---

## Questions & Clarifications

1. {Question 1 that needs answering}
2. {Question 2 that needs answering}

---

## Next Steps

Once approved:
1. Create detailed `spec.md` with technical design
{{#if (eq STACK "nextjs-neon")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
3. Record decisions in `decisions.md`
4. Break down into `tasks.json`
5. Begin implementation
{{else}}2. Break down into `tasks.json`
3. Begin implementation
{{/if}}

---

*Created with MORPH Framework*