A useful prompt gives an agent enough information to act and enough evidence to know whether it succeeded. It does not need elaborate role-play or a page of motivational instructions. This guide turns 'analyze our marketing' into a small project brief you can reuse. The same structure works for a website, a business-intelligence report or a research comparison. Keep it short enough to maintain as the task changes.
What you will leave with
An editable brief with a real audience, bounded scope, relevant inputs and a definition of done that you can actually check.
Step 1
Start with the person and the useful outcome
Describe who will use the result and what they should be able to do. For a marketing report: a manager needs to identify which campaigns need investigation and why. That is more actionable than asking for something modern or professional. For a research task: you need to choose among three options by a stated criterion. Naming the decision helps the agent distinguish essential work from attractive extras.
You can finish this sentence: after using the result, this person can do this specific thing.
Step 2
Provide the facts the agent cannot infer
Include the approved sample export, date range, metric definitions, real source links and any existing project instructions. Label sample information as sample. Point to the exact files or documents instead of saying 'use the usual details.' If a fact is missing, ask the agent to identify it or use a clearly marked temporary example in a private draft. Do not let an invented metric, customer claim or causal explanation become a recommendation.
Required facts have a source, and the brief distinguishes missing information from approved content.
Step 3
Choose the smallest complete version
Define one useful path through the result. A first report can reconcile one export and identify three questions; it does not need a live dashboard, new connectors or automated budget changes. List any explicit exclusions that would otherwise be tempting. Ask the agent to explain the cost or complexity of a proposed addition before expanding the project. Small scope makes it easier to inspect the result and recover from errors.
The first version solves the main job without depending on optional future features.
Step 4
Set practical boundaries and ownership
Name the project folder, editable outputs and permitted tools. Specify whether the task ends with a draft, a local preview or a public release. For everyday work, say whether calendar changes, messages or purchases are included. For code, preserve existing instructions and other people's uncommitted changes. Text instructions communicate intent; use available account permissions and tool controls when a boundary must be enforced. A prompt is not an access-control system.
The agent knows which actions can proceed and which would change the agreed scope.
Step 5
Replace vague quality words with checks
Instead of 'find insights,' require that totals match the source, rates use the correct denominator and comparisons use the same dates and metric definitions. Separate observations, explanations and recommended next checks. For a page, require working links and a usable phone layout. For a brief, require sources for external claims and a list of unknowns. Select checks that matter to the outcome; a large arbitrary checklist can hide the important failures.
Each success criterion can produce observable evidence rather than only the agent's opinion.
Step 6
Use a reusable brief and a concrete example
Copy the template below, fill only what matters and ask the agent to identify material ambiguity before making dependent changes. A good example pairs input with expected output: 'This sample campaign export should become a one-page brief whose totals reconcile and whose recommendations cite evidence.' Ask for a small plan when the task has meaningful choices. Once the plan fits, let the agent execute and check the agreed work without repeatedly re-approving ordinary edits.
Try this instruction
Outcome: Create a one-page marketing performance brief. Audience: A manager deciding what to investigate next. Inputs: Use the supplied sample export, dates and metric definitions. Flag missing facts. Scope: Reconcile totals, explain observed changes and suggest three checks. No live account changes. Allowed work: Read the sample files and write a draft in this project. Do not publish or send it. Done when: Totals match the source; rates use the right denominator; factual claims have sources; hypotheses are labeled. Return: The draft, calculations, source references, checks performed and unresolved questions.
A collaborator unfamiliar with your chat could begin from the brief alone.
Step 7
Update the brief when the decision changes
If you change the audience or add a feature, update the actual brief and identify which earlier instruction it replaces. Ask the agent to summarize the effect on scope before continuing dependent work. Keep a short decision note explaining why the change matters. At completion, compare the artifact with the latest brief and save both. A reusable workflow is the version that worked, including its limits, not every instruction tried along the way.
The final result and the current brief agree, and later helpers can identify the authoritative version.
When you get stuck
The result is polished but solves the wrong problem
Restate the audience and the one action they need. Remove features unrelated to that outcome.
The agent invents missing details
Supply the source or mark the fact unknown. Ask for unresolved questions in the handoff.
Every correction creates a larger rewrite
Name the exact change and preserve the parts that already meet the brief. Check the resulting diff.
Terms explained
- Scope
- The agreed work included in this version, together with relevant boundaries.
- Acceptance check
- An observation that shows whether the intended behavior is present.
- Context
- The relevant facts, examples and constraints needed to make a good decision.
Sources and further reading
The workflow and templates are teaching guidance. The sources below support the underlying tools and concepts; product setup and availability can change.
Take it into your next task
Your completion checklist
0 / 7 checked
Checks are saved on this browser. Mark them only after you inspect the evidence. These are your checks, not an automated certification.