Diagnostic Package (Bolt → Claude)

The structured format for transferring a stuck Bolt problem to Claude.ai for diagnosis. Provides Claude with the four elements needed for accurate root-cause analysis: problem description, error message, relevant files, and fix history.

Syntax

bolt-new

PROBLEM:
[Exact symptom — what you see vs. what you expect]

ERROR MESSAGE:
[Full error text + stack trace if available]

RELEVANT FILES:
[Contents of 2-4 files most involved in the problem]

WHAT BOLT HAS TRIED:
[List the last 3-5 fix attempts Bolt made]

QUESTION:
What is the root cause and what is the minimal correct fix?

Example

bolt-new

PROBLEM:
Task list does not re-render after marking a task complete.
The Supabase update succeeds (confirmed in DB), but the UI
still shows the task as incomplete until I refresh the page.

ERROR MESSAGE:
No console errors.

RELEVANT FILES:
[TaskList.tsx — paste]
[useTasks.ts — paste]
[tasks.service.ts — paste]

WHAT BOLT HAS TRIED:
1. Added .refetch() call after mutation resolves
2. Changed queryClient.invalidateQueries key from "tasks" to ["tasks"]
3. Moved the mutation call inside the component

QUESTION:
What is causing the stale UI and what is the minimal fix?