# [Product Name] ... Roadmap

**Last updated:** YYYY-MM-DD
**Current version:** vX.Y.Z

Items are either **Upcoming**, **Done**, or **Deprecated**. Never delete. Always move.

---

## What This File Is

The prioritized roadmap for this product. Three sections:

- **Upcoming** ... work that's planned, ordered by priority. Top = most important.
- **Done** ... shipped work. Moved here with a date when it's released.
- **Deprecated** ... planned work that's no longer needed. Strikethrough, add the reason and date. Not the same as Done. Done means it shipped. Deprecated means the plan changed.

**Keep it honest.** If something isn't going to happen, deprecate it. Don't leave dead items in Upcoming.

**Keep it prioritized.** Upcoming items have priority numbers. When priorities shift, renumber them. The order is the strategy.

---

## Vision

_One paragraph. Where is this product going? Not the feature list. The north star._

---

## Upcoming

### Priority 1 ... [Feature/Epic Name]

_What it is and why it matters in 1-2 sentences._

- [ ] Task one
- [ ] Task two
- [ ] Task three

### Priority 2 ... [Feature/Epic Name]

_What it is and why it matters._

- [ ] Task one
- [ ] Task two

_Add more priorities as needed. Number them. The number is the priority._

---

## Done

### [Feature Name] (YYYY-MM-DD)

- [x] What shipped
- [x] What shipped

_Move items here when they're released. Include the date. Keep the checkbox format so it's clear what was planned vs what actually shipped._

---

## Deprecated

- ~~[Feature that was planned]~~ ... reason it was dropped. (YYYY-MM-DD)

_Deprecated is not a graveyard. It's a record of decisions. When someone asks "why didn't we build X?" the answer is here._

---

## How to Update This File

- **Shipped a feature?** Move it from Upcoming to Done. Add the date. Check the boxes.
- **Dropped a plan?** Move it to Deprecated. Strikethrough, add the reason and date.
- **New idea that's ready to plan?** Add to Upcoming with a priority number. Renumber if needed.
- **Idea that's NOT ready to plan?** Put it in `../product-ideas/` instead. The roadmap is for committed work.
- **Priorities shifted?** Renumber the Upcoming section. The order matters.
- **Always update** "Last updated" and "Current version" at the top.
