Show the AI what went wrong
The best bug report says what you did, what you expected and what actually happened.
Give the AI enough evidence to fix a specific problem without rebuilding everything.
Let’s do this
- 1In your browser
Repeat the problem once
Write down the page, the button or input, and the exact steps. For example: “On the plant list, I type Basil and press Add twice. I expected one plant but get two.” Say whether this is the local preview or the live site.
- 2On your Mac
Attach what you can see
Use Shift + Command + 4 to capture the problem area, then attach the screenshot to the coding session. If there is an error in the preview terminal, copy the relevant error text. Remove passwords, keys and personal records from anything you share.
- 3In your AI helper
Ask for a small fix
Have the AI inspect the cause, explain it simply and change only what is needed. Ask it to preserve the parts that work and run the relevant check. Do not restart the entire website because one field is wrong.
- 4In your browser
Try the same steps again
Repeat your original report exactly, then try a nearby case such as an empty name. When it works, save a new version in the following lesson. If it still fails, report the new result in the same task.
A message for your AI helper
In my first website, on [page], I did [exact steps]. I expected [result], but saw [actual result]. This is [local preview / live site]. Here is the screenshot or error: [attach or paste]. Inspect the cause before editing. Make the smallest useful fix, keep working features, run the relevant checks and tell me exactly how to retest.
What you should see
You can reproduce the original problem, confirm the fix and explain what changed.
If you get stuck
Checked 7 September 2026. Screens can change; the official guides below have the latest steps.
Anthropic: Claude Code on desktopOpenAI: desktop setup