The AI Agent Prompt Pack: 15 Prompts for Agents
Most builders are asking "how do I add an agent to my product?" The better question is "does this problem actually need an agent, and if so, which kind?"
馃搵 Read time: 14 minutes. Use time: every time you touch agentic architecture.
Why This Exists
There is a lot of excitement about AI agents right now, and most of it is pointed in the wrong direction. Teams are spinning up agents because it feels like the right thing to build, not because they have diagnosed a problem that agents specifically solve well. The result is brittle automation that breaks in production, frustrates users, and gets quietly turned off six weeks after launch.
The teams building agents that actually work have a different starting point. They begin with task structure, not technology. They ask: is this task long-horizon? Does it require tool use? Does it need judgment calls across multiple steps? Only after those questions come back "yes" do they start designing an agent. The technology follows the problem shape, not the other way around.
This prompt pack bridges that gap. These 15 prompts are organized around the full arc of working with agents, from deciding whether to build one, to designing it, to evaluating it, to explaining it to a skeptical team. Each prompt is a thinking tool, not just a query to paste. Use them with any frontier model (GPT-4o, Claude, Gemini) and adapt the bracketed fields to your context.
How to Use This
- Start with the diagnosis prompts (1-4) before you touch any code. If your problem does not survive prompt 2, you will save weeks.
- Use the design prompts (5-9) before your first architecture meeting. Come in with a first draft, not a blank whiteboard.
- Run the evaluation prompts (10-12) before you ship to production. Not after users hit the failure.
- Keep the communication prompts (13-15) handy for the moments your stakeholders get nervous. Agents make non-technical people uncomfortable. These help.
Section 1: Diagnosis Prompts (Should You Even Build an Agent?)
The most common mistake in agentic development is skipping this section entirely.
Prompt 1: The Agent Fit Test
Use this before any architectural decision. It forces you to articulate the problem in terms that expose whether agentic orchestration is actually needed.
View Prompt 1
I'm considering building an AI agent to handle [describe the task or workflow].
Analyze whether this task is a good fit for an agentic approach by evaluating it against these dimensions:
1. Task horizon: Is this a single-step task or does it require multiple sequential decisions where later steps depend on earlier outputs?
2. Tool dependency: Does completing this task require calling external tools, APIs, or data sources mid-execution?
3. Ambiguity tolerance: How much does the task require judgment calls that a deterministic script cannot handle?
4. Failure cost: If the agent makes a wrong decision mid-task, what breaks and how hard is it to recover?
5. Human-in-loop feasibility: Is a human available to check intermediate steps, or does this need to run fully autonomously?
Based on your analysis, give me a recommendation: full agent, partial agent (with human checkpoints), or deterministic automation. Explain your reasoning for each dimension.
Context:
- Task: [describe it]
- Users: [who runs this task today]
- Volume: [how often this task happens]
- Current solution: [how it works now, even if manually]
Prompt 2: The "What Could Go Wrong" Pre-Mortem
Run this the moment you have a rough agent design. It is cheaper to find failure modes in a prompt than in production.
View Prompt 2
I'm designing an AI agent that will [describe the agent's purpose and the steps it takes].
Run a failure mode analysis on this design. For each failure mode, give me:
- What goes wrong
- At what point in the task it likely fails
- How likely it is (high / medium / low) given the task structure
- Whether it's recoverable or catastrophic
- A design change that would reduce or eliminate the risk
Cover at least these categories:
1. Tool call failures (the agent calls an API that returns an error or unexpected format)
2. Context drift (the agent loses track of the original goal mid-task)
3. Hallucinated actions (the agent takes a step that seemed logical but was never valid)
4. Loop and retry storms (the agent gets stuck in a retry pattern that wastes tokens or breaks downstream systems)
5. Permission and scope creep (the agent takes actions outside its intended scope)
6. User intent misread (the task was ambiguous and the agent solved the wrong problem)
Agent design so far:
[Paste your current design, even if rough]
Prompt 3: Build vs. Buy vs. Orchestrate
The vendor landscape for agents changes every quarter. This prompt helps you evaluate what to build yourself and what to wire together.
View Prompt 3
I need to decide whether to build a custom AI agent, use an existing agent framework, or stitch together specialized tools for the following use case:
Use case: [describe it]
Team size and AI expertise: [describe your team]
Timeline: [when does this need to be in production]
Scalability requirements: [expected load, number of concurrent tasks]
Data sensitivity: [what data will the agent touch, any compliance constraints]
For each of these three paths, give me:
1. What it looks like in practice for my use case
2. The 2-3 biggest advantages
3. The 2-3 biggest risks or hidden costs
4. When this path breaks down or becomes the wrong choice
Then give me a recommendation with your reasoning. Don't hedge. Pick one and explain why the others lose for my specific situation.
Prompt 4: The Minimal Agent Definition
Before writing a single line of agent code, write the spec. This prompt generates a one-page agent definition you can actually review.
View Prompt 4
Help me write a minimal agent specification for the following task. This is NOT a system prompt. It's a one-page design document I'll use to align my team before we start building.
The spec should include:
1. Agent name and one-sentence purpose
2. Trigger: what starts the agent running
3. Inputs: what information the agent receives at start
4. Tools available: what APIs, databases, or functions the agent can call (list them)
5. Decision points: where the agent makes a judgment call (list each one and what it's deciding)
6. Outputs: what the agent produces or changes in the world when it's done
7. Termination conditions: what causes the agent to stop (success, failure, and edge cases)
8. Human handoff points: where a human should review before the agent proceeds
9. Out of scope: explicitly, what this agent will NOT do
Task: [describe it]
Available tools/APIs: [list what you have]
Constraints: [budget, latency, compliance, user-facing vs. background]
Section 2: Design Prompts (How to Structure the Agent Well)
Good agent design is mostly about deciding what the agent does NOT do.
Prompt 5: The Tool Use Design Review
The quality of an agent's tool definitions determines 80% of its reliability. Most teams underspecify their tools and pay for it in production.
View Prompt 5
Review the following tool definitions I'm passing to my AI agent and identify every way they could cause the agent to misuse them or fail.
For each tool, evaluate:
1. Is the name clear enough that the agent will call it at the right time (not too broad, not too narrow)?
2. Is the description precise enough to prevent misuse?
3. Are the parameters well-typed and described?
4. Are error states documented so the agent knows what to do when the tool fails?
5. Is the output format specified clearly enough that the agent can parse it reliably?
Then rewrite each tool definition to fix the issues you found. Keep the same underlying functionality. Only improve the clarity and safety of the definition.
My tool definitions:
[Paste your tool schemas or descriptions]
Prompt 6: The System Prompt Audit
A system prompt that works in a demo will often fail in production. This prompt stress-tests yours before users see it.
View Prompt 6
Audit the following agent system prompt for these specific failure risks:
1. Ambiguous scope: Does the prompt leave it unclear what the agent should do when it encounters an edge case?
2. Missing refusal conditions: Are there situations where the agent should stop and ask a human rather than proceed, and does the prompt specify them?
3. Persona drift: Does the prompt establish the agent's identity clearly enough that it won't start acting like a general assistant?
4. Over-instruction: Are there instructions that conflict with each other or that the agent might follow too literally in edge cases?
5. Under-instruction: What obvious situations does the prompt fail to cover?
6. Tone and escalation: Does the prompt tell the agent how to communicate when it's uncertain or when something goes wrong?
After your audit, rewrite the system prompt to address every issue you found. Flag any changes you made with a [CHANGED] marker so I can review them.
Current system prompt:
[Paste it]
Agent purpose: [one sentence]
User context: [who talks to or triggers this agent]
Prompt 7: The Multi-Step Task Decomposer
If an agent's task is too large to hold in one context window, or too risky to run in one shot, it needs to be decomposed. This prompt does that systematically.
View Prompt 7
I need to break the following complex task into a sequence of smaller sub-tasks that a multi-step agent (or multiple specialized agents) can handle reliably.
For each sub-task in your decomposition:
1. Give it a name and one-sentence description
2. Define its input (what it receives from the previous step or from the user)
3. Define its output (what it produces for the next step)
4. Identify whether it needs tool access, and which tools
5. Flag whether a human should review the output before the next step proceeds
6. Estimate the failure risk: low, medium, or high, with one sentence on why
Then draw the overall flow as a numbered sequence with branching points clearly marked (e.g., "If step 3 fails, go to step 3b instead of step 4").
Task to decompose: [describe it in full]
Tools available: [list them]
Acceptable latency per run: [seconds or minutes]
Is this user-facing or background: [specify]
Prompt 8: The Human-in-the-Loop Design
Full autonomy is not the goal. The right level of human oversight is. This prompt helps you design checkpoints that don't kill the value of automation.
View Prompt 8
I'm designing an agent that runs [describe the task]. I need to figure out where to put human-in-the-loop checkpoints without making the agent so interrupt-heavy that it's worse than just doing the task manually.
Help me design the oversight model by:
1. Mapping every decision the agent makes during the task
2. Classifying each decision as: reversible/irreversible, high-stakes/low-stakes, and certain/uncertain
3. Recommending a checkpoint policy for each class of decision:
- Auto-proceed (no human needed)
- Notify but proceed (log it, human reviews asynchronously)
- Pause and confirm (agent waits for explicit human approval)
- Escalate and stop (agent halts and flags for human takeover)
4. Estimating what percentage of runs would require synchronous human input under this policy
Optimize for: [choose one: maximum autonomy / maximum safety / fastest time-to-completion]
Acceptable interruption rate: [e.g., "no more than 1 in 10 runs should require synchronous input"]
Agent task: [describe it]
Prompt 9: The Agent Persona Definition
Agents that interact with users need a coherent persona. Without one, they feel inconsistent and erode trust. This prompt writes one.
View Prompt 9
Write a persona definition for an AI agent that will [describe what it does and who it serves].
The persona definition should include:
1. Name (or role label if no custom name)
2. One-paragraph description of how it talks and what it prioritizes in interactions
3. Five example phrases it would use (and five it would never use)
4. How it handles uncertainty (does it say "I don't know," ask a clarifying question, or offer a best-effort answer with a caveat?)
5. How it handles a user who is frustrated or confused
6. What it does when it cannot complete the task (how does it hand off or explain the failure?)
7. What it explicitly will not do, stated in first person as the agent
Make the persona specific enough that two different engineers building different parts of this agent would produce consistent behavior. Generic descriptions like "helpful and friendly" are not acceptable. Every trait should be concrete and testable.
Product context: [describe your product]
User: [describe who interacts with this agent]
Tone goal: [e.g., "expert but approachable," "direct and efficient," "warm and reassuring"]
Section 3: Evaluation Prompts (Is It Actually Working?)
Agents that pass basic demos fail in production for reasons that are entirely predictable if you know where to look.
Prompt 10: The Evaluation Rubric Generator
Before you can know if your agent is good, you need a definition of good. Most teams skip this step.
View Prompt 10
I need a concrete evaluation rubric for my AI agent so I can measure whether it's working in production, not just in demos.
The agent does: [describe the task]
It succeeds when: [describe the ideal output or outcome]
It fails when: [describe failure states you've seen or anticipate]
Create an evaluation rubric with:
1. A set of test case categories that covers normal inputs, edge cases, and adversarial inputs (give 3 examples per category)
2. For each test category, a scoring rubric (1-5 or pass/fail, your choice, but explain the criteria)
3. Three metrics I should track in production (not just accuracy, think about task completion rate, fallback rate, latency, etc.)
4. A minimum bar for each metric below which I should stop and fix before continuing rollout
5. A log format I should use to capture agent behavior so I can debug failures after the fact
Make the rubric specific to my use case, not a generic "AI evaluation" template.
Prompt 11: The Red Team Prompt
Send this to someone who wants your agent to fail. Or run it yourself before they get the chance.
View Prompt 11
Act as a red-teamer trying to make the following AI agent fail, misbehave, or produce harmful outputs.
Your job is to generate 15 test inputs specifically designed to break this agent. Organize them into:
1. Boundary violations (inputs that push the agent to act outside its defined scope)
2. Prompt injection attempts (inputs that try to override the agent's instructions)
3. Ambiguous inputs (inputs with multiple valid interpretations that could lead to wrong actions)
4. Adversarial edge cases (rare but valid inputs the agent was probably not designed for)
5. Compounding failures (multi-turn sequences where each step seems fine but the combination causes a problem)
For each test input, describe:
- The input itself
- What a broken agent would do
- What a well-designed agent should do instead
- How severe the failure is (low / medium / high)
Agent description: [describe your agent]
System prompt summary: [paste or summarize it]
Tools available: [list them]
Prompt 12: The Production Readiness Check
One structured review before you ship is worth three post-mortems after.
View Prompt 12
I'm about to ship an AI agent to production. Review the following agent design and give me a go / no-go recommendation with specific blockers.
Evaluate across these dimensions:
1. Safety: Can the agent take actions that are irreversible or destructive? Are those actions gated behind confirmation?
2. Scope: Can an unusual input push the agent outside the job it was designed for?
3. Observability: If this fails at 2am, can I reconstruct what the agent did and why from logs alone?
4. Failure handling: What happens when a tool errors, times out, or returns a shape the agent didn't expect mid-task?
5. Cost and loops: What's the worst-case token spend for a single run, and what stops a retry storm?
6. Human handoff: When the agent gets stuck, does a human find out, and do they have enough context to take over?
7. Rollback: If this goes badly on day one, how do I turn it off, and what half-finished state does that leave behind?
For each dimension, give me a rating (blocker / concern / acceptable) and point to the specific thing in my design that led to that rating. Then give one verdict: go or no-go. If no-go, list only the blockers, ordered by what to fix first. Don't soften it.
Agent design: [paste your spec, system prompt, and tool definitions]
Deployment context: [user-facing or background, expected volume, what systems it touches]
Section 4: Communication Prompts (Getting Everyone Else Comfortable)
An agent that nobody trusts gets turned off, no matter how well it works. These are for the conversations around the build.
Prompt 13: The Skeptical Stakeholder Brief
Someone with veto power is nervous about this agent. Vague reassurance makes it worse. This prompt gives them something concrete to push against.
View Prompt 13
I need to explain an AI agent to a stakeholder who is skeptical of it. Write a one-page brief they can actually interrogate.
The agent: [describe what it does]
The stakeholder: [describe their role and what they're accountable for]
Their specific concern, if I know it: [describe, or say "general discomfort with autonomy"]
The brief should cover:
1. What the agent does, in one sentence, with no AI vocabulary
2. What it is explicitly not allowed to do
3. What happens when it's wrong: who finds out, how fast, and what it costs
4. What a human still controls, and at which points
5. How we'd know it's failing before a customer tells us
6. What we'd do to turn it off, and how long that takes
Rules: no hedging, no "the AI decides" hand-waving, no claims we can't back with a specific mechanism in the design. If a concern is legitimate and unresolved, say so and name it. A brief that admits one real risk earns more trust than one that admits none.
Prompt 14: The User-Facing Boundary Explainer
Users don't read your architecture. They form a mental model in the first ten seconds and then act on it. This prompt writes the copy that shapes it.
View Prompt 14
Write the user-facing copy that sets correct expectations for an AI agent in our product.
The agent: [describe what it does]
Where the user encounters it: [describe the surface: chat, background automation, inline suggestion, etc.]
What it does well: [describe]
What it does badly or refuses to do: [be specific and honest]
Produce:
1. One sentence the user reads before they first use it, framing what it's for
2. A short "what this can and can't do" list in plain language, no marketing tone
3. The message the agent shows when it's uncertain
4. The message it shows when it can't complete the task, including what the user should do next
5. The message it shows when it did something the user may want to undo
Constraints: write for someone who has never thought about how agents work and never will. No jargon. No apologizing. Never imply more capability than the agent has, because every overpromise here becomes a support ticket later.
Prompt 15: The Agent Incident Explainer
Your agent will get something wrong in front of a customer. How you explain it determines whether they lose trust in the agent or in you.
View Prompt 15
Our AI agent made a mistake that affected users. Help me communicate it.
What happened: [describe what the agent did]
Who was affected and how: [describe scope and impact]
Why it happened: [describe the root cause, in technical terms]
What we've changed: [describe the fix and any new guardrail]
What we haven't solved yet: [be honest]
Write three versions:
1. For affected users: what happened in their terms, what it means for them, what they should do, and what we've done about it. No jargon, no blaming the model.
2. For internal stakeholders: the same facts with the mechanism explained, plus what class of failure this belongs to and whether it can recur.
3. For the team: the one design assumption this proved wrong.
Rules: never describe the agent as if it acted on its own and surprised us. We designed it, we shipped it, we own the output. Don't promise it will never happen again unless the fix genuinely makes that class of failure impossible. Say what's true.
Why We Built This
At ProductOS, we think most agent projects fail before any code is written. They fail at the moment someone decides to build an agent because agents are what you build right now, rather than because the task actually had the shape an agent handles well.
The prompts here are ordered the way the decision should be: diagnose, then design, then evaluate, then explain. Skipping to the middle is how you end up with brittle automation that gets quietly switched off six weeks after launch.
If any of this lands and you want to see it in action, we're at productos.dev. No pressure. The pack stands on its own.
If you'd rather have humans plus AI run this for you on a real product today, that's what 1Labs AI does.
Built by Heemang Parmar, Founder & CEO of ProductOS. 10+ years in product, 150+ builds. Also runs 1Labs AI, an AI product development agency.