All writing

Design Before Delegation: Where Humans Matter With AI Agents

Ugur Kellecioglu3 min read
  • AI Coding Agents
  • Technical Design
  • Software Planning
  • Web Development

Give a coding agent a well-defined task and it can return a pull request that is close to ready. That changes where a product team's effort pays off. Typing code is no longer the scarce resource. The decisions made before the agent starts, and the instructions it follows while it works, now decide whether the result is something you can ship.

Spend your best thinking on technical design

Building, testing and deployment are increasingly mechanical. What remains with people is deciding what to build, for whom and why, then how: the stack, the database, the architecture, the edge cases, security, monitoring and how the feature will be supported in production.

This is the cheapest place to use the strongest reasoning model available, and to argue with it. An agent will make design choices that look reasonable but add complexity you do not want, so challenge them. Mistakes found late cost more in tokens, development time and customer impact than a few extra hours of design.

A good design document also surfaces the unglamorous details that demos hide:

  • Limits and rate limits, so one customer cannot generate thousands of resources at your expense.
  • Race conditions, such as two workers trying to claim the same job at once.
  • Scalability, because something that works for ten users can fall over in production.

Break the design into small, reviewable tasks

A thorough design is often too much for an agent to handle in a single pass. Splitting it into discrete tasks gives better results, and agents are good at the mechanical part of this work, keeping every constraint attached to the right task. Humans then review the breakdown and correct what is missing.

Each task should state the outcome, the constraints, and what is in and out of scope. Link them to one parent ticket so the unit of work stays visible. How much human verification follows depends on the stakes: a mission-critical system deserves far more human review than an internal side project, and judging a visual design is still a human job.

Write agent instructions that carry real expertise

Reusable instructions for agents, often called skills, are the simplest way to make an agent better at a specific job. They are also easy to get wrong. Five practices help:

  1. Write descriptions that trigger. Agents load only a short name and description up front, so the description must say what the skill does and when to use it. Models tend to under-trigger, so lean slightly assertive.
  2. Build from real expertise. Instructions generated by a model tend to be generic. Walk through the task by hand, or mine old runbooks and review comments, and record every correction as a gotcha.
  3. Keep them lean. Instructions compete for context with everything else, so write only what the model would not already know, and move detail into reference files that load on demand.
  4. Use deterministic scripts for fragile steps. If totals must reconcile, have a script do the arithmetic instead of letting the model improvise. Testing only catches what you thought to check.
  5. Vet third-party skills. They can run code with access to local files and API keys, so treat them like any other dependency and read them first.

What this means for web projects

The pattern is consistent: put human judgement where decisions are expensive to reverse, and put automation where steps are repeatable. For founders and product teams, that means asking any build partner how they design, split and constrain work before an agent writes a line. Fast code is easy to get. A design that holds up under real users is the part worth paying senior engineers for.

Frequently asked questions

Where should humans focus when AI agents write the code?

Humans should focus on technical design, task breakdown and verification. Building and deployment are increasingly mechanical, while decisions about what to build, the architecture and the edge cases are expensive to reverse.

Why break an AI coding task into smaller tasks?

Smaller tasks give better results because a thorough design is often too much for an agent to handle in one pass. Each task should state its outcome, constraints and scope so the agent keeps every detail.

How do you write a good AI agent skill?

A good skill has a description that says what it does and when to use it, content drawn from real expertise, and a lean body. Fragile steps should be handled by deterministic scripts rather than model improvisation.

Are third-party AI agent skills safe to install?

Not automatically, because skills can run code with access to local files and API keys. Treat them like any other dependency and read what they do before running them.

A short note about the product, the timeline and who it is for is enough to start. You will hear back from the engineer who would do the work, not a sales team.

Start a partnership