# Project brief: [product / initiative]

**State:** Proposed / Approved / In progress (choose only one if supported)

## Project identity and coordination (when relevant)

- Stable project ID and display name:
- Member repositories and their roles:
- Coordination repository / authoritative product design:
- Delivery boards and the distinct purpose of each:
- Scope exclusions and shared/upstream ownership:

## Problem and audience

- Problem to solve:
- Primary users / stakeholders:
- Why now / expected value:

## Goals and acceptance

| ID | Goal or requirement | Source / certainty | Observable acceptance criterion |
|---|---|---|---|
| R1 | [behavior] | [confirmed / assumed / TBD] | [test or measured outcome] |

## Non-goals

- [Explicitly excluded work]

## Use cases and key flows

1. [User action -> expected visible outcome]
2. [Exception/error case -> expected outcome]

## Constraints

- Platform/stack/team/deadline:
- Performance, reliability and scale:
- Privacy, compliance and data/tenant isolation:
- Cost and operational constraints:

## Risks and assumptions

| Risk or unknown | Impact | Mitigation / decision owner |
|---|---|---|
| [unknown] | [impact] | [next step] |

## Rollout / success measures

- First useful milestone:
- Success signal:
- Out-of-scope follow-ups:

## References

- [Relevant existing code / issue / ADR / source links]