[Feature name]
1. Overview
One or two sentences: what we're building and why now.
2. Problem and evidence
What problem are customers having? Link every claim to its evidence: calls, tickets, Slack threads, deals.
- [Evidence 1: source and link]
- [Evidence 2: source and link]
3. Goals and success metrics
- Goal: [what changes for the customer]
- Metric: [how you'll know, with a target]
4. Users and use cases
- As a [role], I want [action] so that [outcome].
- As a [role], I want [action] so that [outcome].
5. Requirements
- Must: [requirement]
- Should: [requirement]
- Won't (this time): [requirement]
6. Out of scope
What this project deliberately does not cover, so nobody assumes it does.
7. Design notes
Link mock-ups and describe the key screens or flows.
8. Technical notes and estimate
Systems touched, dependencies, risks, and a size estimate (S / M / L) with a range.
9. For AI coding agents
- Acceptance criteria: [testable statements]
- Files and services to start from: [paths]
- Constraints: [what not to change]
10. Open questions and decisions
- Question: [open question] (owner, due date)
- Decision: [what was decided, by whom, when]
11. Launch plan
Rollout steps, who needs to know, and which customers to tell when it ships.