Skip to content
Agent Builder
Module 0Free lesson8 min read

The Agent Builder Mindset

The mental shifts that separate people who get great results from agents from those who get frustrated: delegation, verification, and iteration.

Two people install the same agent on the same day. A month later, one of them runs half their week through it and the other has written it off as "impressive, but not reliable". They have the same tools and the same model. The difference is almost entirely in how they think about the work.

The people who get great results treat an agent like a capable new colleague rather than a magic box or a search engine. They delegate outcomes instead of keystrokes, they verify before they trust, and when something goes wrong they fix the instructions instead of just the output. This lesson breaks down those three shifts, shows what each looks like in practice, and gives you a diagnostic table for the frustrations every beginner hits, so you can turn them into fixes instead of reasons to quit.

From operator to manager

When you use ordinary software, you're an operator: you click every button and the software does exactly what you clicked. Chat assistants nudge you a little further, but you're still doing the fetching and carrying.

Agents ask you to become a manager. You define the goal, supply the context, set the boundaries, and review the result. The agent decides the individual steps. That's uncomfortable at first, for the same reason managing people is uncomfortable at first: you have to let go of the keyboard and get good at describing what you want and checking what you got.

The good news is that management is a learnable skill, and with agents the feedback loop is minutes instead of months. You can try a delegation, see what happened, and adjust before lunch.

Shift 1: Delegate outcomes, with context

Beginners tend to under-specify. They type a request the way they'd type a search query and expect the agent to fill in the gaps. But the agent wasn't in your meetings, doesn't know your preferences, and can't see what's in your head. Everything it knows about your task is what you wrote and what it can find with its tools.

A useful test: would a smart new hire, on their first day, be able to do this from your message alone? If they'd need to ask five questions first, put the answers in the message.

✕ Before
Prompt
Write a summary of the customer feedback.

The agent has to guess which feedback, how long, for whom, and what to focus on. It will produce something generic and confident.

✓ After
Prompt
Read the 120 survey responses in feedback/october.csv. Write a one-page
summary for our product team meeting on Thursday. They care most about
reasons people cancel, so lead with that. Group complaints into themes,
give a rough count for each, and include two or three direct quotes per
theme. Flag anything that sounds like a bug rather than a feature
request. Save it as feedback/october-summary.md.

Clear source, audience, priority, structure, and output location. Nothing important is left to guesswork.

The good version took about a minute longer to write. It will likely save you three rounds of corrections.

Delegate the whole outcome, not the steps

There's an opposite trap: micromanaging. If you write "open the file, then read line 1, then...", you're back to being the loop. Describe what you want and why, plus any constraints that matter, and let the agent figure out how. It's often better at the how than you'd expect, and when it isn't, a plan review (which you practiced in Your First Agent Task) catches it early.

Shift 2: Verify in proportion to the stakes

Agents make mistakes, and they report their mistakes in the same confident tone as their successes. That's not a reason to avoid them. It's a reason to make verification a standard part of every task, the way a good editor reads every draft.

The trick is to match the depth of your checking to the cost of being wrong:

StakesExampleHow much to verify
LowBrainstorming names, a throwaway scriptSkim it; use it if it looks right
MediumA report for your team, a code change in a side projectSpot-check key facts and numbers, run the tests, read the diff
HighAnything sent to customers, money, production systems, legal textReview every line, check every source, have a second person or process look

Build verification into the task

Better still, make the agent verify its own work before you ever see it. You saw this in your first task, where a test caught a bug the agent then fixed. You can ask for verification in almost any kind of work:

  • Code: "Run the tests after each change. Don't report success until they pass."
  • Research: "For every claim, include the source URL. Mark anything you couldn't confirm."
  • Data: "After computing the totals, recompute them a second way and confirm they match."
  • Writing: "When you're done, re-read the draft against my original requirements and list any you didn't meet."

Then do your own check on top. The agent's self-check catches many errors; yours catches what it can't, especially the cases where the agent misunderstood the goal entirely.

Shift 3: Iterate on the instructions, not just the output

When an agent gets something wrong, the instinct is to fix the output: edit the paragraph yourself, or say "no, change that bit". That works once. The agent-builder move is to ask why it went wrong and fix the cause, so it doesn't happen again.

Most bad results trace back to one of a few causes:

  1. Missing context. It didn't know something you know. Add it to the task.
  2. Ambiguous goal. Your words had two reasonable readings, and it picked the other one. Be more specific.
  3. No way to check. It couldn't tell whether it had succeeded. Add a test, an example, or a checklist.
  4. Too big a task. It lost track over many steps. Break the work into smaller pieces.
  5. The wrong tool for the job. Sometimes the agent simply lacks the ability, such as access to a system or the right model. Change the setup.

Keep what works

When a prompt produces great results, save it. Keep a simple file of your best task descriptions and reuse them. Over time, you'll turn these into project instruction files, reusable skills, and eventually your own agents. That progression, from a one-off prompt to a reusable asset, is the arc of this entire course.

Here's a prompt you can use after any disappointing result to turn it into a lesson:

Post-mortem a bad result
That result wasn't what I wanted. Before you try again:
1. Restate in one sentence what you understood my goal to be.
2. List any assumptions you made that I didn't state.
3. Tell me what information or check would have helped you get it right
   the first time.
Then suggest a revised version of my original request.

The agent's answer often reveals the missing context in seconds, and the revised request goes straight into your saved prompts.

Know when to take the wheel back

Part of the mindset is knowing when not to delegate. Agents aren't the right tool when:

  • The task takes you thirty seconds and explaining it would take three minutes.
  • Success depends on taste or relationships the agent can't see, like the exact tone of a sensitive email to your manager. Let the agent draft; you decide.
  • You'd be unable to tell whether the result is right. If you can't verify it, you can't safely delegate it. Learn enough to check, or get someone who can.
  • A mistake would be serious and irreversible, and you haven't set up safeguards.

None of these are permanent. As you get better at writing context and building checks, the set of things you can delegate grows steadily.

Turning frustrations into fixes

Every beginner hits the same walls. Here's what each one usually means.

FrustrationWhat it usually meansTry this
"It did something different from what I asked."The goal was ambiguous, or key context was missingState the goal, audience, and definition of done explicitly
"It said it was done, but it wasn't."No verification stepAsk it to run a check before reporting, and check yourself
"It went in circles."Task too big, or a confusing error it can't interpretInterrupt, ask it to explain what's failing, break the task down
"It changed things I didn't want changed."Scope wasn't boundedSay what's off-limits; review changes with git before keeping them
"It made up a fact."It had no source and filled the gapRequire sources, give it a search tool, or provide the documents
"It's great one day and bad the next."Results vary run to run, and your prompt leaves room for thatTighten the instructions, save prompts that work, add checks

Notice the pattern: almost every fix is about context, scope, or verification, which are all things you control.

ExerciseDelegate your weekly task

Go back to the note you made in the welcome lesson: the task you do every week that you'd love to hand off. If you didn't make one, pick any recurring task now.

  1. Write a delegation brief for it using the new-hire test. Include the goal, where the inputs are, who the output is for, any constraints, and what "done" looks like.
  2. Add one sentence asking the agent to verify its own work before reporting.
  3. Run it in your chat assistant or coding agent. If it needs files, give it sample or anonymized ones.
  4. Grade the result honestly as low, medium, or high stakes, and verify it to that level.
  5. If it fell short, run the post-mortem prompt and save the revised brief.

Success looks like: a saved, reusable brief that produces a result you'd actually use, plus one note about what you had to add after the first try.

Key takeaways
  • Working with agents means shifting from operator to manager: define goals, supply context, review results.
  • Delegate outcomes with enough context that a smart new hire could succeed from your message alone.
  • Verify in proportion to the stakes, and build self-checks into the task itself.
  • When results disappoint, fix the instructions, not just the output, and save the prompts that work.
  • Most frustrations trace back to context, scope, or verification. Next, Module 1 opens the hood, starting with LLMs in plain English.