Agents Aren't Human — Stop Managing Them Like They Are
There's a pattern I keep seeing with teams adopting AI agents: they anthropomorphize them into oblivion.
They give the agent a name. They write prompts like they're writing Slack messages to a new hire. They get frustrated when the agent "doesn't understand" — as if understanding were the bottleneck.
The bottleneck is almost always the specification, not the intelligence.
The junior developer fallacy
When you onboard a junior developer, you can be vague. You can say "make the button look better" and a human will infer context from the codebase, the design system, past conversations, and their own taste.
An agent won't do that. An agent will make the button look better according to its training distribution, which may or may not match your design system, your brand, or your users' expectations.
This isn't a limitation to work around. It's a feature to build on.
What actually works
After deploying agents across a dozen projects, here's what I've found works:
-
Constrain the scope ruthlessly. An agent that does one thing well is worth ten that do everything poorly. Don't build a "general purpose coding agent." Build an agent that writes migration scripts for your specific ORM.
-
Make the output format non-negotiable. Don't let the agent decide how to structure its response. Give it a schema. Validate against it. Reject anything that doesn't conform.
-
Build feedback loops, not guardrails. Instead of trying to prevent every possible failure, build systems that detect failures quickly and route them for correction. This is cheaper and more robust than elaborate prompt engineering.
-
Measure what matters. Track task completion rate, not "accuracy." Track time-to-resolution, not token count. The metrics you optimize for will shape how useful the agent actually becomes.
The pragmatic takeaway
Agents are tools with a novel interface — natural language. But natural language is imprecise by nature. The teams that succeed with agents are the ones that impose structure around the natural language interface, not the ones that try to make the natural language more precise.
Stop writing longer prompts. Start building better systems around shorter ones.
The Pragmatic Builder
Weekly frameworks and lessons from building with AI agents. No hype, just what works.
No spam. Unsubscribe anytime.