The Workflow Edit | Practical AI Tool Tutorial
How to Use Amazon Q Developer Without Generic AI Instructions
Amazon Q Developer is an AI assistant built into AWS and your IDE. It works best when you paste the real error, name the region and resource, and ask why — not just how.
Dear Suzannah
Dear Suzannah, I’m stuck on an AWS error I half understand and the docs page is longer than the error message itself. How do I get help that actually points at my account and my code instead of a generic tutorial?
Ask inside the AWS context, with your real error and resource.
The real use case
You’re a developer or ops person working in AWS and you hit an error, a config question, or a ‘how do I do X in my account’ problem. You need an answer tied to your actual resources and code, not a generic blog post.
The tool-specific prompt to use
This prompt is specific to Amazon Q Developer and this use case. Paste it into the chat box, then replace the bracketed notes with your real project details.
I hit this error in AWS: [paste the full error message, not a summary]. Resource affected: [resource name or ARN]. Region: [e.g. us-east-1]. What I was trying to do: [the exact goal, e.g. 'let my Lambda read from an S3 bucket']. Give me: the most likely cause, the exact fix step by step, and why it works (not just the how). If the fix involves IAM, give me the least-privilege policy — not a wildcard one. Cite the AWS docs page I should read to confirm. If there are two likely causes, rank them by likelihood and give the fix for each. Do not give a generic tutorial. Do not invent services or console paths that don't exist. Flag anything that would change my bill or open a public endpoint. End with the one check I should run to confirm the fix worked.
Prompt length: about 200 words.
Make the result less generic
- Paste the full error message, not your summary of it.
- Name the region and the exact resource (ARN if you have it).
- Ask why the fix works, not just the steps.
- Request the least-privilege IAM policy, never a wildcard.
- Open the docs link it gives you and confirm.
Quick human check
- Is the fix tied to your real resource and region?
- Does it explain why, not just how?
- Is any IAM policy least-privilege?
- Is the docs link it cites valid?
- Is it safe to apply in your account (no public endpoint, no bill surprise)?
