PRD Template

Copy the raw Markdown below into docs/specs/your-feature-name.md.

---

---
id: your-feature-name
title: "Feature Name"
description: "One-sentence description"

status: draft          # draft | in-review | approved | shipped | deprecated
owner: "@your-handle"
version: "v0.1"
created: YYYY-MM-DD
updated: YYYY-MM-DD
jira_epic: "BW-000"
ai_assisted: false     # set true if AI generated the first draft
tags: []
---

# Feature Name

<div style={{display:'flex',gap:'0.5rem',marginBottom:'1.5rem',flexWrap:'wrap'}}>
  <span className="badge badge--draft">Draft</span>
  <span className="badge badge--secondary">vX.X</span>
  <span className="badge badge--secondary">Owner: @handle</span>
</div>

## TL;DR

One paragraph. What is this, why does it matter, when does it ship?

---

## Background

What context does the reader need? Why are we doing this now?

## Problem Statement

> One crisp sentence stating the core problem.

Who is affected? What data or signals tell us this is real?

## Goals

- [ ] Goal 1 — measurable outcome
- [ ] Goal 2
- [ ] Goal 3

## Non-Goals

- Not doing X (deferred to v2)
- Not doing Y (tracked in [LINK])

## Success Metrics

| Metric | Baseline | Target | Measurement |
|---|---|---|---|
| Metric 1 | — | X% | How we'll measure |

## User Stories

```
As a [persona],
  I want to [action]
  so that [outcome].
```

## Solution Overview

High-level description of the solution. Diagrams encouraged.

```mermaid
graph LR
    A[User] --> B[Feature] --> C[Outcome]
```

## Detailed Requirements

### Functional

| ID | Requirement | Priority |
|---|---|---|
| F-01 | Description | Must |
| F-02 | Description | Should |
| F-03 | Description | Nice-to-have |

### Non-Functional

| Requirement | Target |
|---|---|
| Performance | P95 < Xms |
| Availability | 99.9% |
| Security | Auth required |

## Edge Cases

| Scenario | Expected behaviour |
|---|---|
| Scenario 1 | Handling |

## Open Questions

- [ ] **@person** — Question that needs answering before approval?

## Alternatives Considered

| Option | Pros | Cons | Decision |
|---|---|---|---|
| Option A | ... | ... | ✅ Chosen |
| Option B | ... | ... | ❌ Rejected |

## Milestones

```mermaid
gantt
    title Feature Rollout
    dateFormat  YYYY-MM-DD
    section Backend
    Task 1    :des1, YYYY-MM-DD, 7d
    section Frontend
    Task 2    :des2, after des1, 5d
    section Release
    Beta      :des3, after des2, 3d
```

---

*Last updated by @handle on YYYY-MM-DD*