Project brief
Write this first and agree on it before the spec. Copy to docs/project-brief.md.
# Project brief — <project>
**Owner:** <name> · **Date:** YYYY-MM-DD · **Status:** draft | agreed
## 1. Problem<What problem exists today, for whom, and how we know. 3–6 sentences. Evidence, not assumptions.>
## 2. Users| User | Situation | What they need ||---|---|---|| <primary> | <context: device, place, skill level> | <job to be done> || <secondary> | | |
**Not for:** <who this deliberately does not serve>
## 3. Goals1. <outcome, measurable>2. …
## 4. Non-goals- <things we are explicitly not doing in this version>
## 5. Scope (version 1)| In | Out (later or never) ||---|---|| | |
## 6. Success measures| Measure | Target | How measured | When ||---|---|---|---|| | | | |
## 7. Constraints- Budget / time: <…>- Legal / compliance: <privacy, health, finance, children…>- Technical: <must run on…, must integrate with…>- Brand / content: <…>
## 8. Risks and open questions| Risk or question | Impact | Owner | Resolution ||---|---|---|---|
## 9. Decisions needed before build- [ ] <stack> → ADR- [ ] <hosting> → ADR- [ ] …