Skip to content

Project brief

View Markdown

Write this first and agree on it before the spec. Copy to docs/project-brief.md.

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. Goals
1. <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
- [ ] …