# Real-User Acceptance Scenarios

These prompts state the user's goal, not a screen specification. None is hard-coded into the plugin.

## 1. Find Calendar Time Safely

Design: `shadcn-ui`

> Look at my availability next week and find three 90-minute windows for focused writing. Keep private event titles out of the answer. I do not want a button for every 15-minute start time; show only two or three useful choices per day. Do not create anything until I confirm the exact times.

Acceptance:

- Reads real calendar availability without exposing unrelated event content.
- Shows a small set of non-overlapping options inside working hours.
- Saves the selected times and reads them back on the next turn.
- Requests explicit confirmation before writing, then verifies the created events through the same calendar connection.

## 2. Explore What Limits Photosynthesis

Design: `material-3`

> I keep thinking photosynthesis means a plant uses sunlight to make sugar directly, but my teacher says the light reactions and Calvin cycle are different. Help me understand which step becomes limiting when light, carbon dioxide, temperature, or stomatal opening changes. I want to change the conditions myself and watch energy and matter move through the system.

Acceptance:

- Explains the causal chain in concise prose before the app.
- Uses one control group, one main model, and one changing takeaway.
- Persists all four controls.
- Explains the exact saved conditions on the next turn.

## 3. Build an Intuition for the Milky Way

Design: `material-3`

> I know the Sun is inside the Milky Way, but I have no intuition for the scale. Where is the Sun, how far away is the center, and how many orders of magnitude separate nearby stars from the whole galaxy? Take me from the Solar System outward. I want to change the scale and viewpoint, compare light-travel times, and understand how we infer the galaxy's shape from inside it. Do not just list facts.

Acceptance:

- Keeps the observational explanation in prose.
- Provides a logarithmic scale, multiple viewpoints, and meaningful landmarks.
- Persists the scale, viewpoint, and selected target.
- Translates saved values into natural language on the next turn without exposing internal keys.

## 4. Trace Real Code From the CLI

Design: `shadcn-ui`

> Explain how a stable local app URL resolves the current ready version in this project and how a user's selection becomes readable on the next Agent turn. Generate a GenUI for this CLI workflow, map every step to the real source file and function, and return a localhost browser URL. I will ask about the path I select afterward.

Acceptance:

- Requires an explicit GenUI request; an ordinary code explanation stays in prose.
- Grounds every step in code inspected from the current repository.
- Returns one stable loopback URL without opening the browser automatically.
- Persists the selected path and reads it on the next turn.
- Keeps the same URL after a successful update and serves the last-good version after a failed update.

## Negative Control: Stay With Prose

> Rewrite this notice so it sounds natural: We will have the weekly meeting tomorrow at 3 PM. Please prepare your progress for this week in advance.

Acceptance: returns prose only. An interface would add friction.