Solopreneur PlaybookguideBeginner8 min read

How to Write Agent Instructions That Actually Work

Your agents are only as good as the instructions you write for them. Most people dump a paragraph of vibes and hope for the best. Here is how to write instructions that make agents actually do their job.

Updated 2026-03-19

Key Takeaways

  • Agent instructions need five components: output definition, relevant context, quality standards, explicit constraints, and escalation triggers
  • Structure instructions in three reusable layers: role definition, standards and voice, task specifics
  • Show examples of good output instead of describing what you want in abstract terms
  • Common mistakes: kitchen sink context, one-liner prompts, contradictory requirements, static prompts, missing constraints
  • Better instructions cut revision time by 40-60% and reduce token spend for solo operators

How to Write Agent Instructions That Actually Work

Every solo operator writes agent instructions. Most of those instructions are bad. Not because the person is bad at writing. Because nobody taught them what agents actually need to hear.

You open Claude, paste in "write me a blog post about AI," and get back something that sounds like a corporate press release. You add "make it casual" and get a blog post that starts with "Hey there!" and sounds like a wellness influencer.

The problem is not the model. The problem is the instructions.

This guide is for people who write agent prompts every day. Founders running AI businesses. Solo operators delegating real work to agents. If you want your agents to stop guessing and start performing, the fix is almost always in the instructions.

The Core Principle: Tell Agents What They Need to Know, Not What You Know

Most people write instructions the way they think. Stream of consciousness. Background context that is interesting but irrelevant. A paragraph of motivation before the actual ask.

Agents do not need motivation. They need information.

The question is not "what do I know about this task?" It is "what does the agent need to know to complete this task without coming back to me?"

That shift changes everything.

The Five Things Every Agent Instruction Needs

1. What Done Looks Like

Before you write anything else, describe the output. Not the process. The output.

Bad: "Research our competitors and help me understand the landscape."

Good: "Produce a table with five columns: competitor name, pricing tier, primary feature, weakness, and one sentence on how we differ. Include the top eight competitors by market share."

When the agent knows what done looks like, it works backward from there. When it does not, it guesses. And guessing is where you lose hours to revision.

2. The Context That Matters (Nothing Else)

Give the agent the information it needs to do the job. Skip everything else.

If you are asking an agent to write a guide, it needs:

  • Who the audience is
  • What voice to use
  • What the guide should cover
  • What it should not cover
  • Examples of guides that hit the mark

It does not need your company history, your personal journey, or the philosophical reason you started a business. That is noise. Noise makes agents worse, not better.

A useful rule: if removing a sentence from your instructions would not change the output, remove it.

3. The Standards It Must Meet

Every function in your business has quality standards. Your agent does not know them unless you write them down.

For a content agent: word count range, formatting rules, linking requirements, voice document.

For a support agent: response time target, escalation triggers, tone guidelines, things it must never say.

For an outreach agent: personalization depth, message length, what counts as a valid lead.

Think of standards as the acceptance criteria for the agent's work. If you would reject output that violates a standard, the standard belongs in the instructions.

4. What It Should Not Do

This is the one most people skip. And it is the one that saves the most revision time.

Agents are eager. They will add things you did not ask for. They will make assumptions. They will expand scope.

Tell them not to.

"Do not include an introduction paragraph. Start with the first section heading." "Do not add features beyond the three listed. If you think a fourth is needed, flag it. Do not build it." "Do not use exclamation points, emojis, or phrases like 'dive into' or 'let us explore.'"

Constraints are instructions. They are often more valuable than the positive instructions.

5. When to Escalate

Every agent should know when to stop and ask for help. If you do not define this, the agent will either stop too early (wasting your time) or push through something it should not (wasting your trust).

Escalation triggers look like:

  • "If the customer mentions legal action, stop responding and flag the ticket for me."
  • "If you are unsure which pricing tier applies, ask before generating the quote."
  • "If the API returns an error you have not seen before, log it and move to the next task."

The goal is not to make agents afraid to act. It is to make them confident about what is inside their lane and clear about what is outside it.

Structuring Instructions for Reuse

If your agent does the same function repeatedly (content, outreach, support), structure your instructions in layers.

Layer 1: Role definition. Who this agent is, what function it serves, what its responsibilities are. This rarely changes.

Layer 2: Standards and voice. Quality bar, formatting rules, voice document. This changes occasionally.

Layer 3: Task specifics. What to do right now. This changes every time.

Separating these layers means you do not rewrite your entire prompt every time you assign a new task. You update Layer 3 and the rest carries forward.

This is how professional agent operators work. One set of durable instructions. One set of per-task specifics. The agent reads both.

Show, Do Not Explain

The single highest-leverage thing you can do in agent instructions: include an example of good output.

If you want a guide written in a specific voice, include a paragraph from a guide that nails it. If you want a support reply in a certain tone, show one. If you want a data table formatted a certain way, paste one in.

Agents learn from examples faster than from descriptions. "Write in a casual, direct tone" is vague. Showing them a paragraph that is casual and direct is concrete.

When you have examples, you need fewer rules. The example carries the rules implicitly.

Common Instruction Mistakes

The kitchen sink. Pasting your entire knowledge base into the instructions. More context is not always better. Relevant context is better.

The one-liner. "Write a blog post about AI agents." This is not an instruction. This is a wish. Agents need specifics to produce specific output.

The contradictory set. "Be concise but thorough. Be casual but professional. Be creative but stick to the format." Pick a side. Contradictions produce mediocre compromise.

The static prompt. Using the same instructions for every task, even when the task changes. Good instructions are task-aware. They change when the work changes.

The missing negative. Not telling the agent what to avoid. You get scope creep, unwanted features, and off-brand copy. Every time.

How This Saves You Money and Time

Better instructions mean fewer revision cycles. Fewer revision cycles mean less token spend and less of your time fixing agent output.

For a solo operator running agents across content, outreach, and support, tightening instructions typically cuts revision time by forty to sixty percent. That is real hours back in your week.

It also means your agents scale. Instructions that work for one task can template across dozens. You stop writing prompts from scratch and start deploying tested instructions.

Where to Start

Pick the agent that gives you the most trouble. The one whose output you always have to fix.

Open its instructions. Check for:

  • Is the output clearly defined?
  • Is the context relevant and lean?
  • Are the standards written down?
  • Are there constraints on what not to do?
  • Is there an escalation path?

Fix whatever is missing. Run the agent again. Compare.

You will see the difference in one cycle.

For the full list of tools that power a solo AI business, see the Solopreneur AI Stack for 2026. For a practical guide on delegating business functions to agents, read How to Delegate Tasks to AI Agents. And if you want to see how agents fit into a real org chart, check out How to Build an AI Team.

Related Guides

Do-Nothing Score

Find out how close you are to Ghost CEO.

Take the quiz