A useful prompt is a small brief. Start by saying what you want to accomplish, provide the material the assistant should use, and define what a good answer looks like. You do not need an elaborate persona or a page of instructions to begin.
The five parts of a usable brief
Our working template separates goal, context, inputs, constraints and output. This is an editorial organizing method, rather than a promise that every model will follow every instruction correctly.
| Part | What to include | Example |
|---|---|---|
| Goal | The decision or deliverable you need | Plan five articles for a small gardening newsletter |
| Context | Audience and situation | Readers live in apartments and have little outdoor space |
| Inputs | Material the answer should use | A list of reader questions and available photographs |
| Constraints | Limits and important requirements | No unverified product claims; two hours of production per article |
| Output | A structure you can review | A table with title, reader problem, evidence needed and next step |
A worked example
Goal: Create a five-article plan for an apartment-gardening newsletter. Context: Readers are beginners with small balconies. Inputs: Use the reader questions pasted below. Constraints: Do not invent survey findings, product tests or expert quotes. Output: Return a table with a working title, reader problem, evidence needed and next action. If a missing detail changes the plan, identify it before choosing an answer.
The useful improvement here is specificity. A reviewer can now ask whether each article solves an actual question, whether the evidence is available, and whether the work fits the production limit. A polished title alone would not answer those questions.
Give an example when the format matters
If you want a particular tone or table structure, include a short example using different subject matter. Label it as an example so the assistant does not treat the sample facts as source material for the task. Check that your examples are consistent with your instructions.
Revise one thing at a time
When the result misses the mark, identify the specific failure. Was the audience unclear? Was essential context absent? Did the answer use the wrong format? Change that part of the brief and compare the next result against the same criteria. This makes the process easier to learn from than adding more emphatic instructions.
Keep verification separate
A well-formatted response can still contain inaccurate facts. Verify quotations, calculations, links and time-sensitive statements before using them. Avoid putting private or confidential material into a tool unless you understand its data settings and have permission to share that material.
Try the ShamsMag prompt builder to assemble your first brief. Then edit the output so it reflects the actual task rather than accepting a generic template unchanged.
Reference and editorial note
Google's official prompt design guide discusses clear instructions, context, examples and iteration. The newsletter example and five-part worksheet above are ShamsMag editorial examples. This guide does not claim a benchmarked improvement or a guaranteed result.
