# MVP Scope

The minimum viable product is the smallest **complete and learnable** version of [PROJECT NAME]. It must solve one real problem end to end; it is not a collection of unfinished screens.

[Kit README](README.md) · [Project Overview](Project%20Overview.md) · [PRD](Full%20PRD%20Template.md) · [Master Build Prompt](Master%20Build%20Prompt.md) · [Completion Checklist](Project%20Completion%20Checklist.md)

## MVP Thesis

We believe **[TARGET USERS]** will use **[PROJECT NAME]** to **[CORE OUTCOME]** because **[EVIDENCE]**. We will know this is useful when **[BEHAVIORAL TARGET]** occurs within **[TIME WINDOW]**, while remaining inside **[COST, SAFETY, AND QUALITY LIMITS]**.

## Included Capabilities

### 1. Home page

- User and trigger: [WHO / WHEN]
- Smallest complete behavior: [DESCRIPTION]
- Acceptance evidence: [TEST, LOG, SCREENSHOT, OR REVIEW]
- Required states: ready, in progress, success, empty where relevant, and recoverable failure

### 2. One reusable content template

- User and trigger: [WHO / WHEN]
- Smallest complete behavior: [DESCRIPTION]
- Acceptance evidence: [TEST, LOG, SCREENSHOT, OR REVIEW]
- Required states: ready, in progress, success, empty where relevant, and recoverable failure

### 3. About or proof page

- User and trigger: [WHO / WHEN]
- Smallest complete behavior: [DESCRIPTION]
- Acceptance evidence: [TEST, LOG, SCREENSHOT, OR REVIEW]
- Required states: ready, in progress, success, empty where relevant, and recoverable failure

### 4. Contact path

- User and trigger: [WHO / WHEN]
- Smallest complete behavior: [DESCRIPTION]
- Acceptance evidence: [TEST, LOG, SCREENSHOT, OR REVIEW]
- Required states: ready, in progress, success, empty where relevant, and recoverable failure

### 5. Responsive navigation

- User and trigger: [WHO / WHEN]
- Smallest complete behavior: [DESCRIPTION]
- Acceptance evidence: [TEST, LOG, SCREENSHOT, OR REVIEW]
- Required states: ready, in progress, success, empty where relevant, and recoverable failure

### 6. Basic SEO, accessibility, analytics, and performance checks

- User and trigger: [WHO / WHEN]
- Smallest complete behavior: [DESCRIPTION]
- Acceptance evidence: [TEST, LOG, SCREENSHOT, OR REVIEW]
- Required states: ready, in progress, success, empty where relevant, and recoverable failure


## Excluded from Version 1

| Deferred Item | Why Now Is Too Early | Evidence Required to Reconsider |
| --- | --- | --- |
| CMS authoring | Does not block the primary learning loop | [USER DEMAND, FAILURE DATA, OR CAPACITY] |
| multilingual content | Does not block the primary learning loop | [USER DEMAND, FAILURE DATA, OR CAPACITY] |
| site search | Does not block the primary learning loop | [USER DEMAND, FAILURE DATA, OR CAPACITY] |
| personalization | Does not block the primary learning loop | [USER DEMAND, FAILURE DATA, OR CAPACITY] |
| advanced experimentation | Does not block the primary learning loop | [USER DEMAND, FAILURE DATA, OR CAPACITY] |

## End-to-End Demo Script

1. Start from a clean account, device, dataset, or project state.
2. Enter as **[PRIMARY USER]** with only documented prerequisites.
3. Complete **[CORE FLOW]** using realistic sample data clearly labeled as sample.
4. Demonstrate one invalid input or failure and recover without losing valid work.
5. Confirm saved state, authorization, expected output, and the relevant success metric.
6. Repeat on the primary supported device or environment.

## Release Guardrails

- [ ] No unresolved high-severity issue involving unclear positioning or oversized media.
- [ ] The core flow contains no fake buttons or “coming soon” actions presented as working.
- [ ] Operating cost and external-service limits are documented.
- [ ] A rollback, backup, or recovery method appropriate to the project exists.
- [ ] The team can explain exactly what was learned from releasing this MVP.

## Change Control

After scope freeze, a new request must state the user problem, expected evidence, delivery cost, new risks, and what current item will move out. The project owner records the decision in [Project Overview](Project%20Overview.md).
