# Project brief

> Template for the project brief - problem, users, goals, non-goals, scope, success measures, constraints and risks, agreed before any spec or code.

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

```md title="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
- [ ] …
```