Shipping
The Art of the Ask: Prompting as a Product Discipline

A weak AI answer is often blamed on the model when the real problem started one step earlier. The request was vague, the source material was incomplete, or nobody defined what a usable answer should contain.
That is why I think prompting belongs closer to product specification than copywriting. A useful prompt tells the system what job it is doing, what evidence it may use, which boundaries matter, and how the result will be judged. Better wording can help, but wording alone cannot repair an undefined task.
My operating rule is simple: if two teammates would interpret the request differently, the model probably will too. Before rewriting the prompt for the fifth time, make the task inspectable.
A prompt is an interface to a decision
Product managers rarely ask AI for text in isolation. We ask it to turn research into themes, turn a rough note into a requirement, compare options, identify gaps, or prepare a decision artifact. Each output sits inside a workflow.
The vague ask
“Summarize these interviews.”
The model can comply while producing something useless. It does not know whether I need an executive brief, recurring problems, evidence for a roadmap decision, or a record of every disagreement.
The ask that names the decision
A request tied to what happens next
“Analyze these interview notes to help us decide whether onboarding confusion is severe enough to change the next release. Group repeated problems, preserve contradictory evidence, cite the passage behind each theme, and separate observation from interpretation.”
The current OpenAI prompt engineering guide, Anthropic prompt engineering overview, and Google Gemini prompt strategies all emphasize some combination of clear instructions, relevant context, examples, structured output, and evaluation. These are vendor guides, so their model-specific advice will change. The durable pattern is that an ambiguous request needs a better contract, not a more theatrical command.
The Prompt Contract has six fields
A compact artifact I call the Prompt Contract can fit in a ticket, a test fixture, or the top of a working document.
The Prompt Contract
- Task: what job should the system complete?
- Decision: what will a person do with the result?
- Context: which facts, examples, and definitions does the system need?
- Constraints: what must it avoid, preserve, or ask about?
- Output: what structure makes the answer usable in the next step?
- Acceptance test: what observable conditions distinguish a pass from a polished failure?
For a requirement draft, the acceptance test might require a named user, problem, scope boundary, failure state, and unresolved question. For a research synthesis, it might require source citations, contradictory evidence, sample limitations, and a clear separation between what participants said and what the team inferred.
The contract also exposes missing inputs. If the task requires comparing customer segments but the notes do not identify segments, the system should not quietly invent them. The correct output may be a question or a visible gap.
Examples teach the boundary faster than adjectives
Words such as "strategic," "concise," or "executive-ready" are open to interpretation. One good example and one unacceptable example can define the boundary more clearly.
For a roadmap risk summary, a good example might connect a specific dependency to a user consequence and an owner. A bad example might say only that execution could be challenging. The contrast teaches the system what the team considers decision-grade.
Examples should not become a hidden template that forces every answer into the same shape. They are evidence about the task. Use them to show difficult distinctions: observation versus recommendation, user request versus underlying problem, or reversible experiment versus production commitment.
When examples contain customer or company information, sanitize them and preserve only what the task needs. More context is not automatically better context. A prompt that includes an entire internal document can increase privacy risk and distract the model with irrelevant detail.
Ask for inspectable work, not private reasoning
Asking a model to reveal private reasoning is not a quality shortcut. A long explanation can sound rigorous without being accurate, and hidden model reasoning is not a product control.
Ask for material a reviewer can inspect instead:
- the assumptions that affect the answer;
- the evidence used for each material claim;
- calculations or transformations that can be reproduced;
- uncertainty and missing information;
- a concise rationale tied to the stated criteria.
This shifts review from whether the model sounds thoughtful to whether the answer can be checked. For high-consequence work, the system should cite the relevant source and make unsupported claims easy to reject.
Prompt iteration needs a case set
One successful response proves very little. Model behavior varies, and a prompt can improve a favorite example while breaking another.
Keep a small case set with common, ambiguous, edge, and adversarial inputs. Record the expected characteristics of a good result and the failures that block use. Then compare prompt versions across the same cases.
The measures do not need to be sophisticated. Track factual preservation, unsupported claims, required edits, task completion, latency, and reviewer agreement. The point is to stop optimizing by memory. Without a stable case set, every prompt change becomes a new demo.
This is also where prompting meets product operations. A prompt, model, retrieval source, tool configuration, and output schema form one release unit. Changing any part can change behavior. The AI Feature Ship Gate explains how to turn that behavior into a reproducible launch decision.
Do not turn every request into a specification ceremony
There is a reasonable counterargument: a six-field contract is excessive when someone wants a headline or a quick rewrite. That is true. The amount of structure should match the consequence and repeatability of the task.
For a disposable, low-risk request, a sentence may be enough. Add structure when the answer will be reused, automated, sent externally, evaluated by several people, or used to make a consequential decision. The more often a task runs, the more valuable a stable contract becomes.
The art of prompting is not learning a secret vocabulary. It is deciding what the work means before asking a probabilistic system to do it. Name the task, provide the right evidence, define the boundary, and test the result against the job. The prompt gets better because the product thinking got better first.


